Agendar Asesoría Gratuita

Cómo conectar WhatsApp a n8n (API oficial, Twilio/360dialog y Evolution API)

En la era digital, las automatizaciones se han convertido en una herramienta clave para ahorrar tiempo, reducir errores y aumentar la productividad. Permiten que tareas repetitivas —como responder mensajes, enviar correos, registrar ventas o publicar contenido— se realicen de forma automática, liberando tiempo para enfocarse en estrategias y crecimiento.

Tanto las empresas como las marcas personales pueden aprovechar la automatización para optimizar sus procesos, mejorar la experiencia del cliente y escalar sus resultados sin necesidad de aumentar su carga operativa.

Desde el marketing y las ventas, hasta la atención al cliente o la gestión de redes sociales, automatizar es sinónimo de eficiencia y profesionalismo.

1) Qué opciones tengo para usar WhatsApp en n8n (comparativa rápida)

Antes de abrir n8n, decide el camino:

  • Oficial (WhatsApp Cloud API de Meta)
    Ideal si buscas estabilidad, escalabilidad y cumplimiento. Necesitas una WABA, verificar negocio y usar plantillas para mensajes fuera de la ventana de 24 h.
  • Proveedores intermedios (Twilio, 360dialog)
    Te simplifican trámites, documentación y soporte. Sueles pagar un fee adicional, pero a cambio ganas tiempo y menor fricción para arrancar.
  • Enfoque “device-based” (p. ej., Evolution API)
    Se conecta a un WhatsApp instalado en un dispositivo. Es la vía más rápida de puesta en marcha en muchos casos, pero depende de un teléfono y conlleva riesgos de estabilidad y cuenta. Úsalo con responsabilidad y respetando políticas.

En mi caso, cuando la verificación empresarial se volvió tediosa en LATAM, Evolution API fue la vía más ágil para prototipar. Luego, al pasar a producción, migré a la API oficial por fiabilidad y cumplimiento.

Tabla: oficial vs proveedores vs device-based

CriterioCloud API (Meta)Twilio/360dialogEvolution API (device-based)
Tiempo de altaMedio (verificación)Rápido–MedioMuy rápido
CosteBajo–Medio (Meta fees)Medio–Alto (fee del proveedor)Bajo (infra propia)
EstabilidadAltaAltaMedia (depende del dispositivo)
CumplimientoAltoAltoSensible (estricto con políticas)
EscaladoAltoAltoLimitado
SoporteDocs oficialesSoporte del proveedorComunidad

2) Requisitos y credenciales con la API oficial (Cloud API)

Para trabajar con el nodo de WhatsApp Business Cloud en n8n necesitarás:

  • Access Token (largo plazo recomendado, guardado como credencial en n8n).
  • Business Account ID (WABA).
  • Phone Number ID del número asociado a la WABA.
  • Webhook URL pública (n8n self-hosted o n8n Cloud) para recibir mensajes/eventos.
  • Plantillas (Templates) aprobadas si enviarás mensajes proactivos fuera de la ventana de 24 h.

Buenas prácticas de credenciales

  • Guarda tokens en Credentials de n8n, nunca en texto plano.
  • Rota el token con un workflow programado (Cron → HTTP para renovar).
  • Usa Environments/Variables si tienes dev/stage/prod.

Campos necesarios: Access Token, WABA ID, Phone Number ID

En las credenciales del nodo, rellena Access Token y enlaza Phone Number ID. Vincula la WABA en la configuración del proyecto de Meta. Mantén un documento interno con quién renueva tokens y cada cuánto.

3) Paso a paso: enviar tu primer mensaje desde n8n (nodo oficial)

  1. Crear credencial: en n8n, ve a Credentials → WhatsApp Cloud y pega tu Access Token.
  2. Workflow base: añade un Trigger sencillo (p. ej., Manual Trigger para pruebas).
  3. Nodo WhatsApp Cloud → Send Message:
    • To: número en formato internacional (ej. +573001234567).
    • Type: text.
    • Body: “¡Hola! Este es un test desde n8n 🚀”.
  4. Ejecuta el workflow. Verifica el Execution Log y el delivery en WhatsApp.
  5. Plantillas: crea una plantilla en Meta (categoría Marketing, Utility o Authentication). En el nodo, cambia Type: template y completa Name, Language y Components.

