AnyLinga
PT
Entrar Teste grátis

Central de ajuda/Agente de IA

Como o agente de IA pode reagir e saber das reações do cliente

Atualizado: 2026-11-13

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": "👍"
}
O limite é de 60 solicitações por minuto.

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.

RespostaSignificado
200A reação foi enviada ao cliente; crm_mirrored indica se ela apareceu no Kommo.
400message_id não parece ser um ID de mensagem ou emoji contém mais de um emoji.
401Token de callback inválido.
404 message_not_foundA mensagem não existe ou pertence a outra conta.
422 reactions_not_supportedA AnyLinga não adiciona reações neste canal.
422 no_messenger_idA mensagem não tem ID no aplicativo de mensagens, então não é possível adicionar uma reação.
502 send_failedO 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.
Por padrão, a opção fica desativada. Ela aparece com qualquer CRM.

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.

CampoConteúdo
eventclient_reaction.
conversation_idConversa.
channelCanal.
contact_idContato no Kommo ou null.
message_idMensagem à qual o cliente reagiu: o mesmo ID da mensagem recebida ou da resposta do callback.
message_directioninbound se a reação for a uma mensagem do cliente; outbound se for a uma mensagem da empresa.
emojiEmoji da reação.
actionreact se o cliente adicionou uma reação; unreact se a removeu.
tsHorário.
Uma alteração gera um evento: se o aplicativo de mensagens enviar a mesma reação novamente, o fluxo a receberá apenas uma vez. Ao remover uma reação, chega um evento 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.

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.

Este artigo foi útil?

Ficou com dúvidas?

Respondemos em horário comercial.

Já usa o AnyLinga?

Descreva sua dúvida e respondemos pelo WhatsApp ou por email.

Ainda não tem conta?

Teste você mesmo ou conectamos para você ao pagar o primeiro mês.

Conversar sobre a conexão

O que você precisa