AnyLinga
ES
Iniciar sesión Prueba gratis

Centro de ayuda/Agente de IA

Qué datos recibe tu flujo de n8n de AnyLinga

Actualizado: 2026-11-13

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.

CampoContenido
message_textTexto del cliente en su idioma; para archivos multimedia, el texto adjunto o una etiqueta como [Image]; para mensajes de voz, la transcripción.
translated_textEl mismo texto en el idioma de los agentes de la cuenta.
message_typetext, image, audio, document, video o sticker.
media_urlEnlace al archivo o null. En WhatsApp Business API, el enlace pasa por AnyLinga y se abre sin autenticación.
captionTexto que el cliente adjuntó al archivo multimedia o null.
conversation_idID de la conversación en AnyLinga; lo necesitas para escribirle primero al cliente.
message_idID de este mensaje del cliente en AnyLinga; el agente lo usa para agregar una reacción. En el mensaje de prueba es null.
channelCanal del que llegó el mensaje.
contact_idID del contacto en Kommo o null.
adAnuncio de Meta desde el que el cliente envió este mensaje o null.
langIdioma del cliente.
agent_langIdioma de los agentes de la cuenta.
correlation_idID de esta solicitud; debes devolverlo en la respuesta.
callback_urlDirecció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.
La plantilla inicial de n8n (Descargar .json) no verifica la firma. Debes agregar esta verificación al flujo por tu cuenta.

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.

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.

¿Te resultó útil este artículo?

¿Tienes preguntas?

Respondemos en horario laboral.

¿Ya usas AnyLinga?

Cuéntanos tu pregunta y te respondemos por WhatsApp o email.

¿Aún no tienes cuenta?

Pruébalo tú mismo o lo conectamos por ti al pagar el primer mes.

Consultar conexión

Qué necesitas