> ## Documentation Index
> Fetch the complete documentation index at: https://chatcli.edilsonfreitas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mensagens Proativas (@send)

> A IA inicia mensagens em Telegram, WhatsApp, Discord, Slack ou webhook reusando os adapters do gateway — o tool @send.

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](/pt/features/chat-gateway) (Telegram, WhatsApp, Discord, Slack e webhook genérico), então funciona com a credencial que você já configurou, sem integração nova.

<Info>
  É o equivalente nativo ao `send_message` do hermes-agent: notifica você ou entrega um resultado num chat de forma proativa.
</Info>

***

## 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

```text theme={"system"}
<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ável                        | Função                                        |
| ------------------------------- | --------------------------------------------- |
| `CHATCLI_TELEGRAM_HOME_CHANNEL` | Canal padrão do Telegram para `to:"telegram"` |
| `CHATCLI_WHATSAPP_HOME_CHANNEL` | Canal padrão do WhatsApp                      |
| `CHATCLI_DISCORD_HOME_CHANNEL`  | Canal padrão do Discord                       |
| `CHATCLI_SLACK_HOME_CHANNEL`    | Canal padrão do Slack                         |
| `CHATCLI_WEBHOOK_HOME_CHANNEL`  | Alvo 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](/pt/features/text-to-speech) e imagens geradas por [@image](/pt/features/image-generation).

<Tip>
  Para auto-ativação por linguagem natural ("me avisa no Telegram"), use a skill embutida `send-message` — ver [Skills Embutidas](/pt/features/builtin-skills).
</Tip>