Como o agente de IA pode reagir e saber das reações do cliente
Para o agente de IA adicionar ou remover uma reação, envie uma solicitação para /api/connect/react com o ID da mensagem e o emoji. Para que o fluxo do n8n receba as reações do cliente, ative Avisar a IA sobre reações do cliente nas configurações do Gateway de IA.
Como adicionar ou remover uma reação
Envie POST /api/connect/react com o cabeçalho Authorization: Bearer <token>. O token é o valor do campo Token de callback na página Conecte sua IA. É o mesmo token usado para responder ao cliente.
No corpo, envie message_id e emoji. Você pode reagir tanto a uma mensagem do cliente quanto a uma mensagem enviada pelo próprio agente.
Para remover a reação, envie uma string vazia: "emoji": "".
POST https://app.anylinga.com/api/connect/react
Authorization: Bearer <Token de callback>
Content-Type: application/json
{
"message_id": "6a1f3c2e-9b7d-4e5a-8c21-0d4b7e9f2a13",
"emoji": "👍"
}
Onde obter o message_id
message_id é o ID da mensagem na AnyLinga. Para reagir a uma mensagem do cliente, use o campo message_id da mensagem recebida pelo fluxo.
Para reagir ao texto do agente, use o campo message_id da resposta da AnyLinga ao callback ou a /api/connect/send. Se apenas modelos forem enviados, sem texto, a resposta não terá o campo message_id.
Em quais canais as reações funcionam
O agente de IA pode adicionar reações no WhatsApp conectado por QR code, na WhatsApp Business API e em bots do Telegram.
Nos demais canais — Telegram pessoal, Instagram, Facebook, TikTok, MAX, LinkedIn e chat na web — a AnyLinga retornará 422 reactions_not_supported. No Telegram pessoal, os bots do Telegram Business não têm permissão para adicionar reações.
O atendente vê a reação do agente no chat do Kommo, na mesma mensagem, como uma reação de um membro da equipe. Quando a reação é espelhada com sucesso, a resposta é {"ok": true, "crm_mirrored": true}.
Se não for possível espelhar a reação no Kommo, a resposta terá "crm_mirrored": false. Mesmo assim, a reação foi enviada ao cliente.
O que significam as respostas da API
Verifique o código de resposta e o valor de crm_mirrored para distinguir o envio da reação ao cliente da sua exibição no Kommo.
| Resposta | Significado |
|---|---|
200 | A reação foi enviada ao cliente; crm_mirrored indica se ela apareceu no Kommo. |
400 | message_id não parece ser um ID de mensagem ou emoji contém mais de um emoji. |
401 | Token de callback inválido. |
404 message_not_found | A mensagem não existe ou pertence a outra conta. |
422 reactions_not_supported | A AnyLinga não adiciona reações neste canal. |
422 no_messenger_id | A mensagem não tem ID no aplicativo de mensagens, então não é possível adicionar uma reação. |
502 send_failed | O aplicativo de mensagens não aceitou a reação, por exemplo, se o valor de emoji não for um emoji. |
Como ativar as notificações de reações do cliente
Antes de ativar, confirme que o fluxo verifica o campo event: esse campo não existe em uma mensagem comum do cliente.
1. Abra as configurações do Gateway de IA
- Acesse Ferramentas e configurações → Gateway de IA, na página Conecte sua IA.
2. Ative as notificações de reações
- Abaixo de Ativar gateway, encontre Avisar a IA sobre reações do cliente e ative a opção.
- A configuração é salva assim que você clica. Não é preciso clicar em Salvar.
Como processar o evento client_reaction
Quando o cliente adiciona ou remove uma reação, o evento client_reaction chega à mesma URL do webhook do n8n, com a mesma assinatura X-AnyLinga-Signature. Não é preciso responder via callback; o webhook deve responder com 2xx. Os filtros de negócios não se aplicam ao evento.
Use o campo event para distinguir o evento de uma mensagem do cliente. Use message_id para identificar a mensagem à qual o cliente reagiu.
| Campo | Conteúdo |
|---|---|
event | client_reaction. |
conversation_id | Conversa. |
channel | Canal. |
contact_id | Contato no Kommo ou null. |
message_id | Mensagem à qual o cliente reagiu: o mesmo ID da mensagem recebida ou da resposta do callback. |
message_direction | inbound se a reação for a uma mensagem do cliente; outbound se for a uma mensagem da empresa. |
emoji | Emoji da reação. |
action | react se o cliente adicionou uma reação; unreact se a removeu. |
ts | Horário. |
unreact com o emoji que o cliente removeu. Uma reação a uma mensagem antiga que não existe na AnyLinga não gera evento.Perguntas relacionadas
Quais campos o fluxo recebe, como o agente de IA e o atendente trabalham no mesmo chat, como conectar um agente de IA pelo n8n.
Ficou com dúvidas?
Respondemos em horário comercial.