Evolution API: conectar WhatsApp con n8n
Lección del curso gratis de automatizaciones con n8n de Juan Pe Navarro: instalar Evolution API y conectar un número de WhatsApp a un agente de atención al cliente.
El vídeo empieza en el minuto de esta lección y sigue con el resto del curso. Ver el curso completo con su índice · Ver en YouTube
Evolution API es una herramienta gratuita y de código abierto que conecta un número de WhatsApp con n8n a través de una sesión de WhatsApp Web. Se instala en tu servidor, se crea una instancia, se escanea un código QR desde el teléfono y los mensajes llegan a un webhook de n8n. En esta lección del curso gratis de automatizaciones con n8n, publicado en enero de 2026, Juan Pe Navarro lo usa para el agente de una clínica dental.
Instalar Evolution API en tu servidor
Juan Pe lo instala igual que n8n: en el panel de su servidor (Easypanel, en el VPS del curso) añade el servicio de Evolution API desde las plantillas, que crea también las dos bases de datos que necesita. Después pega una línea de configuración en las variables de entorno; sin ella, más tarde no aparecerá el código QR. En n8n, los nodos de Evolution API se instalan gratis como paquete.
- Añade Evolution API desde las plantillas del panel.
- Pega la línea de configuración en el entorno del servicio.
- Instala en n8n el paquete de nodos de Evolution API.
Entrar en el manager y crear la instancia
Al abrir el servicio, añade «/manager» al final de la dirección para entrar en el panel. Te pedirá la clave de API que está en las variables de entorno del servicio. Dentro creas una instancia, el espacio donde vivirá un número de WhatsApp, pides el código QR y lo escaneas desde el teléfono, en Dispositivos vinculados, como harías con WhatsApp Web.
Cómo funciona y qué riesgos tiene
Juan Pe explica que WhatsApp tiene tres vías: la aplicación normal, WhatsApp Business y la API oficial de Meta. Evolution API usa las dos primeras a través de WhatsApp Web, por eso sigues viendo las conversaciones en tu teléfono. Lo ideal, dice, es la API oficial. Responder a quien te escribe dentro de las 24 horas no suele dar problemas; enviar muchos mensajes a personas nuevas puede hacer que Meta bloquee el número.
- Úsalo para responder a clientes que te escriben.
- No lo uses para enviar mensajes masivos a desconocidos.
- Para enviar mensajes de forma masiva, usa la API oficial y sus plantillas.
Conectar el número con n8n
En los ajustes de la instancia, Juan Pe activa opciones como rechazar llamadas e ignorar grupos. Después, en Events > Webhook, marca el evento de mensajes nuevos (messages upsert) y pega la URL del nodo webhook de n8n: primero la de prueba y, cuando el sistema esté listo, la de producción, que es la misma sin «/test». Envía un WhatsApp desde otro número, comprueba que el mensaje llega a n8n y continúa montando el flujo del agente.
Dudas sobre esta lección
¿Evolution API es gratis?
Sí. Evolution API es de código abierto, igual que n8n, y Juan Pe Navarro lo instala gratis en el mismo servidor donde tiene n8n. Lo que pagas es el servidor. La API oficial de WhatsApp, en cambio, cobra por ciertos mensajes enviados fuera de la ventana de 24 horas.
¿Pueden bloquear mi WhatsApp por usar Evolution API?
Puede pasar si lo usas para enviar muchos mensajes a personas que no te han escrito. Juan Pe explica que Meta lo interpreta como marketing automatizado sin pasar por su API oficial. Para contestar a clientes que te escriben, dentro de las 24 horas, el riesgo es mucho menor.
¿Qué diferencia hay entre Evolution API y la API oficial de WhatsApp?
La API oficial es la de Meta: se configura en Meta for Developers, es la vía profesional y permite enviar mensajes de plantilla, que son de pago, a contactos que no te han escrito antes. Evolution API se conecta a un número normal o de WhatsApp Business a través de WhatsApp Web. En el curso se usa por ser más rápida de montar.
¿Por qué no me aparece el código QR en Evolution API?
Según Juan Pe Navarro, casi siempre es porque falta la línea de configuración que hay que pegar al final de las variables de entorno del servicio de Evolution API en el panel del servidor. Sin esa línea, la instancia se crea pero no muestra el código QR para vincular el teléfono.
Más lecciones de este curso
- Cómo usar la API de Google Places en n8nEmpieza en el 02:59:18
- n8n MCP: un asistente que crea tus flujosEmpieza en el 06:51:55
- Qué es un agente de IA y cómo funcionaEmpieza en el 01:23:50
Lecciones relacionadas de otros cursos
- Cómo crear un chatbot de WhatsApp con inteligencia artificialLección · Curso de inteligencia artificial gratis: de ChatGPT a tus propios agentes de IA
- Plantillas de WhatsApp Business para escribir primero a un contactoLección · Cómo crear una agencia de IA paso a paso: curso gratis
- Cómo activar la memoria en Claude y traer la de ChatGPTLección · Curso de Claude gratis para principiantes
- Auditoría web con IA: cómo hacerla con ChatGPT AtlasLección · Negocios con ChatGPT: curso gratis de 3 servicios con Atlas
