Como o agente de IA pode iniciar uma conversa com o cliente ou enviar um lembrete
Para escrever ao cliente sem receber uma nova mensagem, envie do seu fluxo uma solicitação POST /api/connect/send com o conversation_id salvo e o texto da mensagem. A AnyLinga enviará a mensagem da sua IA ao cliente.
Como funciona o envio sem uma mensagem recebida
O fluxo deve salvar previamente o conversation_id da solicitação recebida. Com esse identificador, você pode enviar um lembrete em uma conversa existente da sua conta.
A entrega funciona como em uma resposta comum: reply_text é traduzido para o idioma do cliente, e a mensagem aparece no chat do Kommo.
Como enviar uma mensagem pelo fluxo
1. Salve o identificador da conversa
- Obtenha o
conversation_idda solicitação recebida e salve-o no seu fluxo.
2. Configure a solicitação HTTP
- Use
POST /api/connect/sendno mesmo servidor indicado em URL de callback. Substitua o caminho/api/connect/callbackpor/api/connect/send. - Envie o mesmo cabeçalho
Authorization: Bearer <Token de callback>.
3. Informe o corpo da solicitação e envie
- Informe
conversation_idereply_texte/outemplate_ids. - Para um lembrete em texto, use o exemplo abaixo. Se enviar modelos, informe até 5 modelos em
template_ids.
{
"conversation_id": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7a9c4f12",
"reply_text": "Olá. Você perguntou sobre a entrega. Ainda tem interesse?"
}
Quando você pode enviar mensagens no WhatsApp
No WhatsApp e na API do WhatsApp Business, você só pode enviar uma mensagem até 24 horas após a última mensagem do cliente.
Depois desse prazo, a solicitação retorna 409 com o corpo {"error": "outside_window"}. A restrição também se aplica aos modelos. Os outros canais não têm essa verificação.
Códigos de resposta
| Código | Significado |
|---|---|
200 | Enviado. |
400 | Falta conversation_id ou não foi informado nem reply_text nem template_ids. |
401 | Token inválido. |
404 | Conversa não encontrada ou modelo não encontrado. |
409 outside_window | Passaram mais de 24 horas desde a última mensagem do cliente no WhatsApp. |
500 / 502 | Não foi possível entregar. |
Perguntas relacionadas
como enviar um modelo, uma foto ou um vídeo · quais campos o fluxo recebe · como conectar um agente de IA pelo n8n
Ficou com dúvidas?
Respondemos em horário comercial.