Saltar al contenido

Agente de IA para WhatsApp con n8n: paso a paso y cuándo migrar

Cómo crear un agente de IA para WhatsApp con n8n y la API oficial: credenciales, disparador, nodo AI Agent con memoria, pruebas, costo total y las señales de que es hora de migrar.

Cofundador de Tolky

Actualizado el 19 de noviembre de 2026

13 min de lectura
Agente de IA para WhatsApp con n8n: paso a paso y cuándo migrar

TL;DR

Un agente de IA para WhatsApp con n8n conecta la API oficial de WhatsApp (Cloud API) a un flujo con el disparador WhatsApp Trigger, el nodo AI Agent con modelo, memoria y herramientas, y el nodo WhatsApp Business Cloud para responder. Armarlo lleva unas horas; operarlo exige bandeja para personas, cola, CRM, monitoreo, alojamiento 24/7 y cuidado con los datos personales. Cuando eso pesa más que el flujo, es hora de migrar, y los Flujos de Tolky importan el JSON de n8n.

Compartir

Puedes crear un agente de IA para WhatsApp con n8n en una tarde: un disparador recibe el mensaje por la API oficial, un nodo de agente de IA piensa y un nodo de WhatsApp responde. Los tutoriales más vistos terminan ahí.

No muestran el día siguiente: el cliente que pide una persona, el token que vence, la respuesta duplicada. Esta guía trae el paso a paso, lo que falta para operar, el costo y cuándo migrar.

Actualizado en noviembre de 2026.

¿Qué es un agente de IA para WhatsApp con n8n?

Un agente de IA para WhatsApp con n8n es un flujo de n8n que recibe los mensajes de WhatsApp por la API oficial, entrega cada uno a un modelo de lenguaje con memoria y herramientas, y envía la respuesta al cliente. El agente de IA decide qué decir y cuándo usar una herramienta, como consultar una hoja de cálculo.

Las piezas: la WhatsApp Cloud API, n8n, el modelo de lenguaje y la memoria de cada conversación.

n8n es una herramienta de automatización excelente, pero no es una plataforma de atención: no trae bandeja de entrada para el equipo, cola ni CRM.

¿Qué necesitas antes de empezar?

Necesitas una instancia de n8n accesible por HTTPS, una app de Meta con WhatsApp, un número y una clave de API de un modelo de lenguaje. La lista sigue la documentación de credenciales de WhatsApp en n8n, consultada el 19 de noviembre de 2026.

  • n8n en la nube o en tu servidor. n8n Cloud es una suscripción de pago; la versión autoalojada es gratis para uso interno, bajo la Sustainable Use License (FAQ de la licencia).
  • Cuenta de desarrollador de Meta y portafolio comercial, con una app que tenga el producto WhatsApp y esté en modo Live.
  • Un número. Meta ofrece un número de prueba; para producción, usa el de la empresa. Mira cómo conseguir la API oficial de WhatsApp Business.
  • Clave de API de un modelo de lenguaje, con límite de gasto.
  • Dirección pública con certificado válido. Meta solo entrega webhooks a endpoints HTTPS y no acepta certificados autofirmados (documentación de Meta, consultada el 19 de noviembre de 2026).

La documentación de instalación de n8n recomienda el autoalojamiento solo para usuarios con experiencia.

Cómo crear un agente de IA para WhatsApp en n8n, paso a paso

El flujo mínimo tiene cinco pasos: credenciales, disparador de mensaje recibido, filtro, nodo AI Agent con modelo, memoria y herramienta, y envío de la respuesta. Los nombres son los de la documentación de n8n al 19 de noviembre de 2026.

PasoNodo de n8nQué configurarCómo comprobar
1CredencialesAPI key (Access Token y Business Account ID) y OAuth2 (Client ID y Client Secret)La prueba de la credencial pasa
2WhatsApp TriggerEvento MessagesUn mensaje al número genera una ejecución
3IfSeguir solo con mensajes del clienteLos estados no llegan al agente
4AI AgentChat model, memoria, al menos una herramienta e instruccionesLa respuesta recuerda lo dicho
5WhatsApp Business CloudOperación Send, remitente y número del clienteLa respuesta llega al celular

