Iniciar sesiónEmpezar prueba gratis
Meta Tech Provider

Agente de IA de WhatsApp en n8n, con la respuesta escrita por tu flujo de trabajo

Un paso de automatización envía mediante POST el mensaje del cliente, firmado y con hasta 10 mensajes recientes del chat, a un nodo Webhook de n8n. Un nodo AI Agent redacta la respuesta, un nodo Respond to Webhook devuelve {"reply": "..."} en un plazo de 20 segundos, y ese texto se envía desde el número de WhatsApp Business, que sigue funcionando en la app. Los agentes más lentos reciben el webhook de Meta directamente y responden mediante la Graph API.

easyCoexistence conecta el número de WhatsApp Business que ya usas en la app con la Cloud API de Meta mediante Coexistencia y ejecuta automatizaciones en él.

20 s

Cuánto espera el paso Call my webhook la respuesta de tu flujo antes de fallar.

10

Los mensajes más recientes del chat que se envían en history, del más antiguo al más reciente, terminando con el mensaje que inició la ejecución.

4,096

Caracteres de una respuesta enviada como un único texto de WhatsApp; lo que exceda se recorta.

6 hours

Intervalo mínimo entre dos correos de fallo para la misma automatización cuando falla un paso de webhook.

2 modules

Lo que n8n Cloud permite en un nodo Code: crypto y moment; n8n autoalojado habilita crypto con NODE_FUNCTION_ALLOW_BUILTIN.

24 hours

Ventana de atención tras el último mensaje del cliente; después, Meta solo acepta mensajes de plantilla.

¿Cómo llega un mensaje de WhatsApp a un agente de IA en n8n?

Mediante una automatización en el número. El número tiene que recibir sus mensajes a través de easyCoexistence (el modo "Through easyCoexistence"), para que Meta los entregue aquí; una automatización cuyo disparador es A message arrives y cuyo paso es Call my webhook envía luego el mensaje mediante POST a tu Production URL de n8n. El flujo responde en la misma respuesta HTTP, y el texto que devuelve se envía al cliente como mensaje de WhatsApp desde tu número.

Antes de llamar a n8n, la ejecución ya ha superado los controles. Una entrega que Meta repite nunca inicia una segunda ejecución, una respuesta que escribiste en la app pausa la automatización en ese chat (4 horas por defecto) y la respuesta solo sale dentro de las 24 horas posteriores al último mensaje del cliente. Tu flujo solo decide qué decir.

1Customer writesTo the number you keep in the WhatsApp Business app
2Call my webhookSigned POST with the message and recent chat
3n8n AI AgentWebhook node, signature check, AI Agent node
4Respond to Webhook{"reply": "..."} within 20 seconds
5Reply sentAlso shown in the app's chat thread

¿Qué envía easyCoexistence al nodo Webhook de n8n?

Un POST en JSON con User-Agent easyCoexistence-automations/1, X-EC-Event con el valor automation.step y una cabecera X-EC-Signature. message contiene el texto del cliente, o un marcador como [image] con el pie de foto para los archivos multimedia; una nota de voz llega como [voice message] seguido de sus palabras cuando hay guardada una clave de OpenAI o de OpenRouter. history contiene hasta 10 mensajes recientes del chat, del más antiguo al más reciente, cada uno con una direction: in para el cliente, out para la respuesta de una automatización y echo para una persona que escribe desde el teléfono. Cubre los mensajes guardados durante el periodo de retención de la cuenta (30, 90 o 365 días, 90 por defecto), y únicamente los que llegaron mientras los mensajes del número pasaban por easyCoexistence.

Una prueba desde el panel Try it del editor envía el mismo POST con dry_run en true, un history vacío, el contacto de ejemplo 15550000000 llamado Test customer y un id de mensaje que empieza por test_. No se envía nada a nadie, pero tu flujo sí se ejecuta, así que omite los efectos secundarios, como crear pedidos, cuando dry_run es true.

POST body of a Call my webhook step
{
  "event": "automation.step",
  "dry_run": false,
  "automation": { "id": "b7e0c3a2-5d1f-4c8e-9a6b-2f4d8e1c7a90", "name": "Send to my system" },
  "run_id": "0d9f6a41-8c2e-4b7a-a315-6e9c2b8d4f17",
  "channel": {
    "type": "whatsapp",
    "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f",
    "phone": "+1 631-555-0142",
    "phone_number_id": "106540352242922"
  },
  "connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
  "contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
  "message": {
    "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==",
    "type": "text",
    "text": "Do you have gluten-free bread today?",
    "at": "2026-11-11T14:02:11.000Z"
  },
  "history": [
    { "direction": "in", "text": "Hi! Are you open today?", "at": "2026-11-11T13:58:40.000Z" },
    { "direction": "out", "text": "Hi Ana! Yes, until 8 pm.", "at": "2026-11-11T13:58:45.000Z" },
    { "direction": "in", "text": "Do you have gluten-free bread today?", "at": "2026-11-11T14:02:11.000Z" }
  ]
}

¿Cómo verificas la firma en n8n?

