Cómo crear un agente de IA en WhatsApp con n8n y la API oficial

Para crear un agente de IA en WhatsApp con n8n necesitas una app de Meta con un número en la Cloud API y cuatro piezas de n8n: el nodo WhatsApp Trigger, que recibe los mensajes; el nodo AI Agent, con un modelo, una memoria y herramientas; el nodo WhatsApp Business Cloud, que responde; y una tabla donde registrar cada conversación. Con eso tienes un agente que contesta dentro de la ventana de 24 horas y pasa a una persona cuando no sabe.

Esta guía es la parte práctica en n8n. La explicación general (alcance, número, plantillas, pruebas) está en cómo crear un agente de IA para WhatsApp, y si no conoces la herramienta, empieza por qué es n8n y para qué sirve.

¿Qué piezas necesitas?

Pieza	Nodo o servicio	Para qué sirve
App de Meta y número	Panel de desarrolladores de Meta	Es la identidad del agente y su acceso a la Cloud API
Entrada	WhatsApp Trigger, evento Messages	Arranca el flujo con cada mensaje
Cerebro	AI Agent con un nodo de modelo	Entiende el mensaje y decide qué hacer
Memoria	Simple Memory o Postgres Chat Memory	Recuerda lo que se ha hablado
Herramientas	Call n8n Workflow Tool, HTTP Request, Google Calendar y otros	Consulta y actúa en tus sistemas
Salida	WhatsApp Business Cloud, operación Send	Envía la respuesta
Registro	Data Table	Guarda cada mensaje, evita duplicados y marca quién atiende
Errores	Error Trigger	Te avisa cuando el flujo falla

El nodo AI Agent no arranca sin dos cosas: un modelo conectado y al menos una herramienta. Su documentación lista como compatibles los nodos de modelo de OpenAI, Anthropic, Mistral, Groq y Microsoft Foundry.

¿Cómo conectas n8n con tu cuenta de WhatsApp?

Necesitas una cuenta de desarrollador de Meta, una cartera de empresa y una app con el producto WhatsApp. En la configuración básica de la app, rellena la URL de la política de privacidad y la de las condiciones de servicio, y cambia el modo de la app a Live, como indica la guía de credenciales de n8n.

n8n usa dos credenciales distintas, y es un error frecuente crear solo una:

Nodo	Tipo de credencial	Qué pide	Dónde lo sacas
WhatsApp Trigger	OAuth2	Client ID y Client Secret	App ID y App Secret, en App settings > Basic
WhatsApp Business Cloud	API key	Access Token y Business Account ID	WhatsApp > API Setup

El token que genera el botón de API Setup sirve para empezar, pero Meta avisa de que caduca enseguida. Para producción, crea un usuario del sistema en la configuración de la empresa y genera su token con tres permisos: business_management, whatsapp_business_messaging y whatsapp_business_management. Guárdalo en la credencial de n8n, nunca escrito en un nodo.

Antes de registrar el número, decide dónde se guardan los mensajes. El almacenamiento local solo se puede activar o desactivar con el número sin registrar, y entre las regiones está la UE, en Alemania (código DE). Ojo con lo que cubre: el contenido en reposo se queda en esa región, pero mientras se procesa puede estar en centros de datos de Meta de otros países hasta 60 minutos en la Cloud API.

¿Cómo se monta el flujo, paso a paso?

1. Pon el disparador. Añade un WhatsApp Trigger con el evento Messages y la credencial OAuth2.
2. Separa los mensajes de los avisos de estado. Por el mismo campo messages, Meta envía los mensajes del cliente y el estado de los tuyos. Los avisos de estado se reconocen porque traen una lista statuses en lugar de messages, y cada mensaje que envías puede generar hasta tres: enviado, entregado y leído. Con un nodo If o Switch, deja pasar al agente solo lo que trae messages.
3. Descarta duplicados y registra. Meta reintenta los avisos que no se confirman durante 7 días, los reintentos pueden llegar repetidos y no hay ninguna API para recuperar avisos antiguos. Guarda cada mensaje en una tabla de datos de n8n, que la propia n8n propone para marcar lo ya procesado, y antes de contestar comprueba que su identificador no está ya. Por defecto, todas las tablas de una instancia comparten un límite de 200 MiB.
4. Mira quién atiende. Si en la tabla esa conversación está marcada como "persona", el flujo termina aquí y el agente no habla.
5. Convierte las notas de voz. Si el mensaje es de tipo audio, descárgalo con la operación Media > Download del nodo de WhatsApp y pásalo por la operación Transcribe a Recording del nodo de OpenAI, que admite archivos de hasta 25 MB.
6. Configura el agente. En el AI Agent, pon Prompt en "Define below" y apunta con una expresión al texto del mensaje, que Meta envía en text.body. La otra opción espera un campo chatInput, el que produce el disparador de chat de n8n; sin él aparece el error "No prompt specified", y la solución que da n8n es justo pasar a "Define below". En System Message escribe el papel del agente, qué puede hacer, qué no, cuándo deriva y que debe presentarse como IA. Max Iterations, el número de vueltas que da el modelo para llegar a una respuesta, viene en 10 por defecto.
7. Conecta la memoria y las herramientas. Lo vemos en las dos secciones siguientes.
8. Responde. Con WhatsApp Business Cloud > Message > Send, al número que escribió. Envía una sola respuesta por turno: la plataforma permite un mensaje cada 6 segundos al mismo usuario, y el orden de entrega no está garantizado.
9. Prepara los errores. Crea un flujo que empiece por un Error Trigger y asígnalo en Settings > Error workflow del flujo principal. Solo salta en ejecuciones automáticas, no cuando pruebas a mano.

