🤖HermesBlog
Guias Práticos do Hermes · Parte 188/9/2026

Enviar Saída de Script para o Chat

Enviar Saída de Script para o Chat — guia fácil de entender baseado na documentação oficial

Você conhece aquela sensação de iniciar um build longo ou um upload grande e ficar encarando o terminal como se fosse uma panela de água que nunca ferve? O hermes send é como colocar uma sinetinha nessa panela — ele te avisa na hora que terminar, não importa onde você esteja.

guide-pipe-script-output

O Que É Exatamente o hermes send?

É uma ferramenta de linha de comando minúscula que envia uma mensagem para qualquer app de chat que você já usa — Telegram, Slack, Discord, Signal, você escolhe. Pense nele como um botão universal de “ping” para seus scripts. A melhor parte? Você não precisa configurar bots ou tokens separados para cada app. Se o Hermes já sabe como falar com a sua plataforma de chat, o hermes send usa essa mesma conexão automaticamente.

A Maneira Mais Simples de Usar

Abra seu terminal e digite:

hermes send --to telegram "deploy finished"

Pronto. Seu Telegram recebe uma mensagem dizendo “deploy finished”. Sem configuração extra, sem novas contas.

Piping: O Superpoder de Verdade

É aqui que a coisa fica divertida. Você pode pegar a saída de qualquer comando e enviá-la direto para o chat. É como conectar uma mangueira do seu terminal ao seu celular.

echo "RAM 92%" | hermes send --to telegram

Ou verifique o espaço em disco e envie o resultado:

df -h | hermes send --to slack:#sysadmin

Esse símbolo | é chamado de “pipe”. Ele pega tudo o que o primeiro comando imprime e alimenta o hermes send. A saída do seu script vira a mensagem.

Enviando Arquivos e Adicionando Assuntos

Precisa compartilhar um relatório completo ou um arquivo de log? Sem problema:

hermes send --to discord:#ops --file /tmp/report.md

Quer adicionar uma linha de assunto rápida para as pessoas saberem o que estão vendo?

hermes send --to slack:#eng --subject "[CI] build.log" --file build.log

Para Onde Você Pode Enviar? (Formatos de Destino)

Você tem opções. Aqui estão os padrões comuns:

  • --to telegram → envia para o seu chat padrão
  • --to telegram:-1001234567890 → envia para um grupo ou canal específico
  • --to discord:#ops → usa um nome de canal amigável
  • --to signal:+15551234567 → envia para um número de telefone

As plataformas suportadas incluem Telegram, Discord, Slack, Signal, SMS, WhatsApp, Matrix e muitas outras.

Códigos de Saída: O Boletim do Seu Script

Quando o hermes send termina, ele te dá um número:

  • 0 → Sucesso! Mensagem enviada.
  • 1 → A plataforma rejeitou (permissões ruins, problema de rede).
  • 2 → Você digitou algo errado (argumentos inválidos).

Você pode usá-los nos seus scripts, assim como faria com curl ou grep:

hermes send --to telegram "backup done" || echo "Notification failed!"

E Se Você Esquecer a Mensagem?

Não se preocupe — ele não vai travar para sempre. Se você rodar hermes send --to telegram sem nenhuma mensagem, arquivo ou pipe, ele te dá um erro claro e sai. Sem terminais congelados.

Sua Conclusão Prática

Comece pequeno. Escolha um script que você roda regularmente — talvez um backup semanal ou um cron job — e adicione uma única linha no final:

hermes send --to telegram "Backup completed at $(date)"

Então, da próxima vez que você estiver longe da sua mesa, receberá um pequeno ping no seu celular. É uma adição minúscula com um grande retorno: você para de ficar de babá do seu terminal e começa a confiar que ele vai te avisar quando precisar de você. Esse é o ponto principal — deixe seus scripts fazerem a conversa, e deixe seu app de chat fazer a escuta.


📖 Documentação oficial

この記事は Hermes Agent のDocumentação oficialに基づいています:Documentação oficial › guides/pipe-script-output