Añade un nodo Code justo después del nodo Webhook. X-EC-Signature tiene el formato t=<unix seconds>,v1=<hex>, donde v1 es un HMAC-SHA256 de t, un punto y el cuerpo, usando como clave el Signing secret de la automatización. Para copiarlo, abre la automatización guardada y selecciona su paso Call my webhook. Cada automatización tiene su propio secreto y las herramientas de MCP nunca lo devuelven, así que, aunque la automatización la haya creado tu IA, tendrás que copiar el secreto una vez desde el panel. Un botón New secret lo reemplaza y el anterior deja de funcionar al instante, y solo el propietario de la cuenta puede verlo, no un miembro del equipo invitado.

Rechaza un t que esté a más de 5 minutos de tu reloj, compara en tiempo constante y lanza un error si la verificación falla: el flujo falla entonces antes de Respond to Webhook, n8n responde 500 y no se envía nada. n8n Cloud permite el módulo crypto en los nodos Code; el n8n autoalojado necesita NODE_FUNCTION_ALLOW_BUILTIN=crypto. La acción Hmac del nodo Crypto con un nodo IF también funciona, aunque una comparación con IF no es de tiempo constante.

n8n Code node: verify X-EC-Signature
// n8n Code node, mode "Run Once for Each Item", placed right after the Webhook node.
// n8n Cloud allows require('crypto'); self-hosted needs NODE_FUNCTION_ALLOW_BUILTIN=crypto.
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the automation's Signing secret, from its editor page

const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec($json.headers['x-ec-signature'] || '');
if (!m) throw new Error('Missing X-EC-Signature');
if (Math.abs(Date.now() / 1000 - Number(m[1])) > 300) throw new Error('Stale signature');

// The body was signed as compact JSON, which JSON.stringify rebuilds from the parsed body.
const mac = crypto.createHmac('sha256', SECRET).update(`${m[1]}.${JSON.stringify($json.body)}`).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(m[2], 'hex'))) throw new Error('Bad signature');

return { json: $json.body }; // event, dry_run, contact, message, history...

¿Cómo configuras el nodo AI Agent y la respuesta?

Dale al nodo AI Agent el texto del cliente como mensaje de usuario y todo lo demás en su mensaje de sistema: quién es el negocio, los datos que puede citar, el tono y el chat reciente de history, para que una pregunta de seguimiento tenga sentido. Conecta el modelo de chat que quieras, además de herramientas como una herramienta HTTP Request que consulte un pedido.

Termina con un nodo Respond to Webhook que responda con JSON y ponga el texto del agente en un campo llamado reply. easyCoexistence recorta los espacios, ignora un reply vacío o que no sea una cadena, y envía el resto como un único texto de WhatsApp de hasta 4096 caracteres, así que pide al modelo frases sencillas en lugar de markdown.

AI Agent and Respond to Webhook settings
AI Agent node
  Prompt: Define below
  Prompt (User Message): {{ $json.message.text }}
  Options > System Message:
    You answer WhatsApp messages for Bloom Café, 12 Baker St, open Tue to Sun 8:00 to 20:00.
    Reply in 1 to 3 short sentences, in the customer's language, as plain text.
    Never invent prices or stock. If unsure, say a person will reply here soon.
    Recent chat, oldest first:
    {{ $json.history.map(h => (h.direction === 'in' ? 'Customer: ' : 'Business: ') + h.text).join('\n') }}
  Chat Model: your OpenAI, Anthropic or OpenRouter model
  Tools (optional): an HTTP Request tool that looks up orders

Respond to Webhook node
  Respond With: JSON
  Response Body: { "reply": {{ $json.output.toJsonString() }} }

¿Qué pasa si el flujo tarda, falla o no devuelve nada?

Cada resultado queda registrado en la pestaña Runs de la automatización, con la salida o el error del paso, para que veas cuál de estos casos ocurrió:

  • Sin respuesta en 20 segundos: el paso falla con Webhook did not answer, no se envía nada y la ejecución aparece como Failed.
  • Un estado fuera de 2xx, incluidas las redirecciones: el paso falla con Webhook answered HTTP y el código.
  • Un 2xx sin una cadena reply: la ejecución queda como Done, el paso muestra HTTP 200, no reply, y el cliente no recibe nada automático.
  • Una ejecución fallida te envía un correo para que puedas responder a ese cliente tú mismo, como máximo una vez por automatización cada 6 horas.
  • Un chat que respondiste desde el teléfono dentro de la pausa (4 horas por defecto, configurable en Advanced) se omite como human_active antes de llamar a n8n.
  • Varios mensajes seguidos inician varias ejecuciones. Un Wait de 1 minuto antes de Call my webhook hace que se responda una sola vez, porque un mensaje más reciente que active la misma automatización reemplaza la ejecución en espera.

¿Cuándo conviene que n8n reciba directamente el webhook de Meta?

Cuando el agente necesita más de 20 segundos, cuando el flujo debe ver todos los eventos (estados, tus respuestas desde el teléfono, ids de archivos multimedia), cuando envía algo que ningún paso cubre, como un Flow o un mensaje de catálogo, o cuando el negocio quiere la importación del historial de 6 meses, que solo llega a un destino directo guardado en las 24 horas posteriores a la conexión. El modo directo desactiva las automatizaciones del número: Meta envía su propio payload directamente a n8n y easyCoexistence nunca ve los mensajes.

