Pular para o conteúdo principal
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

<tool_call name="@send" args='{"cmd":"send","args":{"to":"telegram","message":"Build verde ✅"}}' />
<tool_call name="@send" args='{"cmd":"list"}' />

​
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, então sufixos de thread (telegram:-100123:42) são preservados.
  • message é texto puro.

​
list

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

​
Configuração

VariávelFunção
CHATCLI_TELEGRAM_HOME_CHANNELCanal padrão do Telegram para to:"telegram"
CHATCLI_WHATSAPP_HOME_CHANNELCanal padrão do WhatsApp
CHATCLI_DISCORD_HOME_CHANNELCanal padrão do Discord
CHATCLI_SLACK_HOME_CHANNELCanal padrão do Slack
CHATCLI_WEBHOOK_HOME_CHANNELAlvo padrão do webhook
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.