Skip to main content
O tool @send deixa o agente iniciar uma mensagem num canal de mensageria — não apenas responder. Ele reusa os mesmos adapters do Chat Gateway (Telegram, WhatsApp, Discord, Slack e webhook genérico), então funciona com a credencial que você já configurou, sem integração nova.
É o equivalente nativo ao send_message do hermes-agent: notifica você ou entrega um resultado num chat de forma proativa.

​
Quando usar

  • Notificar o usuário quando uma tarefa longa termina (“build verde ✅”).
  • Entregar um resultado num grupo/canal específico.
  • Disparar um alerta a partir de um agente, scheduler ou gateway daemon.
Chat mode não roda tools; use @send em agent ou coder, ou via a skill send-message.

​
Subcomandos

​
send {to, message}

  • to é:
    • uma plataforma simples — telegram, whatsapp, discord, slack, webhook — que entrega no canal padrão da plataforma (CHATCLI_<PLATFORM>_HOME_CHANNEL); ou
    • um alvo plataforma:chat_id — ex. telegram:-1001234567890, whatsapp:+5511999999999, slack:C0123ABC. Tudo após o primeiro : é repassado literalmente como chat ID; os adaptadores postam no próprio chat, não numa thread ou tópico dentro dele.
  • message é texto puro.
  • O WhatsApp só aceita mensagens livres até 24 horas depois da última mensagem da pessoa, e o gateway não envia templates, então uma mensagem fora dessa janela falha. Mensagens para o Webhook precisam de CHATCLI_WEBHOOK_CALLBACK_URL: sem ele não há para onde entregá-las.

​
list

Mostra as plataformas configuradas e se cada uma tem canal padrão.

​
Configuração

As credenciais de cada plataforma são as mesmas do gateway (CHATCLI_TELEGRAM_BOT_TOKEN, etc.). O @send constrói os adapters configurados a cada chamada via gateway.BuildConfigured(), então funciona com ou sem o daemon rodando. Veja o estado em /config (seção Integrações · Gateway · Mensagens proativas).

​
Erros comuns

  • “plataforma não está configurada” → faltam credenciais; rode @send list ou configure o token.
  • “sem destino para X” → nenhum chat_id e nenhum canal padrão; passe plataforma:chat_id ou defina CHATCLI_<PLATFORM>_HOME_CHANNEL.

​
Escopo

@send envia texto. Mídia de saída (áudio/imagem) é entregue por outros caminhos: voz pelo TTS do gateway e imagens geradas por @image.
Para auto-ativação por linguagem natural (“me avisa no Telegram”), use a skill embutida send-message — ver Skills Embutidas.