1. Crea las credenciales de Meta en n8n

El nodo WhatsApp Business Cloud usa una credencial API key, con el Access Token y el ID de la cuenta de WhatsApp Business (en WhatsApp > API Setup, en la app de Meta). El WhatsApp Trigger usa OAuth2, con el App ID y el App Secret de App settings > Basic.

Ojo: el token de la pantalla de configuración es un token de usuario, que vence en pocas horas. Para producción, Meta indica usar un token de usuario del sistema, de larga duración (tokens de acceso, consultado el 19 de noviembre de 2026).

2. Configura el disparador de mensaje recibido

Usa el nodo WhatsApp Trigger con el evento Messages. Según la documentación del WhatsApp Trigger, WhatsApp acepta un solo webhook por app: alternar entre la URL de prueba y la de producción sobrescribe el registro. Además, publicar el flujo no suscribe la app a la cuenta de WhatsApp Business; sin eso, no llega nada ni aparece error.

El evento Messages también trae las actualizaciones de estado (enviado, entregado, leído), que Meta entrega en el mismo campo. Un nodo If justo después del disparador deja pasar solo los mensajes del cliente.

3. Arma el nodo AI Agent con memoria y herramientas

El AI Agent funciona con un modelo de chat y al menos una herramienta conectada (AI Agent en n8n). Escribe la instrucción del sistema (quién es, qué responde, cuándo pasa a una persona) y conecta la herramienta, como una solicitud HTTP.

Simple Memory pide una Session Key: usa el número del cliente, así cada conversación tiene la suya. La documentación de Simple Memory advierte que no funciona en producción con n8n en modo de cola (queue mode); en ese caso, usa una memoria en base de datos, como Postgres Chat Memory.

4. Envía la respuesta y prueba

En el nodo WhatsApp Business Cloud, usa la operación Send, con el número del cliente que vino del disparador como destinatario. Prueba con el número de prueba de Meta: preguntas fuera de alcance, un audio y tres mensajes seguidos.

La página de integración de WhatsApp Business Cloud en n8n tiene flujos de la comunidad con IA; revísalos antes de usarlos.

¿Cuáles son los errores más comunes al armarlo?

Los errores más comunes son de infraestructura, no de IA: mensajes duplicados, webhook sobrescrito, app no suscrita y tipos de mensaje sin tratar.

  • Respuesta duplicada. Meta reenvía el webhook sin confirmación durante hasta 7 días y recomienda tratar las repeticiones. Guarda el ID de cada mensaje.
  • Agente que responde a estados. Sin filtro, cada "entregado" dispara una respuesta.
  • Silencio total. La app no está suscrita a la cuenta de WhatsApp Business.
  • Flujo que deja de funcionar tras una prueba. La URL de prueba sobrescribió la de producción.
  • Audio, imagen y documento. El disparador los recibe, pero el agente solo entiende lo que tú trates.
  • Respuestas inventadas. Faltan instrucciones claras y una base de conocimiento.

¿Qué falta para que el agente sea una operación?

Un flujo que responde no es atención al cliente: falta dónde trabaja el equipo, cómo llega el caso a una persona y cómo la empresa mide y protege lo que pasa.

  • Bandeja para personas. n8n no tiene pantalla de conversaciones para que el equipo responda en el mismo número, con multiagente en WhatsApp.
  • Cola y traspaso con contexto, con las reglas de traspaso de la IA a un humano.
  • CRM e historial en un solo lugar, no repartidos en ejecuciones de n8n.
  • Plantillas para retomar clientes fuera de la ventana de 24 horas.
  • Métricas de resolución de la IA, tiempo de respuesta y traspasos.
  • Monitoreo y alojamiento 24/7, con alertas, copias de seguridad y actualizaciones.
  • Seguridad y privacidad. La LGPD de Brasil, por ejemplo, exige medidas técnicas y administrativas que protejan los datos personales de accesos no autorizados (Ley 13.709, art. 46). Eso vale para el servidor, los registros de ejecución y lo que se envía al modelo (LGPD).

