Integrar n8n con WhatsApp Business: Guía Técnica Paso a Paso 2026

Contexto: esta guía forma parte del cluster técnico de integraciones WhatsApp. Para la lista completa de plataformas conectadas, revisa integrar un CRM con WhatsApp Business.

¿Por qué integrar n8n con WhatsApp Business API en 2026?

n8n se ha convertido en el motor de automatización preferido en el middle market técnico. Según el panel de YipitData de abril de 2026, los clientes mid-market de n8n crecieron de 12 a 122 entre enero de 2025 y enero de 2026, y casi el 80% venían de Zapier. Automation Atlas registra en marzo de 2026 más de 60.000 instalaciones self-hosted, 3.000 clientes cloud y 800 integraciones comunitarias. El proyecto cerró una ronda Serie C de 60 millones de dólares en noviembre de 2025 con una valoración estimada de 600 millones. En el tracker público n8n Pulse figura con 169.500 estrellas en GitHub a 16 de enero de 2026.

Combinado con WhatsApp Business API, n8n permite montar flujos sin SaaS intermedios: el mensaje llega a tu webhook, pasa por tu lógica (CRM, pedidos, un LLM, firma biométrica, lo que sea) y responde por la misma API. Sin middleware opaco, sin costos por tarea, con los datos siempre bajo tu control.

Casos reales donde esta integración gana:

• Equipos técnicos con stack propio: n8n se despliega self-hosted en Docker junto a Postgres y Redis, sin romper el perímetro de seguridad
• Operaciones con alto volumen: por encima de 20.000 mensajes/mes los pricing por tarea de Zapier o Make dejan de tener sentido frente a una instancia n8n de 20 EUR/mes
• Casos que requieren LLM propio: conectar un agente de IA personalizado a WhatsApp sin pasar por un vendor cerrado
• Entornos regulados: el flujo de datos pasa por servidores propios, lo que simplifica cumplimiento RGPD

El coste de equivocarse en la arquitectura es alto: un token temporal que caduca a las 24 horas detiene la operación entera, una verificación de webhook mal implementada hace que Meta deshabilite el callback, y un n8n expuesto sin firma HMAC acepta payloads falsos. Esta guía evita esos tres errores desde el principio.

Arquitectura: cómo encaja n8n con WhatsApp Business Cloud

Antes de abrir un YAML, conviene fijar la arquitectura. Lo que Meta expone con WhatsApp Business Cloud API es un endpoint HTTP para enviar mensajes y un webhook que recibe los entrantes. n8n se coloca en medio como motor de orquestación.

El flujo real en producción tiene cuatro componentes:

1. Meta Business Suite: una app en Meta for Developers con el producto WhatsApp añadido, un número verificado (número de teléfono con WABA aprobada), un token de usuario del sistema permanente y una suscripción al evento messages en el webhook.
2. Endpoint HTTPS público: Meta solo entrega webhooks a un dominio público con TLS válido. Un n8n detrás de NAT no vale: hay que exponer con dominio propio, túnel estable (Cloudflare Tunnel es la opción limpia) o un reverse proxy delante.
3. Instancia n8n: self-hosted en Docker o n8n Cloud. Mínimo recomendado: 2 vCPU, 4 GB RAM, Postgres como base de datos de ejecuciones (SQLite colapsa pasados 5.000 ejecuciones/día) y Redis para la cola de workers.
4. Capa de salida: uno o varios workflows que leen el payload, aplican la lógica (consulta a tu CRM, llamada a un LLM, acceso a un ERP) y responden vía graph.facebook.com/v20.0/{phone_number_id}/messages.

El error más común es colocar la lógica de negocio en el mismo workflow que recibe el webhook. Meta exige que el POST entrante devuelva 200 OK en menos de 20 segundos o reintenta hasta 24 horas con backoff exponencial. En cuanto un LLM se demora o un CRM responde con 500, el webhook timea y aparecen mensajes duplicados en producción.

