AnyLinga
PT
Entrar Teste grátis

Central de ajuda/Agente de IA

Quais dados seu fluxo n8n recebe da AnyLinga

Atualizado: 2026-11-13

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.

CampoConteúdo
message_textTexto do cliente no idioma dele; para mídia, a legenda ou um marcador como [Image]; para mensagem de voz, a transcrição.
translated_textO mesmo texto no idioma dos atendentes da conta.
message_typetext, image, audio, document, video ou sticker.
media_urlLink para o arquivo ou null. No WhatsApp Business API, o link passa pela AnyLinga e abre sem autenticação.
captionLegenda que o cliente adicionou à mídia ou null.
conversation_idID da conversa na AnyLinga; necessário para iniciar uma conversa com o cliente.
message_idID desta mensagem do cliente na AnyLinga; o agente usa esse ID para adicionar uma reação. Na mensagem de teste, é null.
channelCanal de origem da mensagem.
contact_idID do contato no Kommo ou null.
adAnúncio da Meta a partir do qual o cliente enviou esta mensagem ou null.
langIdioma do cliente.
agent_langIdioma dos atendentes da conta.
correlation_idID desta requisição; você deve retorná-lo na resposta.
callback_urlEndereç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.
O modelo inicial do n8n (Baixar .json) não verifica a assinatura. Você precisa adicionar essa verificação ao fluxo.

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.

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.

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