¿Qué memoria usar y qué clave de sesión poner?

La memoria guarda el historial para que el agente no empiece de cero en cada mensaje. Las dos opciones habituales:

• Simple Memory. Es la más fácil. Pero no funciona en modo cola en un flujo de producción, porque n8n no puede garantizar que cada llamada vaya al mismo proceso.
• Postgres Chat Memory. Guarda el historial en tu base de datos Postgres y crea la tabla si no existe. Es la que conviene si tu n8n escala o si quieres consultar las conversaciones.

Las dos piden una Session Key y una Context Window Length, el número de intercambios anteriores que se envían al modelo. Más historial es más contexto y también más tokens.

La clave de sesión es lo que más se configura mal. El disparador de chat de n8n la trae hecha; con cualquier otro disparador la gestionas tú, y una clave fija solo vale para pruebas: con ella, todos tus clientes compartirían conversación.

Usa el identificador de usuario de Meta, no el teléfono. Desde principios de abril de 2026, Meta incluye en todos los avisos de mensajes un identificador de usuario por empresa (BSUID) en el campo user_id, y en los mensajes entrantes llega siempre. El teléfono, en cambio, puede faltar: WhatsApp está introduciendo nombres de usuario poco a poco en 2026, y si un cliente adopta uno, su número deja de aparecer en los avisos salvo excepciones, como haber cruzado mensajes o llamadas con ese número en los últimos 30 días. Meta advierte que las empresas deben admitir el BSUID para no perder la capacidad de procesar esos mensajes. Dos matices: el BSUID es distinto para cada cartera de empresa y se regenera si el usuario cambia de número.

¿Qué herramientas le das al agente?

Cada herramienta es un nodo conectado al agente con una descripción que le dice cuándo usarla. Para tus propias acciones, la más útil es Call n8n Workflow Tool: el agente llama a otro flujo tuyo ("consultar huecos de agenda", "abrir incidencia") y recibe su resultado. Un detalle que cuesta horas: en producción ese subflujo tiene que estar publicado. Si no lo está, el agente recibe el error "Workflow is not active and cannot be executed" como respuesta de la herramienta y puede acabar diciéndole al cliente que no ha podido consultar los datos.

Para lo delicado, n8n permite exigir aprobación humana antes de que el agente use una herramienta concreta. El flujo se pausa y envía la petición por el canal que elijas (entre otros, WhatsApp, Slack, Microsoft Teams, Gmail u Outlook) con el nombre de la herramienta y los datos que quiere usar. Si alguien la aprueba, se ejecuta; si la rechaza, se cancela y el agente lo sabe. n8n pide explicar en el mensaje de sistema qué herramientas necesitan aprobación y cómo responder si se rechazan.

Una regla práctica: herramientas pequeñas y concretas. Un agente con permiso para "consultar la agenda" se equivoca mucho menos que uno con acceso libre a tu base de datos.

¿Cómo respetas la ventana de 24 horas y las plantillas?

Cuando un cliente te escribe o te llama, se abre una ventana de atención de 24 horas, y cada nuevo mensaje suyo la reinicia. Dentro, el agente responde con texto libre. Cuando se cierra, solo puedes enviar plantillas aprobadas.

En n8n, eso se traduce en tres decisiones:

1. Guarda en la tabla la hora del último mensaje del cliente. Así sabes si la ventana sigue abierta.
2. Antes de escribir por iniciativa propia, como un recordatorio o la respuesta tardía de un empleado, comprueba la ventana. Si está cerrada, usa la operación Send Template.
3. Cuadra los parámetros de la plantilla. El error "Bad request - please check your parameters" suele salir con Send Template cuando los datos no encajan con la plantilla: revisa el tipo y el orden de cada parámetro.