La arquitectura correcta separa en dos workflows: uno que recibe, valida la firma HMAC y mete en cola (via Redis o un nodo Execute Workflow); otro que consume la cola y hace el trabajo pesado con reintentos independientes.

n8n vs Zapier vs Make vs stack a medida: comparativa objetiva

No todo el mundo necesita n8n. Antes de empezar la integración, conviene comparar con honestidad las opciones habituales para conectar WhatsApp Business API con el resto del stack. Datos de precios públicos a octubre de 2026:

Opción	Precio base	Modelo de coste	Self-host	Mejor para
n8n Cloud Starter	24 USD/mes	2.500 ejecuciones/mes	Sí (Fair-Code)	Equipos técnicos con >10k mensajes/mes
n8n self-hosted	~20 EUR/mes VPS	Ejecuciones ilimitadas	Sí	Volumen alto, requisitos de datos propios
Zapier Professional	49 USD/mes	Por tarea (incluye 2.000)	No	Equipos no técnicos, bajo volumen
Make Core	10,59 USD/mes	Por operación (incluye 10.000)	No	Flujos simples con muchos pasos
Stack a medida (Node/Python)	Variable	Horas de ingeniería	Sí	Integraciones muy específicas o latencia crítica
Zenia Partners (gestionado)	297-497 EUR/mes	Agente, CRM, API y soporte	Opcional	Pymes que no quieren mantener la infraestructura

Cuándo n8n no es la respuesta: si tu equipo no tiene a nadie cómodo con Docker, logs y Postgres, o si el volumen está por debajo de 500 mensajes/mes, Make o Zapier salen más baratos en tiempo de operación. Si en cambio esperas pasar de 10.000 mensajes/mes, n8n (self-hosted o cloud) empieza a ganar en coste y en soberanía del dato.

Zenia Partners construye el agente de IA personalizado en WhatsApp y web que responde en menos de un minuto, cualifica y agenda 24/7, con CRM y atribución por canal. Planes: Starter 997 EUR de setup + 297 EUR/mes, Growth 497 EUR/mes, Enterprise a medida. Si prefieres mantener tú el stack, el resto de esta guía es la receta.

¿Qué necesitas antes de empezar? Checklist de requisitos

Más del 70% de los proyectos que vemos fallan en la primera semana por saltarse los prerrequisitos. Esta es la lista que seguimos en Zenia Partners antes de abrir n8n:

Del lado de Meta (obligatorio)

• Cuenta Business en Meta for Business verificada (NIF o CIF, factura reciente)
• Un número de teléfono dedicado para WhatsApp Business API, no utilizado antes en la app WhatsApp normal (se migra, pero no se puede usar en paralelo)
• App en Meta for Developers con el producto WhatsApp añadido
• Token de usuario del sistema (System User Token) permanente, nunca el temporal de 24 horas que Meta ofrece por defecto
• Plantillas aprobadas si vas a iniciar conversaciones fuera de la ventana de 24 horas

Del lado de infraestructura

