Quais dados seu fluxo n8n recebe da AnyLinga
A AnyLinga envia ao seu fluxo n8n um JSON com a mensagem do cliente, a tradução, os dados de mídia, o idioma e os identificadores da conversa e do contato. A requisição também inclui correlation_id, que você deve retornar na resposta, e callback_url, o endereço para enviar a resposta.
Como a requisição chega e o que ela contém
A AnyLinga envia uma requisição POST para a URL do webhook n8n.
Cabeçalhos da requisição: Content-Type: application/json e X-AnyLinga-Signature.
Ao clicar em Testar conexão, você recebe uma mensagem de teste: texto AnyLinga Connect test, channel: test e um campo adicional test: true.
| Campo | Conteúdo |
|---|---|
message_text | Texto do cliente no idioma dele; para mídia, a legenda ou um marcador como [Image]; para mensagem de voz, a transcrição. |
translated_text | O mesmo texto no idioma dos atendentes da conta. |
message_type | text, image, audio, document, video ou sticker. |
media_url | Link para o arquivo ou null. No WhatsApp Business API, o link passa pela AnyLinga e abre sem autenticação. |
caption | Legenda que o cliente adicionou à mídia ou null. |
conversation_id | ID da conversa na AnyLinga; necessário para iniciar uma conversa com o cliente. |
message_id | ID desta mensagem do cliente na AnyLinga; o agente usa esse ID para adicionar uma reação. Na mensagem de teste, é null. |
channel | Canal de origem da mensagem. |
contact_id | ID do contato no Kommo ou null. |
ad | Anúncio da Meta a partir do qual o cliente enviou esta mensagem ou null. |
lang | Idioma do cliente. |
agent_lang | Idioma dos atendentes da conta. |
correlation_id | ID desta requisição; você deve retorná-lo na resposta. |
callback_url | Endereço para enviar a resposta. |
Exemplo de JSON
Esta é uma requisição com uma mensagem de texto do cliente em espanhol e a tradução para o português.
{
"message_text": "Hola, ¿tienen envío a Lima?",
"translated_text": "Olá, vocês fazem entregas para Lima?",
"message_type": "text",
"media_url": null,
"caption": null,
"conversation_id": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7a9c4f12",
"message_id": "6a1f3c2e-9b7d-4e5a-8c21-0d4b7e9f2a13",
"channel": "wa_business",
"contact_id": 12329727,
"ad": null,
"lang": "es",
"agent_lang": "pt",
"correlation_id": "b1e7d0c4-2f3a-4e8b-9c6d-7a5f1e2d3c4b",
"callback_url": "https://app.anylinga.com/api/connect/callback"
}
Como verificar a assinatura da requisição
1. Obtenha o segredo de assinatura
- Na página Conecte sua IA, copie o valor do campo Segredo de assinatura (X-AnyLinga-Signature).
2. Calcule a assinatura do corpo da requisição
- Calcule o HMAC-SHA256 do corpo bruto da requisição, sem alterações, usando o segredo como chave.
- Converta o resultado para hexadecimal para compará-lo com
X-AnyLinga-Signature.
3. Compare a assinatura com o cabeçalho
- Compare o valor calculado com o valor do cabeçalho
X-AnyLinga-Signature. - Se os valores não coincidirem, a requisição não é da AnyLinga. Não a processe.
Por que a requisição não inclui o negócio
O negócio não é enviado na requisição. Ela inclui apenas contact_id, o identificador do contato no Kommo, ou null. Se o fluxo precisar do negócio, você deve buscá-lo pelo contato usando a API do Kommo.
Perguntas relacionadas
Como conectar um agente de IA pelo n8n, quais mensagens são enviadas ao agente, por que a resposta não chega ao cliente, reações.
Ficou com dúvidas?
Respondemos em horário comercial.