¿Cuánto cuesta un agente de IA en WhatsApp con n8n?

El costo total suma alojamiento de n8n, uso del modelo de IA, tarifas de Meta y horas de mantenimiento, y la última suele ser la mayor. Solo las tarifas de Meta tienen precio público fijo.

ComponenteCómo se cobraEjemplo ilustrativo al mes
n8nSuscripción a n8n Cloud, o servidor y base de datos propiosUS$ 30
Modelo de IAPor tokens, según el proveedorUS$ 40
Tarifas de MetaPor mensaje entregado, con 1.000 respuestas de servicio gratis por número al mes(6.000 − 1.000) × US$ 0,0085 = US$ 42,50
MantenimientoHoras de quien cuida el flujo y los incidentes10 h × US$ 40 = US$ 400
Total ilustrativoUS$ 512,50

Servidor, modelo y hora son valores inventados. Las tarifas de Meta son reales: con la tabla vigente desde el 1 de octubre de 2026, consultada el 17 de noviembre de 2026, un mensaje de servicio a un número de México cuesta US$ 0,0085 después de los 1.000 gratis, y una plantilla de marketing, US$ 0,0397 (precios de WhatsApp Business Platform). Las tarifas cambian por país: simula en la calculadora de costo de la API de WhatsApp y mira cuánto cuesta un agente de IA para WhatsApp.

¿Cuándo quedarse en n8n y cuándo migrar?

n8n es la mejor opción cuando WhatsApp es una pieza de una automatización mayor y alguien técnico cuida el flujo; migrar tiene sentido cuando la atención se vuelve el centro.

Quédate en n8n si el volumen es pequeño, sin equipo humano en el número, o si ya usas n8n y tienes quien lo mantenga.

Señales de que es hora de migrar:

  • más de una persona necesita responder en el mismo número;
  • los clientes reciben respuestas repetidas, perdidas o fuera de hora;
  • solo una persona entiende el flujo;
  • la dirección pide métricas de atención;
  • el área legal pregunta dónde están las conversaciones y quién tiene acceso;
  • las horas de mantenimiento superan el precio de una plataforma.

Para comparar los caminos (n8n, plataforma o la IA de Meta), mira cómo crear un agente de IA para WhatsApp y la guía de automatización de WhatsApp para empresas.

¿Y las APIs no oficiales, como Evolution API y WAHA?

Muchos tutoriales de n8n conectan el número por WhatsApp Web, escaneando un código QR, sin la API oficial. Es gratis y rápido de probar, pero WhatsApp dice que las apps no oficiales violan sus términos y que la cuenta puede ser bloqueada.

Evolution API admite tanto WhatsApp Web (con la biblioteca Baileys) como la Cloud API oficial: el riesgo está en el modo de conexión. Los detalles están en la guía sobre la API no oficial de WhatsApp.

¿Cómo migrar de n8n a Tolky sin perder el trabajo?

Los Flujos de Tolky importan el JSON de un flujo de n8n para revisarlo en el editor visual y exportan flujos en formato n8n, con salvedades en los pasos que no tienen equivalente.

El camino, descrito en la integración con n8n:

  1. Exporta el flujo de n8n como JSON.
  2. En Flujos, usa Importar y elige el archivo.
  3. Revisa los nodos y publica. Los pasos sin equivalente se rehacen, en general con solicitud HTTP o código avanzado.

Lo que en n8n eran piezas sueltas viene listo: disparador de mensaje nativo, agente de IA con la base de conocimiento de la cuenta, traspaso a una persona que pausa la IA y lleva el historial, y pasos de CRM (negocio, etapa, etiqueta y tarea). Mira los flujos de automatización para WhatsApp y el CRM de Tolky.

