Qué datos recibe tu flujo de n8n de AnyLinga
AnyLinga envía a tu flujo de n8n un JSON con el mensaje del cliente, su traducción, datos de los archivos multimedia, el idioma y los identificadores de la conversación y del contacto. La solicitud también incluye correlation_id, que debes devolver en la respuesta, y callback_url, la dirección a la que debes enviar la respuesta.
Cómo llega la solicitud y qué contiene
AnyLinga envía una solicitud POST a la URL del webhook de n8n.
Los encabezados de la solicitud son Content-Type: application/json y X-AnyLinga-Signature.
Al hacer clic en Probar conexión, llega un mensaje de prueba con el texto AnyLinga Connect test, channel: test y un campo adicional test: true.
| Campo | Contenido |
|---|---|
message_text | Texto del cliente en su idioma; para archivos multimedia, el texto adjunto o una etiqueta como [Image]; para mensajes de voz, la transcripción. |
translated_text | El mismo texto en el idioma de los agentes de la cuenta. |
message_type | text, image, audio, document, video o sticker. |
media_url | Enlace al archivo o null. En WhatsApp Business API, el enlace pasa por AnyLinga y se abre sin autenticación. |
caption | Texto que el cliente adjuntó al archivo multimedia o null. |
conversation_id | ID de la conversación en AnyLinga; lo necesitas para escribirle primero al cliente. |
message_id | ID de este mensaje del cliente en AnyLinga; el agente lo usa para agregar una reacción. En el mensaje de prueba es null. |
channel | Canal del que llegó el mensaje. |
contact_id | ID del contacto en Kommo o null. |
ad | Anuncio de Meta desde el que el cliente envió este mensaje o null. |
lang | Idioma del cliente. |
agent_lang | Idioma de los agentes de la cuenta. |
correlation_id | ID de esta solicitud; debes devolverlo en la respuesta. |
callback_url | Dirección a la que debes enviar la respuesta. |
Ejemplo de JSON
Así se ve una solicitud con un mensaje de texto del cliente en español y su traducción al ruso.
{
"message_text": "Olá, vocês entregam em Lima?",
"translated_text": "Hola, ¿tienen envío a 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": "pt",
"agent_lang": "es",
"correlation_id": "b1e7d0c4-2f3a-4e8b-9c6d-7a5f1e2d3c4b",
"callback_url": "https://app.anylinga.com/api/connect/callback"
}
Cómo verificar la firma de la solicitud
1. Obtén el secreto de firma
- En la página Conecta tu IA, copia el valor del campo Secreto de firma (X-AnyLinga-Signature).
2. Calcula la firma del cuerpo de la solicitud
- Calcula el HMAC-SHA256 del cuerpo sin procesar de la solicitud, tal como llega, usando el secreto como clave.
- Expresa el resultado en hexadecimal para compararlo con
X-AnyLinga-Signature.
3. Compara la firma con el encabezado
- Compara el valor calculado con el valor del encabezado
X-AnyLinga-Signature. - Si los valores no coinciden, la solicitud no proviene de AnyLinga. No la proceses.
Por qué la solicitud no incluye un lead
La solicitud no incluye el lead, solo contact_id, el identificador del contacto en Kommo, o null. Si tu flujo necesita el lead, debes buscarlo por contacto a través de la API de Kommo.
Preguntas relacionadas
Cómo conectar un agente de IA con n8n, qué mensajes se envían al agente, por qué la respuesta no llega al cliente, reacciones.
¿Tienes preguntas?
Respondemos en horario laboral.