El coste también cambió hace poco. Desde el 1 de octubre de 2026, Meta vuelve a cobrar los mensajes de servicio a partir del 1.001 de cada mes por número, y las plantillas de utilidad enviadas dentro de la ventana dejan de ser gratis. Las tarifas de España están en precios de la API de WhatsApp Business, y tu factura la estimas con la calculadora de coste de la API de WhatsApp.

¿Cómo pasas la conversación a una persona?

La política de mensajería de WhatsApp exige, cuando automatizas, vías de escalado rápidas, claras y directas, como el traspaso a una persona en el propio chat, un teléfono o un email. En n8n se monta así, a partir del ejemplo de n8n de respaldo humano, que usa una herramienta para cuando el agente no sabe la respuesta o no está seguro:

1. Crea la herramienta "pasar a persona" con Call n8n Workflow Tool y una descripción clara: úsala si no sabes la respuesta, si no estás seguro o si el cliente pide hablar con alguien.
2. El subflujo marca la conversación como "persona" en la tabla, avisa al equipo con un resumen y le dice al cliente cómo sigue la conversación.
3. La persona responde. La vía más simple es que llame o escriba por email. Si quieres que conteste en el chat, envía el aviso al equipo con la operación Send and Wait for Response en modo Free Text, que existe en el nodo de WhatsApp y en otros como Slack; lo que escriba el empleado se manda al cliente con Send, siempre dentro de la ventana de 24 horas.
4. Pon un tiempo máximo. La opción Limit Wait Time reanuda el flujo pasado un plazo. Si nadie ha contestado, ofrece al cliente un teléfono o un email.
5. Devuelve la conversación al agente al cerrar el caso, cambiando la marca en la tabla.

Si usas Send and Wait for Response, revisa la opción Append n8n Attribution: decide si el mensaje dice que se envió automáticamente con n8n.

¿Por qué no llegan los mensajes a n8n?

Los cuatro fallos más habituales, según la documentación del disparador:

1. Funciona en pruebas y no publicado, o al revés. WhatsApp admite un solo webhook por app, así que la URL de pruebas y la de producción se pisan. Para probar un flujo ya publicado, despublícalo, prueba y vuelve a publicarlo. Mientras tanto no atiende a nadie.
2. La app no está suscrita a tu cuenta de WhatsApp Business. n8n registra la URL del webhook en tu app, pero no suscribe la app a la cuenta. Los mensajes no llegan y n8n no muestra ningún error, aunque el evento de prueba del panel de Meta sí llegue. Se comprueba con una petición GET a subscribed_apps usando el ID de la cuenta (no el del número) y un token con el permiso whatsapp_business_management; si tu app no aparece, una petición POST la suscribe. No envíes nunca un DELETE: da de baja la app de la cuenta.
3. El token temporal ha caducado. El agente deja de enviar respuestas.
4. Tu servidor no publica bien la URL. Si alojas n8n detrás de un proxy inverso, n8n no puede montar la URL correcta por sí solo: define N8N_WEBHOOK_URL y N8N_PROXY_HOPS=1. La variable antigua, WEBHOOK_URL, está obsoleta desde la versión 2.35.0. Además, Meta exige un certificado TLS válido y no acepta los autofirmados.

¿n8n Cloud o autoalojado en la UE?

	n8n Cloud	Autoalojado
Dónde están los datos	En la UE, en servidores de Frankfurt	Donde lo instales
Precio a fecha de octubre de 2026	Con pago anual: Starter, 20 € al mes y 2.500 ejecuciones; Pro, 50 € al mes y 10.000 ejecuciones	Community, gratis; Business, 667 € al mes con pago anual
Mantenimiento	Lo lleva n8n	Es tuyo: actualizaciones, copias y seguridad
Qué te toca configurar	Las credenciales y el flujo	Además, una URL pública con certificado válido y, si escalas en modo cola, una memoria que no sea Simple Memory

Fuentes: precios de n8n y cómo elegir entre nube y autoalojado.

Una ejecución es una pasada completa del flujo, tenga los pasos que tenga. En un agente de WhatsApp, cada mensaje del cliente es al menos una ejecución. Si los avisos de estado también llegan a tu flujo, cada uno lo arranca, aunque lo descartes en el primer nodo. Haz la cuenta antes de elegir plan.

Y alojar n8n en Frankfurt no hace europeo todo el recorrido. Meta procesa los mensajes y el proveedor del modelo de IA recibe el texto de cada conversación. Dónde procesa los datos cada proveedor lo tienes en la guía de n8n.

