Si quieres enviar y recibir mensajes de WhatsApp desde una automatización como n8n pero no puedes (o no quieres) usar la API oficial de WhatsApp Business, pronto te toparás con las API «no oficiales» de WhatsApp. Son pasarelas que se conectan a WhatsApp igual que lo hace WhatsApp Web y exponen una API HTTP sencilla que puedes invocar desde n8n. Esta guía cubre las ocho opciones más populares de principio a fin: qué es cada una, cómo configurarla, el endpoint y el cuerpo exactos para enviar un mensaje, una comparación lado a lado, y, sobre todo, las contrapartidas que debes entender antes de construir nada.
Qué significa «no oficial» en realidad
El acceso oficial a WhatsApp para empresas pasa por la API de WhatsApp Business de Meta (la Cloud API), que exige verificación de empresa, usa plantillas de mensaje preaprobadas y cobra por conversación. Las API no oficiales se saltan todo eso: ejecutan una sesión de WhatsApp Web para un número normal (muchas se basan en la biblioteca de código abierto Baileys o en un navegador sin interfaz) y la envuelven en una API REST.
Esa comodidad viene con una advertencia real. Automatizar así un número personal no está sancionado por Meta y puede violar los Términos de Servicio de WhatsApp. Los números pueden ser limitados o baneados, sobre todo cuando se usan para enviar mensajes masivos no solicitados a gente que nunca dio su consentimiento. Considera las API no oficiales lo mejor para proyectos personales, herramientas internas, notificaciones y chat bidireccional con personas que esperan saber de ti. Para difusión conforme y a gran escala, la API oficial mediante un proveedor como Wati es la ruta correcta. Y si cumples los requisitos de la API oficial pero prefieres no autoalojar nada, herramientas totalmente alojadas como Zapier o Make conectan WhatsApp por la Cloud API oficial sin ningún servidor que gestionar. Consulta nuestra guía de automatización para el panorama completo.
La receta que siguen todas las pasarelas
Cuando has visto una de estas API, esencialmente las has visto todas. Las diferencias están en el alojamiento, el precio y los detalles del cuerpo de la petición, el flujo es idéntico:
- Vincula un número. Creas una «instancia», «sesión» o «canal» para un número de WhatsApp dedicado y escaneas un código QR desde WhatsApp → Dispositivos vinculados, exactamente como si iniciaras sesión en WhatsApp Web.
- Consigue una credencial. El proveedor te da una clave de API o token que autentica cada petición.
- Envía por HTTP. En n8n, un nodo HTTP Request hace POST al endpoint de envío del proveedor con el destinatario y el texto. (Evolution API y Wassenger también ofrecen nodos dedicados de n8n si prefieres no montar las peticiones a mano.)
- Recibe por webhook. Apuntas el webhook del proveedor a un nodo Webhook de n8n, de modo que cada mensaje entrante dispara un flujo, la base de los autorespondedores y chatbots.
Los números de los destinatarios van siempre en formato internacional completo, solo dígitos, el mismo formato que usa un enlace click-to-chat. Algunos proveedores envuelven el número en un ID de chat como 15551234567@c.us (individual) o @g.us (grupo); las secciones por proveedor indican cuáles.
Pasarelas autoalojadas: Evolution API, WAHA, WPPConnect
Las pasarelas autoalojadas corren en tu propio servidor (con Docker es cosa de un comando en cualquier VPS barato). No pagas nada por mensaje ni suscripción (solo tu servidor) y tus datos de mensajería nunca pasan por un tercero, algo que importa si manejas listas de contactos sensibles. El precio es que las operas tú: actualizaciones, copias de seguridad y algún re-escaneo cuando una sesión se cae.
Evolution API, el mayor ecosistema de n8n
Evolution API es una pasarela gratuita y de código abierto, y la elección más popular entre los equipos técnicos. Envuelve Baileys para el protocolo de WhatsApp Web (y también puede actuar de fachada de la Cloud API oficial), admite varias instancias (cada una ligada a un número) y tiene tanto un nodo comunitario dedicado (n8n-nodes-evolution-api) como un gran ecosistema de plantillas de n8n listas para usar.
Configuración: arranca el contenedor Docker con una clave de API global (por ejemplo, la variable de entorno AUTHENTICATION_API_KEY, el docker-compose del proyecto muestra los nombres actuales), crea una instancia vía API o desde la interfaz del manager, y pide el código QR de la instancia y escanéalo. La documentación Swagger se sirve en el mismo puerto para explorar los endpoints.
- Endpoint de envío: POST https://tu-servidor/message/sendText/tu-instancia
- Autenticación: apikey: tu-clave-de-api (cabecera)
- Cuerpo (JSON): { "number": "15551234567", "text": "Hola desde n8n + Evolution API" }
WAHA, un contenedor, varios motores, buen manejo de multimedia
WAHA (WhatsApp HTTP API) corre como una única imagen Docker y organiza las conexiones en sesiones (la predeterminada se llama literalmente “default”). Su rasgo distintivo es la elección de motores, un motor WEBJS basado en navegador y motores NOWEB/GOWS más ligeros basados en websockets, para equilibrar consumo de recursos y funciones. El núcleo es gratuito para autoalojar; el WAHA Plus de pago desbloquea capacidades avanzadas. Es especialmente sólido con multimedia (imágenes, archivos, notas de voz), lo que encaja con chatbots más ricos.
Configuración: ejecuta la imagen (la API en el puerto 3000 por defecto, con documentación Swagger interactiva), inicia una sesión, obtén su código QR y escanéalo. Cuando el estado de la sesión sea “working”, ya puedes enviar. Si proteges la instancia con una clave de API, pásala en la cabecera que espera WAHA (por ejemplo, X-Api-Key).
- Endpoint de envío: POST http://tu-host-waha:3000/api/sendText
- Cuerpo (JSON): { "session": "default", "chatId": "[email protected]", "text": "Hola desde n8n + WAHA" }
- Nota: el sufijo del chatId es @c.us para individuos y @g.us para grupos.
WPPConnect, código abierto con token por sesión
WPPConnect Server es el hermano comunitario de los otros dos: gratuito, de código abierto y autoalojado, habitualmente en el puerto 21465 con documentación Swagger. Su modelo de autenticación es un poco distinto: defines una SECRET_KEY en el servidor, llamas al endpoint de generación de tokens para acuñar un token Bearer para una sesión con nombre, inicias la sesión y escaneas su QR. Expone endpoints para multimedia, archivos, botones y grupos además de texto plano.
- Endpoint de envío: POST http://tu-servidor:21465/api/tu-sesion/send-message
- Autenticación: Authorization: Bearer tu-token-de-sesion
- Cuerpo (JSON): { "phone": "14155550100", "message": "Hola desde n8n + WPPConnect" }
Pasarelas cloud: Green API, UltraMsg, Wassenger, Whapi.cloud, Maytapi
Las pasarelas cloud lo alojan todo por ti: te registras, vinculas un número por QR y empiezas a llamar a una API, a menudo en menos de diez minutos, sin nada que mantener. A cambio pagas una suscripción y tu tráfico pasa por los servidores del proveedor. Las cinco de abajo siguen el mismo patrón y se diferencian sobre todo en precio, acabado y una o dos funciones destacadas.
Green API, el arranque más rápido, nivel gratuito para desarrolladores
Green API da a cada instancia dos valores (un idInstance y un apiTokenInstance) que van incrustados directamente en la URL de la petición, así que no hay cabeceras que configurar. Tiene un nivel gratuito para pruebas, documentación clara y permite mensajes de texto muy largos. Los mensajes entrantes llegan por webhook o consultando su cola de notificaciones con ReceiveNotification; con n8n, los webhooks son la opción más limpia.
- Endpoint de envío: POST https://api.green-api.com/waInstance{idInstance}/sendMessage/{apiTokenInstance}
- Cuerpo (JSON): { "chatId": "[email protected]", "message": "Hola desde n8n + Green API" }
UltraMsg, la opción más simple y barata
UltraMsg es el minimalista del grupo: obtienes un ID de instancia (tipo instance12345) y un token, y envías mensajes con una única petición form-encoded, sin JSON, sin nodo especial. Una respuesta correcta es algo como { "sent": "true", "message": "ok", "id": 497 }. Es una elección pragmática para notificaciones sencillas y chatbots pequeños donde el coste y el tiempo de configuración importan más.
- Endpoint de envío: POST https://api.ultramsg.com/instance12345/messages/chat
- Cuerpo (Form-Urlencoded): token = tu-token, to = 15551234567, body = Hola desde n8n + UltraMsg
Wassenger, funciones de empresa y nodo nativo de n8n
Wassenger apunta a usuarios de empresa: añade una bandeja de entrada compartida sobre la API y, cosa notable, incluye una integración nativa con n8n, así que puedes soltar un nodo Wassenger en lugar de configurar peticiones HTTP. Conectas un dispositivo por QR, creas una clave de API y la pasas en una cabecera Token. Además de texto puede enviar multimedia, documentos, ubicaciones, encuestas y botones, y escribir a grupos.
- Endpoint de envío: POST https://api.wassenger.com/v1/messages
- Autenticación: Token: tu-clave-de-api (cabecera)
- Cuerpo (JSON): { "phone": "+14155550100", "message": "Hola desde n8n + Wassenger" }
Whapi.cloud, REST limpio con tokens por canal
Whapi.cloud trata cada número conectado como un «canal» con su propio token Bearer, un modelo ordenado si gestionas varios números para fines distintos. Los endpoints REST son limpios y están bien documentados, hay un nivel gratuito para prototipos, y el campo to acepta IDs de grupos y canales además de números individuales (solo dígitos, sin signo más).
- Endpoint de envío: POST https://gate.whapi.cloud/messages/text
- Autenticación: Authorization: Bearer tu-token-de-canal
- Cuerpo (JSON): { "to": "14155550100", "body": "Hola desde n8n + Whapi.cloud" }
Maytapi, pensada para gestionar varios números
El rasgo estrella de Maytapi es el soporte multiteléfono: una cuenta (un «producto») puede contener varias instancias de teléfono, cada una direccionada por su propio ID de teléfono en la URL. Te autenticas con un token en una cabecera x-maytapi-key, y el mismo endpoint envía multimedia, ubicaciones y contactos cambiando el campo type. Los webhooks se configuran una vez por producto.
- Endpoint de envío: POST https://api.maytapi.com/api/tu-product-id/tu-phone-id/sendMessage
- Autenticación: x-maytapi-key: tu-token (cabecera)
- Cuerpo (JSON): { "to_number": "14155550100", "type": "text", "message": "Hola desde n8n + Maytapi" }
Tabla comparativa
Las ocho, lado a lado. «Autoalojada» significa que la ejecutas tú (normalmente con Docker) y pagas solo tu servidor; «cloud» significa que la aloja el proveedor y le pagas a él. No citamos precios fijos, comprueba siempre la tarifa vigente del proveedor.
| Proveedor | Alojamiento | n8n | Modelo de coste | Destaca por |
|---|---|---|---|---|
| Evolution API | Autoalojada (Docker) | Nodo comunitario + HTTP | Gratis autoalojada | El mayor ecosistema n8n; envuelve Baileys |
| WAHA | Autoalojada (Docker) | HTTP | Núcleo gratis + Plus de pago | Varios motores, buen multimedia |
| WPPConnect | Autoalojada (Docker) | HTTP | Gratis autoalojada | Código abierto, control total de datos |
| Green API | Cloud | HTTP | Nivel gratis + pago | Arranque rápido, buena documentación |
| UltraMsg | Cloud | HTTP | Pago de bajo coste | La configuración más simple |
| Wassenger | Cloud | Nodo nativo + HTTP | De pago | Bandeja de equipo, nodo nativo n8n |
| Whapi.cloud | Cloud | HTTP | Nivel gratis + pago | REST limpio, tokens por canal |
| Maytapi | Cloud | HTTP | De pago | Soporte multiteléfono |
Chuleta de endpoints
Para consultar rápido mientras configuras el nodo HTTP Request de n8n, la llamada de envío de texto de cada proveedor, condensada:
| Proveedor | Endpoint de envío (POST) | Autenticación | Campo del destinatario |
|---|---|---|---|
| Evolution API | /message/sendText/{instancia} | cabecera apikey | number (solo dígitos) |
| WAHA | /api/sendText | cabecera X-Api-Key (si está activada) | chatId (…@c.us) |
| WPPConnect | /api/{sesion}/send-message | token Bearer | phone (solo dígitos) |
| Green API | /waInstance{id}/sendMessage/{token} | en la URL | chatId (…@c.us) |
| UltraMsg | /{instancia}/messages/chat | campo token del formulario | to (solo dígitos) |
| Wassenger | /v1/messages | cabecera Token | phone (con prefijo +) |
| Whapi.cloud | /messages/text | token Bearer | to (solo dígitos) |
| Maytapi | /api/{producto}/{telefono}/sendMessage | cabecera x-maytapi-key | to_number (solo dígitos) |
¿Cuál deberías elegir?
- ¿Quieres control total y cero coste por mensaje, y puedes operar un servidor? Autoaloja Evolution API, WAHA o WPPConnect.
- ¿Quieres cero infraestructura y el arranque más rápido? Usa una pasarela cloud, Green API, UltraMsg, Whapi.cloud, Wassenger o Maytapi.
- ¿Quieres un nodo n8n de primera en lugar de HTTP a pelo? Evolution API (nodo comunitario) o Wassenger (integración nativa).
- ¿Necesitas gestionar varios números de WhatsApp? Maytapi está hecha para eso.
- ¿Necesitas el mayor ecosistema de plantillas y comunidad n8n? Evolution API.
- ¿Necesitas mensajería conforme y con consentimiento a escala real? Da el salto a la API oficial con Wati en lugar de una pasarela no oficial.
Recibir mensajes y construir un chatbot
Enviar es solo la mitad de la historia. Todos los proveedores de arriba pueden entregar los mensajes entrantes a una URL que tú elijas, apunta ese webhook a un nodo Webhook de n8n y cada mensaje de WhatsApp entrante se convierte en el disparador de un flujo. El patrón bidireccional clásico es: mensaje entrante → buscar al remitente en tus datos (una hoja, un CRM, una base de datos) → opcionalmente ejecutar un paso de IA que redacte una respuesta → devolver la respuesta por el mismo endpoint de envío. Eso es un autorespondedor o chatbot completo, construido íntegramente con nodos de n8n. Construcciones habituales: un contestador de preguntas frecuentes que deriva a un humano cuando duda, notificaciones de pedidos o citas disparadas desde una hoja de cálculo, y asistentes de IA que incluso transcriben notas de voz entrantes (el manejo de multimedia de WAHA es especialmente bueno para eso).
Mantente a salvo elijas la que elijas
- Usa un número dedicado que estés dispuesto a perder, no tu línea personal principal.
- Caliéntalo, empieza despacio y escribe solo a gente que te espera.
- Nunca dispares en frío mensajes masivos no solicitados; es la vía más rápida al baneo.
- Respeta las bajas, mantén volúmenes razonables y añade retrasos con aspecto humano entre mensajes.
Preguntas frecuentes
¿Son legales las API no oficiales de WhatsApp?
Se usan mucho, pero automatizar así un número personal de WhatsApp puede incumplir los Términos de Servicio de WhatsApp, y Meta puede banear números, sobre todo por mensajería masiva no solicitada. Úsalas para proyectos personales y chat bidireccional con consentimiento, y usa la API oficial para el marketing a gran escala.
¿Necesito programar para usarlas con n8n?
En realidad no. En n8n puedes llamar a cualquiera de ellas con el nodo HTTP Request, y Evolution API y Wassenger tienen incluso nodos dedicados. Configuras el endpoint y el token, sin programación tradicional.
¿Cuál es mejor para principiantes?
Si no quieres operar un servidor, una opción cloud como Green API o UltraMsg es la más rápida. Si te manejas con Docker y quieres cero coste por mensaje, Evolution API o WAHA te dan más control.
¿Qué es el formato de ID de chat @c.us que usan algunos proveedores?
Es el número del destinatario en formato internacional completo (solo dígitos) seguido de @c.us para un chat individual, p. ej. [email protected], o @g.us para un grupo. Lo usan WAHA y Green API; el resto acepta un campo de número a secas.
¿Las opciones autoalojadas son gratis de verdad?
Sí, Evolution API y WPPConnect son de código abierto y gratuitas para autoalojar, y WAHA tiene un núcleo gratuito (más un nivel Plus de pago). Tus únicos costes son el servidor donde corren y, si usas uno, un plan de n8n. No hay tarifas por mensaje porque usan una sesión de WhatsApp Web en lugar de la API oficial de pago.
¿Pueden hacer que baneen mi número?
Cualquiera de ellas puede, si envías mensajes masivos no solicitados, no importa la pasarela, importa el comportamiento. Usa un número dedicado, escribe solo a quien te espera, mantén volúmenes modestos y plantéate la API oficial para las campañas grandes.