Tip personal: cuando hago pruebas, primero envío un mensaje dentro de la ventana de 24 h para validar el canal y, ya estable, paso a plantillas. Evita iterar plantillas en hora punta: a veces tardan en aprobarse.

Workflow base: Webhook → If → WhatsApp Send

  • Webhook recibe datos (por ejemplo, desde un formulario o tu app).
  • If valida que venga el número y el consentimiento.
  • WhatsApp Cloud (Send) dispara el mensaje (texto/plantilla).
  • Set/ Code formatean campos; Google Sheets/DB registran la interacción.

4) Recibir mensajes: webhooks y flujos entrantes en n8n

Para escuchar mensajes entrantes:

  1. En n8n, crea un Webhook node (método POST) y copia la URL.
  2. En Meta, configura el Webhook Callback URL y el Verify Token (el mismo que en tu nodo Webhook).
  3. Verifica la suscripción (Meta hará una llamada GET de challenge).
  4. Agrega nodos de parsing: Function/Code para leer messages, contacts, statuses.
  5. Ramas por tipo de mensaje: texto, imagen, botón, etc.
  6. Responde con WhatsApp Cloud Send o enruta a tu CRM.

Validación de webhooks en Meta + prueba en n8n

  • Usa Manual Run → Listen for Test Event en el Webhook de n8n para escuchar el challenge.
  • Loguea cada entrada (con Set + Spreadsheet o DB) para auditar.

En mi experiencia, tener un registro mínimo (número, timestamp, intención) desde el día 1 evita dolores cuando escalas: puedes entrenar respuestas y detectar picos.

5) Alternativas con proveedores (Twilio/360dialog): cuándo convienen

  • Si quieres ir más rápido que la verificación tradicional, estos proveedores ofrecen caminos guiados y soporte.
  • Plantillas y ventanas siguen las reglas de WhatsApp, pero el panel del proveedor suele facilitar su creación.
  • En n8n puedes usar su nodo específico (si existe) o un HTTP Request con su API REST.

Costes, soporte y tiempos de verificación típicos

  • Pagas por mensaje y/o por número al proveedor.
  • A cambio, ganas SLA y paneles con métricas, lo cual he valorado cuando un equipo no técnico opera el día a día.

6) Enfoque device-based (Evolution API): casos prácticos y riesgos

Cuándo lo uso

  • Prototipos rápidos, validación de idea y POCs.
  • Casos donde ya existe un WhatsApp Business en teléfono y se requiere conectar eventos de app/tienda a mensajes.

Cómo se integra con n8n

  • Normalmente expones endpoints tipo REST (Evolution API) y en n8n disparas HTTP Request para enviar mensajes, y Webhook para recibir.

Riesgos y responsabilidad

  • Dependencia de un dispositivo, posibles caídas y riesgos de cuenta si incumples políticas.
  • No recomiendo prácticas que “simulen actividad humana”. En su lugar, cumple: consentimiento explícito, control de frecuencia, contenido útil y respeto a la 24 h.
    En mi caso, usar Evolution API me sirvió para salir en días, pero siempre lo traté como temporal hasta migrar a la vía oficial.

Limitaciones técnicas, mantenimiento y estabilidad

  • Vigila reconexiones, batería/dispositivo, colas de mensajes y reintentos en n8n.
  • Añade alertas (p. ej., IF → Slack/Email) si falla un envío.

7) Playbooks listos: alertas, bots FAQ y captura de leads (nodos clave)

A) Alertas transaccionales (pedido, pago, envío)

  • Trigger: Webhook desde tu app/tienda.
  • If: consentimiento y estado del pedido.
  • WhatsApp (template): plantilla “pedido_en_camino” con variables (nombre, tracking).
  • Log: Google Sheets / DB.