En n8n, usa el nodo Webhook normal, no el nodo WhatsApp Trigger, que espera tu propia app de Meta y su secreto. Activa Allow Multiple HTTP Methods para que una sola ruta larga y aleatoria reciba el handshake GET de Meta y los POST, responde al GET con el hub.challenge tal cual como texto, y guarda esa Production URL con un verify token mediante set_webhook_destination. Las respuestas salen entonces desde un nodo HTTP Request hacia el endpoint de envío, y la deduplicación, la pausa por respuesta desde el teléfono y la verificación de 24 horas pasan a ser cosa tuya.

Call my webhook (Automations on)Direct webhook (automations off)
Who calls n8neasyCoexistence, when the automation matchesMeta, for every event on the number
Time to answer20 seconds, reply in the responseNo limit: send later through the Graph API
AuthenticationX-EC-Signature with the automation's secretA long random secret in the URL path
GuardsDedupe, phone pause and 24-hour check built inYours to write
What n8n can sendText in the reply; the other steps of the automation can send buttons, files and templatesAny Cloud API message type, templates included
History importNot availableIf saved within 24 hours of connecting
Kept by easyCoexistenceMessage text for your retention period (90 days by default), run logs 30 daysNothing

Cómo configurarlo

  1. Turn on automations for the numberOn the number's page, the Automations and incoming messages card shows Automations on or Direct to your server. Click Turn on automations if needed; numbers connected without a webhook URL start with automations on.
  2. Build and publish the workflowWebhook node (POST, Respond: Using 'Respond to Webhook' Node), Code node, AI Agent node, Respond to Webhook node. Publish or activate it and copy the Production URL.
  3. Create the automation, switched OffIn Automations, click New automation and pick Send to my system under Start from an example. Paste the Production URL into Webhook URL, set the switch to Off so it does not answer customers yet, and click Save.
  4. Copy the Signing secret into n8nSelect the Call my webhook step of the saved automation, copy Signing secret and paste it into the Code node.
  5. Test, then switch it OnClick Test, type a sample message in Try it and press Run test: n8n runs with dry_run true and the result shows the reply. When it reads right, switch the automation On and save.

Errores comunes

  • Dejar la opción Respond del nodo Webhook en Immediately. n8n responde Workflow got started al instante, la ejecución registra HTTP 200, no reply, y el cliente no recibe nada. Elige Using 'Respond to Webhook' Node.
  • Pegar la Test URL, la que lleva /webhook-test/. Solo escucha mientras el editor espera un evento de prueba; las automatizaciones necesitan la Production URL de un flujo publicado.
  • Verificar con el forward secret del número. Call my webhook se firma con el Signing secret propio de la automatización; el forward secret solo firma los eventos reenviados, así que los pasos auténticos no superan la verificación.
  • Devolver el texto con otro formato. Solo se envía un cuerpo JSON con una cadena de primer nivel llamada reply; {"output": "..."} o un cuerpo text/plain se registra como no reply.
Hacerlo con EasyCoexistence

Su paso Call my webhook entrega el mensaje del cliente a n8n y envía la respuesta de vuelta, con deduplicación, la pausa cuando respondes desde el teléfono y la verificación de 24 horas incluidas, sin cargo adicional por ejecución. De US$ 9 a US$ 0.75 por número al mes, un precio que baja a medida que añades números, con los primeros 3 días gratis.

Preguntas frecuentes

¿Pueden ChatGPT o Claude crear esta automatización por mí?

Sí. Con el conector de easyCoexistence añadido, pide una automatización en tu número que envíe los mensajes entrantes a tu URL de n8n; la IA llama a create_automation con un paso call_webhook y luego a test_automation. Pide que cree la automatización desactivada hasta que supere la prueba. El Signing secret no se devuelve por MCP, así que cópialo desde la página de la automatización.

¿El flujo puede enviar imágenes, botones o plantillas?

No a través del campo reply, que solo admite texto. Deja que lo haga la automatización: pasos como Enviar una imagen o archivo, Hacer una pregunta con botones y Enviar una plantilla pueden ir antes o después de Llamar a mi webhook. Para otros tipos de mensaje, envíalos desde un nodo HTTP Request a la Cloud API, con el endpoint de envío y el token que devuelve get_api_credentials, y no devuelvas reply para que el cliente no reciba dos respuestas.

¿Un solo flujo puede responder a varios números?

Sí. Apunta una automatización por número a la misma Production URL y ramifica según channel.phone_number_id o automation.id. Cada automatización tiene su propio Signing secret, así que elige el secreto por automation.id antes de verificar la firma.

¿Funciona con n8n autoalojado?

Sí, si su Production URL es HTTPS pública. easyCoexistence rechaza direcciones http, localhost, privadas e internas al guardar la URL y de nuevo antes de cada llamada, y no sigue redirecciones.

Sigue leyendo

¿Listo para empezar?

Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.

Empezar prueba gratis

Verificado el