Evolution API se ha consolidado como el puente más estable y flexible entre n8n y WhatsApp. A diferencia de las integraciones tradicionales, te permite un control total sobre tus instancias sin las restricciones de la API oficial.
01. Configuración del Trigger (Webhook)
El punto de partida de cualquier automatización es el detector de eventos. En n8n, utilizaremos un nodo Webhook para "escuchar" los mensajes entrantes en tiempo real.
Pasos Clave:
- Crea un nodo Webhook y cámbialo a modo
POST. - Habilita la opción "Only Respond When Last Node Finishes" para evitar errores de sincronización.
- Copia la Test URL y pégala en tu manager de Evolution API bajo la opción de Webhooks globales o de instancia.
- Activa los eventos:
MESSAGES_UPSERTpara capturar textos nuevos.
02. Mapeo Inteligente de Datos
Uno de los errores más comunes al usar n8n con Evolution API es intentar acceder a datos inexistentes en la raíz. Recuerda: los datos vienen anidados en body.data.
{{ $json.body.data.message.conversation || $json.body.data.message.extendedTextMessage.text }}
Usa un nodo Set temprano en tu flujo para "limpiar" estas variables y convertirlas en algo simple como {{ $json.mensaje }} y {{ $json.remitente }}.
03. Respuesta Automática (HTTP Request)
Para responder, no usamos el nodo de Webhook, sino un HTTP Request. Este nodo enviará una señal de vuelta a Evolution API para que dispare el mensaje hacia el teléfono del cliente.
Configuración recomendada:
- Method: POST
- URL:
https://tu-dominio.com/message/sendText/TU_INSTANCIA - Headers: Agrega tu
apikeycomo Header para seguridad. - Body Parameters: Envía el
number(JID) y eltextMessage.
🚀 Pro Tip: El Retraso Humano
Para evitar que WhatsApp detecte tu bot como spam, usa la propiedad delay (retraso) en el envío. Un tiempo de entre 1500ms y 3000ms, sumado al estado "Composing" (escribiendo), hace que la interacción se sienta 100% natural.
¿Tu negocio está listo para procesar miles de chats sin intervención humana?
Instalar Evolution API es solo el 10% del camino. La verdadera diferencia está en la arquitectura reresiliente y los flujos de IA que convierten conversaciones en dinero. Deja de lidiar con servidores y enfócate en tus clientes.
Solicitar Implementación de WhatsApp de Alto VolumenDiseñamos, hosteamos y mantenemos tu infraestructura de automatización conversacional.