¿Qué te exige la ley?

• Informar y firmar con cada encargado. El agente trata datos personales, así que tienes que informar a quien escribe, como pide el artículo 13 del RGPD. Meta, n8n si usas su nube y el proveedor del modelo tratan datos por tu cuenta: el artículo 28 te obliga a elegir encargados con garantías suficientes y a regularlo con un contrato.
• Decir que es una IA. El artículo 50 del Reglamento de Inteligencia Artificial exige que quien habla con un sistema de IA lo sepa, salvo que resulte evidente, de forma clara y a más tardar en la primera interacción. Se aplica desde el 2 de agosto de 2026 (artículo 113). Ponlo en el primer mensaje y en el mensaje de sistema.
• No convertirlo en un asistente general. Según la página de Meta sobre proveedores de IA, que remite a sus condiciones actualizadas el 15 de enero de 2026, los proveedores y desarrolladores de modelos de IA solo pueden ofrecer asistentes de IA de uso general en la plataforma allí donde la ley obliga a Meta a permitirlo. La misma página aclara que eso no cambia lo que Meta cobra al resto de empresas. Un agente que atiende a tus clientes sobre tu negocio es otra cosa, pero mantenlo centrado en tu negocio.

¿Y si prefieres no montarlo tú?

Nosotros diseñamos y construimos agentes de IA y chatbots de WhatsApp conectados a lo que ya usas, con n8n entre otras herramientas, los datos alojados en la UE y sin subcontratar. Damos precio cerrado tras un diagnóstico gratuito de 2 a 5 días, y una automatización típica está funcionando en 2 a 4 semanas. Lo explicamos en inteligencia artificial.

Preguntas frecuentes

¿Qué clave de sesión pongo en la memoria del agente?

El identificador de usuario que Meta envía en el campo user_id, que llega siempre en los mensajes entrantes desde abril de 2026. El teléfono puede faltar si el cliente usa un nombre de usuario. Nunca una clave fija: todos tus clientes compartirían conversación.

¿Cuántas ejecuciones de n8n gasta un agente de WhatsApp?

Al menos una por cada mensaje que recibe, porque n8n cuenta cada pasada completa del flujo. Si los avisos de entregado y leído llegan a tu flujo, también cuentan. El plan Starter de n8n Cloud incluye 2.500 ejecuciones al mes, a fecha de octubre de 2026.

¿Puede el agente escribir a un cliente pasadas 24 horas?

Solo con una plantilla aprobada por Meta, que en n8n se envía con la operación Send Template. Por eso conviene guardar la hora del último mensaje de cada cliente y comprobar la ventana antes de escribir.

¿Por qué mi flujo funciona en pruebas pero no cuando lo publico?

WhatsApp admite un solo webhook por app, y la URL de pruebas y la de producción se sobrescriben. Si tampoco llega nada publicado, comprueba que tu app esté suscrita a la cuenta de WhatsApp Business con subscribed_apps.

¿Es obligatorio decir que el agente es una IA?

Sí. Desde el 2 de agosto de 2026, el artículo 50 del Reglamento de Inteligencia Artificial exige informar de forma clara, como tarde en la primera interacción, salvo que sea evidente. Ponlo en el saludo del agente.

Fuentes

• n8n, WhatsApp Trigger.
• n8n, WhatsApp Business Cloud node y sus problemas habituales.
• n8n, WhatsApp Business Cloud credentials.
• n8n, AI Agent, Tools Agent y problemas habituales del AI Agent.
• n8n, Simple Memory, sus problemas habituales y Postgres Chat Memory.
• n8n, Call n8n Workflow Tool.
• n8n, Human-in-the-loop for tools y Set a human fallback for AI workflows.
• n8n, OpenAI audio operations.
• n8n, Data tables, Switch y Error Trigger.
• n8n, Configure webhook URLs with reverse proxy.
• n8n, Choose how to use n8n y Plans and pricing.
• Meta, WhatsApp Cloud API Get Started y About the WhatsApp Business Platform.
• Meta, Webhooks overview, Create a webhook endpoint y Messages webhook reference.
• Meta, Business-scoped user IDs.
• Meta, Service messages.
• Meta, Pricing on the WhatsApp Business Platform y Pricing policy for AI Providers.
• Meta, Local storage y Register a business phone number.
• WhatsApp, WhatsApp Business Messaging Policy.
• Reglamento (UE) 2016/679, RGPD (BOE), artículos 13 y 28.
• Reglamento (UE) 2024/1689 de Inteligencia Artificial (BOE), artículos 50 y 113.