• Dominio público con certificado TLS válido para el webhook (Let's Encrypt sirve)
• n8n instalado y accesible, con autenticación básica activada y backup diario de Postgres
• Variable de entorno N8N_WEBHOOK_URL apuntando a tu dominio público, no a localhost
• Un token secreto para el verify_token del handshake (generar con openssl rand -hex 32)
• El App Secret de Meta guardado como credencial para firmar los webhooks entrantes con HMAC SHA-256

Del lado del negocio

• Política de privacidad publicada en la web (Meta la pide durante la revisión)
• Mensaje de bienvenida y de ausencia definidos
• Horario de atención humana claro para los casos de escalado
• Base de clientes actual en el CRM destino (HubSpot, Pipedrive, Zoho o CRM propio)

Sin esto, el proyecto se encalla. Con esto, la integración lleva una tarde.

Guía paso a paso para integrar n8n con WhatsApp Business

Esta es la secuencia exacta que seguimos en implementación. Cada paso incluye el error más común que vemos en soporte.

Paso 1: Crear la app en Meta for Developers

Entra en developers.facebook.com, pulsa "Mis apps" y "Crear app". Elige tipo "Empresa". Dentro de la app, añade el producto WhatsApp. Verás tres secciones: configuración de API, plantillas y configuración del webhook. El número de teléfono y el Phone number ID aparecen en la primera pestaña. Guárdalos: los usarás en cada llamada.

Error típico: usar un número que ya tiene la app WhatsApp instalada en un móvil. Hay que desvincularlo primero desde la app o perderás acceso durante 7 días.

Paso 2: Generar un token de usuario del sistema permanente

El token que Meta muestra por defecto expira en 24 horas. En producción se usa un System User Token. Pasos: Meta Business Suite → Configuración → Usuarios → Usuarios del sistema → "Añadir". Da nombre "n8n-whatsapp" y rol admin. Pulsa "Generar nuevo token", elige la app, selecciona los permisos whatsapp_business_messaging y whatsapp_business_management, y marca "Nunca" en caducidad.

Copia el token y guárdalo en una credencial de n8n tipo "Header Auth" con cabecera Authorization: Bearer {token}. Nunca lo pongas directo en los nodos.

Paso 3: Montar el webhook en n8n (verificación)

Crea un workflow nuevo. Añade un nodo Webhook, método GET, path whatsapp, response mode Last Node. Añade después un nodo IF que compare {{ $json.query["hub.mode"] }} con "subscribe" y {{ $json.query["hub.verify_token"] }} con tu secreto. En el camino verdadero, un nodo Respond to Webhook que devuelva {{ $json.query["hub.challenge"] }} como texto plano.

Activa el workflow. Copia la URL de producción del webhook (algo como https://n8n.tu-dominio.com/webhook/whatsapp). En la app de Meta, sección WhatsApp → Configuración → Webhooks, pega esa URL y tu verify_token. Pulsa "Verificar". Si todo está bien, Meta responde "Webhook verificado".

Error típico: dejar el workflow en modo "Test". Meta llama a la URL de producción, no a la de test. Si no activas, falla la verificación.

Paso 4: Recibir mensajes y validar la firma HMAC

Duplica el workflow anterior. Cambia el método del webhook a POST, mismo path whatsapp. Meta enviará cada mensaje entrante a este endpoint con una cabecera X-Hub-Signature-256 que contiene un HMAC SHA-256 del payload firmado con tu App Secret.

Añade un nodo Code con JavaScript:

• Lee $json.headers["x-hub-signature-256"]
• Calcula crypto.createHmac('sha256', $env.APP_SECRET).update(JSON.stringify($json.body)).digest('hex')
• Compara ambos valores con timingSafeEqual
• Si no coinciden, devuelve null y responde 401

Luego añade un nodo Respond to Webhook inmediatamente con 200 OK, antes de hacer cualquier otra cosa. Después haz el trabajo pesado (CRM, LLM, envíos) en los nodos siguientes.

Error típico: olvidar la respuesta 200 inmediata. Meta reintenta hasta 24 horas y aparecen mensajes duplicados en Odoo o HubSpot.

Paso 5: Suscribirse al evento messages

En la app de Meta, en la misma pantalla del webhook, pulsa "Gestionar" y marca el campo messages. Sin esta suscripción Meta no envía nada aunque la verificación esté verde.

Paso 6: Enviar respuestas desde n8n

En el workflow de mensajes entrantes, añade después de tu lógica un nodo WhatsApp Business Cloud (nativo en n8n desde la versión 1.42) o un HTTP Request contra https://graph.facebook.com/v20.0/{PHONE_NUMBER_ID}/messages con el token como Bearer y el payload:

{
  "messaging_product": "whatsapp",
  "to": "{{ $json.body.entry[0].changes[0].value.messages[0].from }}",
  "type": "text",
  "text": { "body": "Hola, soy el agente de Zenia Partners" }
}

Si vas a iniciar la conversación (fuera de la ventana de 24 h desde el último mensaje del cliente), tienes que usar una plantilla aprobada con type: template y los parámetros correspondientes.

Paso 7: Conectar un LLM o un CRM

Entre el webhook y la respuesta, añade los nodos de negocio. Las conexiones más habituales son:

• OpenAI, Anthropic o un modelo local para generar la respuesta del agente de IA personalizado
• HubSpot, Pipedrive, Zoho o un CRM a medida para crear/actualizar el contacto y registrar la conversación
• Google Calendar o Calendly para agendar citas (ver guía específica)
• Un ERP (Odoo, Holded, Sage) para consultar stock, facturas o pedidos

En Zenia Partners añadimos siempre una capa de clasificación de intención antes del LLM: así los mensajes repetitivos (reservas, consultas de horario, confirmaciones) se responden con plantillas rápidas y solo las conversaciones complejas pasan por el modelo. Esto reduce el coste por mensaje en un 60-80% sin perder calidad.

¿Cuánta latencia y fiabilidad conseguimos en producción?

Un flujo n8n + WhatsApp API bien configurado tiene presupuestos de tiempo muy marcados. Estos son los números que vemos en instancias productivas con 15.000-80.000 mensajes/mes:

• Webhook POST → 200 OK: entre 60 y 180 milisegundos. Por encima de 500 ms conviene revisar el nodo Code de la firma HMAC.
• Validación HMAC + enrutamiento a cola: 20-40 ms adicionales si usas Redis o Execute Workflow asíncrono.
• Consulta al CRM: 150-400 ms contra HubSpot, 80-220 ms contra una Postgres local, 2-3 s si pegas directamente a Salesforce sin caché.
• Generación con LLM: 800 ms a 2,5 s con GPT-4o-mini o Claude Haiku, 2-6 s con modelos frontier. Siempre con streaming off, porque WhatsApp recibe el mensaje completo.
• Envío a Meta y entrega: 180-350 ms al endpoint, propagación al teléfono del cliente en 1-3 s.

Tiempo total percibido por el cliente: entre 1,2 y 3,5 segundos para una respuesta de intención simple, hasta 8 segundos cuando entra un modelo frontier. Suficiente para que el agente parezca humano y muy por encima de los 23-47 minutos de respuesta manual que mide el sector hostelero.

Puntos de fallo que hemos visto

• Rate limit de Meta: 80 mensajes/segundo en Tier 1. Sin control de concurrencia el 429 llega a los 100 clientes simultáneos. Solución: cola Redis con backoff.
• Caducidad de la ventana de 24 horas: cualquier respuesta fuera requiere plantilla aprobada. En n8n se detecta leyendo el timestamp del último mensaje entrante.
• Deriva del Phone number ID: si cambias de WABA, el ID cambia. Guárdalo en variable de entorno, nunca en el workflow.
• Postgres sin VACUUM: n8n inserta por cada ejecución. En 60 días la tabla execution_entity puede superar los 10 GB. Programa EXECUTIONS_DATA_PRUNE.
• Memory leak con nodos AI Agent: iteraciones largas sin maxIterations pueden retener contexto. Fijar siempre un límite.

Observabilidad mínima

Un flujo en producción sin observabilidad es una caja negra. Las piezas que montamos en Zenia Partners por defecto:

• Workflow de salud que llama a /me de Graph API cada 5 min y alerta en Slack si falla
• Nodo Postgres que guarda cada ejecución en una tabla analítica (duración, tipo de mensaje, intención detectada, coste del LLM)
• Dashboard Metabase o Grafana con tiempo medio de respuesta, tasa de escalado humano y uso del token
• Backup diario de la base de datos n8n a S3 con retención de 30 días

Cuándo n8n no es la mejor opción (y qué usar)

Ser honesto sobre los límites de n8n ahorra meses de frustración. Hay escenarios donde conviene ir por otra ruta:

• Negocio sin equipo técnico: si no hay quien actualice el contenedor, revise logs o restaure un backup, Make o un servicio gestionado como el de Zenia Partners salen más baratos a tres meses vista
• Latencia crítica bajo 400 ms end-to-end: por debajo de ese umbral conviene un servicio escrito en Go o Node directamente contra Graph API, sin pasar por un motor de workflows
• Flujos de puro ETL de alto volumen: Apache Airflow o un pipeline nativo escalan mejor que n8n a partir del millón de ejecuciones diarias
• Equipos con <500 mensajes/mes: Make Core a 10,59 USD/mes resuelve el problema con menos infraestructura
• Requisitos de certificación FINRA o HIPAA estrictos: n8n no está certificado por defecto. Se puede, pero la auditoría cuesta más que el ahorro

Para el resto de pymes y mid-market, la combinación n8n + WhatsApp Business API es probablemente la mejor relación control/coste disponible en octubre de 2026.

Preguntas frecuentes

¿Cuánto cuesta integrar n8n con WhatsApp Business API?

El coste técnico mínimo es 20 EUR/mes (VPS 2 vCPU 4 GB) más 24 USD/mes si usas n8n Cloud. La API de WhatsApp Business cobra por conversación iniciada por el negocio (0,04 a 0,09 EUR por conversación en España, octubre de 2026); las conversaciones iniciadas por el cliente son gratuitas en el nivel básico. Si contratas la implementación con Zenia Partners (agente completo, CRM, soporte), el plan Starter está en 997 EUR de setup y 297 EUR/mes.

¿Es legal usar n8n con WhatsApp Business API en España?

Sí, siempre que uses la API oficial Cloud de Meta y no una no oficial tipo Baileys o Evolution. Con la API oficial cumples los términos de servicio y puedes aplicar RGPD con las medidas estándar: consentimiento explícito, política de privacidad, derecho de acceso y supresión. Las APIs no oficiales violan los TOS y Meta puede bloquear el número.

¿Puedo usar n8n Cloud o es obligatorio self-hosted?

Las dos funcionan. n8n Cloud es más rápido de arrancar y Meta no diferencia. Self-hosted gana por soberanía del dato (ideal si tratas datos de salud, legales o financieros) y por coste a partir de 10.000 ejecuciones/mes. Para la mayoría de pymes, Cloud es la elección correcta los primeros 6 meses.

¿Qué pasa si Meta cierra la cuenta de WhatsApp Business?

Es el riesgo real de la plataforma. Las causas más comunes son violar las políticas de spam (envíos masivos no solicitados), usar APIs no oficiales o recibir muchos bloqueos de usuarios. En Zenia Partners mantenemos la calidad de la cuenta por encima del nivel verde con límites de frecuencia, opt-in validado y plantillas aprobadas antes de cualquier envío proactivo.

¿Cuántos mensajes por segundo soporta esta arquitectura?

Meta permite por defecto 80 mensajes/segundo salientes en Tier 1, y hasta 1.000/segundo en Tier 3 (una vez validado el volumen durante 30 días). n8n self-hosted con cola Redis puede procesar 150-300 ejecuciones/segundo en una instancia de 4 vCPU y 8 GB. Para volúmenes superiores conviene horizontal scaling con workers.

¿Puedo migrar mis flujos actuales de Zapier o Make a n8n?

No hay importación directa, pero cada integración se puede recrear nodo a nodo. Según YipitData (abril de 2026), casi el 80% de los nuevos clientes mid-market de n8n venían de Zapier, así que la ruta de migración está probada. En proyectos típicos la migración de 10-15 Zaps a workflows n8n lleva 2-3 semanas de ingeniería.

Resumen operativo

Integrar n8n con WhatsApp Business API en 2026 es, resumido: una app de Meta con producto WhatsApp, un token permanente del system user, un webhook público HTTPS que responde al hub.challenge, firma HMAC en el POST entrante, respuesta 200 inmediata, trabajo pesado en una cola y envío al endpoint de Graph API. Con esta arquitectura se consiguen tiempos de respuesta percibidos entre 1,2 y 3,5 segundos y entregas estables por encima de 60.000 mensajes/mes en una instancia modesta.

El resto es la lógica de negocio: qué CRM alimentar, qué LLM invocar, qué plantillas usar, cómo escalar a humano. Lo repasamos en nuestras guías de plataformas de IA conversacional y integración de WhatsApp Business API en España.