Con esta guía aprenderás a conectar una API no oficial de WhatsApp a n8n usando WinN8N en Windows.
Es una opción útil para experimentar y aprender automatización, pero no es una integración oficial y conlleva riesgos importantes.
⚠️ Advertencia importante
Advertencia: Este tutorial es únicamente con fines educativos.
WhatsApp no aprueba el uso de herramientas no oficiales como esta.
El uso indebido puede conllevar al bloqueo definitivo de tu cuenta.
Úsalo bajo tu propia responsabilidad y nunca para spam o actividades cuestionables.
Autor: DevIt Bash
Fecha de publicación: 14 de mayo de 2025
🎥 Tutorial en video
A continuación tienes el video completo donde se muestra el proceso paso a paso:
🖥️ ¿Qué es WinN8N?
WinN8N es una herramienta desarrollada para facilitar el uso de n8n en entornos Windows, evitando instalaciones complejas.
En lugar de pelear con Node.js, Docker o configuraciones de servidor, con unos pocos clics puedes tener un entorno de automatización funcional listo para usar en tu PC.
🔌 Pasos para conectar WhatsApp no oficial
-
Abrir WinN8N
Haz clic en Iniciar y espera a que cargue el editor de flujos de n8n en tu navegador. -
Crear o abrir un flujo
Desde el editor de n8n, crea un nuevo flujo o abre uno existente donde quieras recibir los mensajes de WhatsApp. -
Ir a Extras → WhatsApp → API no oficial
Dentro de WinN8N:- Haz clic en Instalar y espera unos segundos a que termine.
- Deja los valores por defecto (a menos que sepas exactamente qué estás cambiando).
- Presiona Lanzar servidor.
- Luego haz clic en Obtener QR.
-
Escanear el código QR
Usa tu dispositivo móvil para escanear el QR generado.
Hazlo rápido: el QR suele expirar en 30–40 segundos, igual que en WhatsApp Web.
Si el escaneo fue exitoso, tu sesión de WhatsApp quedará enlazada con el servidor de la API no oficial.
🌐 Configuración del Webhook en n8n
Ahora necesitas que la API de WhatsApp envíe los mensajes entrantes a un flujo de n8n.
-
Agrega un nodo Webhook como primer nodo del flujo.
-
En las propiedades del nodo:
- Crea una nueva credencial.
- En el nombre superior de la credencial, puedes llamarla por ejemplo:
unofficial. - En el campo Name coloca:
x-app-key - En el campo Value coloca: la API Key configurada en WinN8N
(por defecto es la que WinN8N muestra en pantalla al lanzar el servidor).
-
Guarda la credencial y copia la URL del webhook que n8n genera
(basta con hacer clic sobre la URL para copiarla al portapapeles).
Esta URL será la que uses en WinN8N para que la API de WhatsApp envíe los eventos a tu flujo.
🔗 Enlazar el Webhook con WhatsApp (desde WinN8N)
- Regresa a WinN8N y detén el servicio de WhatsApp no oficial si está corriendo.
- En el campo correspondiente a la URL del webhook, pega la URL que copiaste desde n8n.
- Aún no inicies el servidor otra vez; primero haremos una prueba controlada.
✅ Prueba de conexión
- En el nodo Webhook de n8n, haz clic en Listen for test event
(o equivalente, según la versión de n8n). - Ahora sí, vuelve a WinN8N y haz clic en Iniciar para levantar de nuevo el servidor de WhatsApp.
- Espera unos segundos.
Si todo está bien configurado, n8n debería recibir un evento de prueba y mostrar el mensajeready.
A partir de aquí, cada mensaje que llegue al número de WhatsApp enlazado debería llegar a tu flujo de n8n a través del Webhook.
🧭 Uso responsable y siguientes pasos
- No uses esta integración para spam, envíos masivos ni actividades dudosas.
- Recuerda que se trata de una API no oficial, con riesgo de bloqueo de cuenta.
- Si vas a trabajar con clientes o en producción, considera migrar a la API oficial de WhatsApp Business u otros canales de comunicación soportados.
Mientras tanto, este laboratorio con WinN8N + n8n es una forma práctica de entender cómo funciona la automatización de mensajes y webhooks usando tu propio equipo con Windows.