B) Bot FAQ liviano (sin LLM)

  • Trigger: Webhook entrante de WhatsApp.
  • Code/If: matching por palabras clave.
  • Send: respuesta predefinida o menú de botones.
  • Fallback: redirige a un humano (Slack/Support).

C) Captura de leads a CRM

  • Webhook entrante desde WhatsApp.
  • Set: normaliza nombre y teléfono.
  • HubSpot/Sheets: crea/actualiza contacto.
  • WhatsApp Send: confirma suscripción o agenda una demo.

Conectores útiles: Set, Code, HTTP Request, Google Sheets/CRM

  • Set/Code para limpiar datos.
  • HTTP Request para APIs externas (proveedores o servicios).
  • Rate Limit para no saturar.
  • Wait para secuencias (p. ej., nudge 24 h después si procede).

En mi día a día, una simple hoja de cálculo con estado de conversación por número me ha ahorrado soporte: veo quién quedó en “pendiente” y re-enganchamos con plantilla aprobada.

8) Buenas prácticas y cumplimiento para no perder el número

  • Consentimiento y valor: envía mensajes que el usuario espera y considera útiles.
  • Frecuencia: evita ráfagas; aplica Rate Limit en n8n.
  • Ventana de 24 h: si el usuario no habló en 24 h, usa plantillas aprobadas.
  • Opt-out claro: permite darse de baja con una palabra clave.
  • Logs y auditoría: guarda quién envió qué y cuándo.
  • Seguridad: tokens en Credentials, no en nodos sueltos; rota periódicamente.

Políticas clave: plantillas, opt-in/opt-out, ventana de 24 h

  • Define tu flujo de consentimiento (web, tienda, formulario).
  • Documenta qué plantilla se usa y en qué evento.
  • Mantén un diccionario de variables para no romper plantillas.

Yo aprendí que un pequeño mensaje de bienvenida que explique qué tipo de avisos recibirán reduce quejas y mejora respuestas.

9) Solución de problemas comunes (tokens, plantillas, errores 4xx/5xx)

  • 401/403: token inválido/expirado → renueva y vuelve a probar con un Manual Trigger.
  • 400 (Bad Request): plantilla o variables mal mapeadas → revisa components y placeholders.
  • 404: Phone Number ID errado o ruta incorrecta → confirma IDs en Meta/credenciales.
  • Fallos intermitentes (device-based): implementa retry con backoff y notifica por Slack/Email.
  • No llegan webhooks: revisa firewall/túnel (si usas ngrok), Verify Token y challenge inicial.

Checklist de diagnóstico y logs en n8n

  • Activa Always Output Data donde tenga sentido.
  • Añade Error Trigger global para capturar fallos.
  • Versiona workflows (n8n >1.0 permite mejor control).
  • Exporta ejecuciones críticas a un data store.

Conclusión

Conectar WhatsApp a n8n es más una decisión de ruta que un reto técnico. Si buscas robustez y cumplimiento, ve por Cloud API (directa o a través de Twilio/360dialog). Si necesitas probar algo mañana, Evolution API te saca del apuro, pero trátalo como puente y respeta políticas. En mi experiencia, empezar rápido con device-based y migrar a oficial cuando el caso ya “funciona” ha equilibrado velocidad y fiabilidad.

FAQs

¿Puedo enviar mensajes sin que el usuario hable primero?
Sí, pero fuera de la ventana de 24 h necesitas plantillas aprobadas.

¿Puedo usar solo HTTP Request en n8n sin el nodo oficial?
Sí. Mientras proveas el Access Token y llames a los endpoints adecuados, funciona. El nodo oficial te simplifica el mapeo.

¿Qué pasa si mi token caduca?
Obtendrás 401/403. Automatiza la renovación y guarda el token en Credentials.

¿Twilio o 360dialog valen la pena?
Si tu equipo no técnico operará el canal, el panel y soporte del proveedor suelen compensar el coste adicional.

¿Evolution API es “malo”?
No. Es útil para POCs y ciertos casos. Solo sé estricto con consentimiento, frecuencia y calidad del contenido, y entiende sus límites técnicos.