Captura real de la pantalla de automatizaciones de Tolky, en tema oscuro y en portugués, con los módulos de automatización a un lado y una automatización abierta sobre una falla en la prueba de placa, con la condición Cuando escrita en lenguaje natural y la acción Crear ticket

Las Automatizaciones de la captura actúan en la conversación con condiciones en lenguaje natural. Para otros sistemas: más de 1.000 apps, solicitudes HTTP, webhooks, API REST y MCP (integraciones).

Lo que Tolky no hace: no tiene conector listo para Zapier o Make (el puente es por webhooks y solicitudes HTTP, como explica la pregunta sobre Zapier y Make), y la importación no convierte todos los nodos de n8n. WhatsApp entra desde el plan Starter (US$ 90 o R$ 500 al mes, 500 atenciones, 2 usuarios, 10 flujos y 1.000 ejecuciones); el plan Individual es gratis, pero sin WhatsApp. Las tarifas de Meta no forman parte del plan. Mira los planes.

Preguntas frecuentes

¿Se puede crear un agente de IA para WhatsApp con n8n gratis?

n8n autoalojado es gratis para uso interno, pero el servidor, el modelo de IA y las tarifas de Meta se pagan. Meta da 1.000 mensajes de servicio gratis por número al mes; por encima de eso, cada respuesta se cobra.

¿Qué API de WhatsApp usar con n8n?

La oficial, por la Cloud API de Meta, que tiene nodos propios en n8n: WhatsApp Trigger para recibir y WhatsApp Business Cloud para enviar. Las conexiones por WhatsApp Web traen riesgo de bloqueo del número.

¿Hay una plantilla lista de agente de IA para WhatsApp en n8n?

Sí. La página de integración de WhatsApp Business Cloud en el sitio de n8n lista flujos de la comunidad con IA. Revisa credenciales, memoria y reglas antes de usarlos.

¿n8n permite varios agentes en el mismo número?

No directamente: n8n no tiene bandeja de entrada para el equipo. Para varias personas en el mismo número, hace falta una plataforma de atención con la API oficial.

¿Por qué mi agente en n8n responde dos veces?

En general, Meta reenvió el webhook o el disparador se activó con una actualización de estado. Filtra los mensajes del cliente y guarda el ID de cada uno.

¿Puedo llevar mis flujos de n8n a Tolky?

Sí. Los Flujos de Tolky importan el JSON de n8n para revisarlo en el editor visual y exportan en formato n8n. Los pasos sin equivalente necesitan ajuste manual.


Conclusión

Un agente de IA para WhatsApp con n8n es una gran forma de validar un caso de uso. Cuando se vuelve atención con equipo, cola, CRM y métricas, el costo pasa al mantenimiento, y conviene comparar con una plataforma que ya trae esas piezas.

Mira los planes, conoce los Flujos de Tolky, trae tus flujos de n8n o habla con el equipo →. ¿Hablamos?

Compartir

Etiquetas

Sobre el autor

Cofundador de Tolky

Marlos Carmo es un emprendedor en IA y fundador de Tolky, la infraestructura y AI CRM de la era conversacional que unifica el servicio inteligente, la omnicanalidad (como WhatsApp y voz), el CRM en vivo y la inteligencia operativa en un único ecosistema. Es finalista del SXSW Innovation Awards e integrante de la Francesco's Economy, una red global de jóvenes emprendedores enfocados en la innovación y el impacto social. Trabaja conectando la Inteligencia Artificial y la transformación digital en proyectos para grandes organizaciones.

Siguiente paso

¿Quieres llevar esto a tu operación?

Tati, la asistente de IA de Tolky, entiende tu escenario en pocas preguntas, sugiere el mejor camino y te conecta con una persona del equipo con todo el contexto.

Compartir

Lea también sobre CRM conversacional y AI CRM