Agente de IA en WhatsApp con n8n: paso a paso completo

El diseño tiene seis nodos. Webhook (disparador) recibe el evento messages de la instancia. Un nodo Code extrae número, texto e id y descarta tus propios mensajes. Un IF o el propio Code corta duplicados y conversaciones que ya están con un humano. El nodo AI Agent recibe el texto, usa la memoria de ese contacto y, si hace falta, llama a herramientas. Por último, un HTTP Request (o el nodo de la comunidad) envía la respuesta por send/text.

Antes de armarlo, entiende qué entrega n8n y qué no: orquesta, pero el modelo de IA es del proveedor que configures en la credencial del nodo, y el costo de ese proveedor es aparte. La página de la integración con n8n y la guía para integrar WhatsApp en n8n cubren la base; aquí el foco es el agente.

Una instancia de ZapZap conectada por código QR, la clave y el secreto de la API, un n8n accesible desde internet (self-hosted con HTTPS o n8n Cloud) y una credencial de un proveedor de modelo de IA. Para pruebas locales, n8n necesita una URL pública; un túnel sirve para desarrollar, no para producción.

En n8n, crea una credencial Header Auth o usa campos de cabecera fijos para x-api-key y x-api-secret. Así el secreto queda en la credencial, no escrito en cada nodo. Si prefieres partir de algo listo, hay modelos en plantillas de n8n para WhatsApp.

Agrega un nodo Webhook, método POST, y copia la Production URL (la de prueba solo funciona con el flujo en modo de escucha). Registra esa URL en la instancia con POST /webhook, activando el evento messages. Activa el flujo antes de usar la URL de producción.

Prueba con POST /instances/{id}/webhook/test: dispara un evento de prueba y devuelve el status HTTP y el tiempo de respuesta de tu endpoint. Si algo falla, GET /instances/{id}/webhook/deliveries muestra las últimas entregas y GET /webhook/errors, las fallas.

curl -X POST https://api.zapzapapi.com/api/v1/SEU_INSTANCE_ID/webhook \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_API_KEY" \
  -H "x-api-secret: SEU_API_SECRET" \
  -d '{"url":"https://SEU-N8N.com/webhook/whatsapp-agente","enabled":true,"events":["messages"]}'

Este es el nodo que evita los tres bugs más comunes: que el agente responda a su propio mensaje (fromMe), que responda dos veces al mismo evento y que responda en grupos sin querer. Comprueba la estructura exacta del evento en la pestaña de ejecución del Webhook, con un mensaje real; el código usa lectura defensiva y tú ajustas los nombres.

El nodo devuelve un ítem con numero, texto e id. Si el mensaje no debe tratarse, devuelve una lista vacía, lo que termina el flujo en esa rama. La deduplicación usa el almacenamiento estático del workflow, suficiente para un n8n único; con varias instancias de n8n, usa una base de datos o Redis.

const evento = $input.first().json.body ?? $input.first().json;
const msg = evento.message ?? evento.data ?? evento;

if (msg.fromMe) return [];
const id = msg.messageid ?? msg.id;
const numero = msg.sender ?? msg.from;
const texto = msg.text ?? msg.body ?? "";
const grupo = String(msg.chatid ?? msg.chatId ?? "").endsWith("@g.us");

if (!numero || !texto || grupo) return [];

const estado = $getWorkflowStaticData("global");
estado.vistos = estado.vistos ?? [];
if (id && estado.vistos.includes(id)) return [];
if (id) estado.vistos = [...estado.vistos.slice(-500), id];

return [{ json: { numero: String(numero).replace(/\D/g, ""), texto, id } }];

Agrega el nodo AI Agent. Configura tres cosas. Modelo de chat: elige el proveedor y el modelo en la credencial (el nombre del modelo queda en tu configuración, no en esta guía). Memoria: usa una memoria de ventana con la clave de sesión igual al número del contacto, para que cada cliente tenga su propia conversación. Prompt de sistema: rol, tono, límites y regla de traspaso a un humano.

Un prompt de sistema funcional, en pocas líneas: quién es el asistente y para qué empresa; responde en mensajes cortos, con tono de WhatsApp; usa solo la información provista; si no sabes o si el cliente pide una persona, responde exactamente la frase de traspaso acordada. Esa frase fija permite que el flujo detecte el handoff enseguida, con un nodo IF.

Si el agente necesita consultar datos (agenda, pedido, inventario), agrega herramientas: un HTTP Request como herramienta que apunte a tu sistema, con una descripción clara de lo que hace. Mantén pocas herramientas y bien descritas; los modelos se equivocan más cuando tienen muchas opciones.

Después del agente, agrega un HTTP Request. Method POST; URL https://api.zapzapapi.com/api/v1/SU_INSTANCE_ID/send/text; cabeceras x-api-key y x-api-secret; cuerpo JSON con number y text. El campo text viene de la salida del agente, y number viene del nodo Code.

El campo delay de send/text y la presencia escribiendo (message/presence) hacen la respuesta más natural, y un pequeño retraso evita parecer una máquina. Úsalos con moderación: lo que más pesa para el número es el comportamiento general, no un truco de envío.

{
  "number": "{{ $('Normalizar').item.json.numero }}",
  "text": "{{ $json.output }}",
  "delay": 2000
}

curl -X POST https://api.zapzapapi.com/api/v1/SEU_INSTANCE_ID/send/text \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_API_KEY" \
  -H "x-api-secret: SEU_API_SECRET" \
  -d '{"number":"5511999999999","text":"Resposta do agente","delay":2000}'

Existe un paquete de nodos de la comunidad, n8n-nodes-zapzap, publicado en npm (versión 0.1.3 comprobada el 27/10/2026), que cubre envío de mensajes, multimedia, encuestas, botones y listas, reacciones, gestión de instancias y recepción de eventos en tiempo real. Simplifica la configuración, porque el nodo ya conoce los campos.

Un límite importante: según la documentación de n8n (leída el 27/10/2026), los nodos de la comunidad no verificados no están disponibles en n8n Cloud y exigen n8n self-hosted. Como este paquete es de la comunidad y no tenemos el sello de verificado de n8n, el camino garantizado en n8n Cloud es el HTTP Request. Los dos funcionan con la misma API y las mismas credenciales.

n8n-nodes-zapzap

Después del agente, un nodo IF verifica si la respuesta es la frase de traspaso. Si lo es, el flujo marca al contacto como con humano (en una tabla de n8n, Redis o tu CRM), avisa al equipo y le envía al cliente un mensaje corto. Antes del agente, otro IF consulta esa marca y termina el flujo si el contacto está con un humano.

La marca necesita un plazo de expiración o un botón de liberar, de lo contrario el contacto nunca vuelve al bot. Este mismo diseño aparece en la guía del chatbot de WhatsApp con IA, con reglas de handoff y costo.

Para el día a día, mantén activo el historial de ejecuciones de n8n los primeros días, revisa muestras de conversación y ajusta el prompt. Para ver todos los recursos de la API que el agente puede usar como herramienta, abre la referencia y el OpenAPI.