Qué es Evolution API y cómo automatizar WhatsApp con n8n (2026)

Si has llegado hasta aquí buscando qué es Evolution API, la respuesta corta es esta: una herramienta gratuita y de código abierto que convierte tu WhatsApp en una API, para que puedas enviar y recibir mensajes desde tus propios sistemas sin pasar por el proceso de aprobación de Meta.

La respuesta larga es lo que viene a continuación: qué hace exactamente, en qué se diferencia de la API oficial de WhatsApp Business, dónde se instala, qué se puede automatizar cuando la conectas con n8n y qué precauciones conviene tomar antes de ponerla en producción.

Qué es Evolution API, explicado sin tecnicismos

WhatsApp no fue pensado para que un programa hablara por ti. Si quieres que tu tienda avise de un pedido o que tu CRM conteste una duda, necesitas una capa que traduzca entre tu software y WhatsApp. Eso es exactamente Evolution API.

Es un proyecto de código abierto que instalas en tu propio servidor. Al arrancarlo levanta un servicio con endpoints HTTP, y vinculas tu número escaneando un QR desde el móvil, como cuando abres WhatsApp Web. Desde ese momento tu número queda conectado, y cualquier aplicación que hable HTTP puede pedirle a Evolution API que envíe un mensaje, o recibir un aviso cada vez que alguien te escribe.

Lo que consigues con esto:

• Enviar mensajes de texto, imágenes, audios, documentos, ubicaciones y botones.
• Recibir mensajes en tiempo real mediante webhooks, para que tu sistema reaccione al instante.
• Gestionar grupos: crearlos, añadir participantes, enviar avisos a un grupo entero.
• Gestionar varias cuentas (instancias) de WhatsApp desde un mismo servicio.
• Integrarla con n8n, Chatwoot, Typebot o modelos de IA como los de OpenAI y Anthropic.

Evolution API frente a la API oficial de WhatsApp Business

Esta es la comparación que más se busca, y la que decide el proyecto. La API oficial de Meta (WhatsApp Cloud API) es la vía homologada; Evolution API es la vía rápida y sin coste por mensaje. Cada una tiene su sitio:

Conviene decirlo claro antes de seguir: Evolution API funciona sobre WhatsApp Web y no es un producto oficial de Meta. Si la usas para enviar mensajes masivos no solicitados, lo más probable es que acabes con el número bloqueado. Donde brilla es en la conversación legítima: responder a quien te escribe, avisar a clientes que te han dado su consentimiento y automatizar procesos internos. Con ese uso, es una herramienta excelente.

Dónde se instala: Docker, VPS y EasyPanel

Evolution API es autoalojada, así que necesitas un servidor donde vivir. No hace falta nada grande: un VPS modesto sobra para empezar.

Las tres formas habituales de ponerla en marcha:

• Docker en tu VPS. La opción más común. Levantas el contenedor, defines la clave de API y ya tienes el servicio escuchando.
• EasyPanel. Si prefieres no pelearte con la terminal, este panel te permite desplegarla desde plantilla y gestionar el dominio y el certificado desde la interfaz. Es como nosotros la desplegamos en la mayoría de proyectos.
• Servidor gestionado. Si no quieres mantener infraestructura, lo habitual es que quien te implanta el proyecto se encargue también del alojamiento y las actualizaciones.

Un par de cosas que conviene dejar bien atadas desde el principio: pon la instancia detrás de HTTPS con su dominio, protege el acceso con una clave de API robusta y haz copia de seguridad del volumen donde guarda la sesión. Si pierdes esa sesión, toca volver a escanear el QR.

Cómo conectar Evolution API con n8n

n8n es la pieza que convierte a Evolution API en algo verdaderamente útil. Por sí sola, Evolution API solo envía y recibe; n8n es quien decide qué responder, cuándo y con qué datos. La conexión funciona en dos direcciones:

De WhatsApp hacia n8n (recibir). Configuras en Evolution API un webhook que apunte a un nodo Webhook de n8n. Cada vez que alguien te escribe, Evolution API lanza la petición y tu flujo arranca con el mensaje, el número y el contenido.

De n8n hacia WhatsApp (enviar). Usas un nodo HTTP Request contra el endpoint de envío de Evolution API, con tu clave en la cabecera y el número y el texto en el cuerpo. Ese mismo nodo sirve para mandar imágenes, PDFs o audios.

Con esas dos piezas, un flujo típico de atención automática queda así:

El paso 6 es el que marca la diferencia entre un experimento y algo que puedes poner delante de tus clientes: la IA atiende sola, pero siempre queda registro y siempre hay una salida hacia una persona.

Qué se puede automatizar de verdad

Estos son los usos que más nos piden y que mejor funcionan en proyectos reales:

Comercio y tiendas

• Estado del pedido sin que nadie pregunte: confirmación, salida del almacén y entrega, automáticos.
• Recuperación de carritos con un mensaje a quien dejó la compra a medias y aceptó recibir avisos.
• Postventa: dudas frecuentes resueltas al momento y derivación a una persona cuando toca.

Citas y servicios

• Recordatorios de cita con confirmación o cambio de hora en el propio chat. Es lo que más reduce las ausencias.
• Reprogramación automática: si alguien cancela, el hueco se ofrece a la lista de espera.
• Encuestas de satisfacción tras el servicio, con la respuesta guardada en tu base de datos.

Procesos internos

• Avisos al equipo por grupo de WhatsApp cuando entra una incidencia o un pedido grande.
• Partes de trabajo: el técnico envía datos o fotos por WhatsApp y el sistema genera el informe.
• Alertas de sistema: si algo falla en tu ERP o en un servidor, te enteras al momento.

Problemas habituales (y por qué ocurren)

Si buscaste "evolution api no funciona", casi seguro es una de estas cuatro:

• La sesión se cae y pide QR otra vez. Suele pasar cuando el contenedor se reinicia sin volumen persistente. Monta el volumen de datos y deja de ocurrir.
• El webhook no llega a n8n. Revisa que la URL sea accesible desde fuera y que uses HTTPS. Si n8n está en la misma red interna, comprueba que Evolution API pueda resolver esa dirección.
• Error 401 al enviar. La clave de API no viaja en la cabecera o no coincide con la del servidor.
• El número deja de enviar. Señal de que WhatsApp ha limitado la cuenta por volumen o por mensajes no solicitados. Baja el ritmo y revisa a quién estás escribiendo.

Seguridad, datos y RGPD

Que la herramienta sea gratuita no te libra de las obligaciones. Cuatro puntos que revisamos siempre antes de poner una instancia en producción:

• Consentimiento. Escribir a alguien que no te ha dado permiso es problema legal y vía rápida al bloqueo.
• Los datos son tuyos. Al ser autoalojada, las conversaciones pasan por tu servidor: cífralo, haz copias y limita quién accede.
• Acceso controlado. Clave de API fuerte, HTTPS obligatorio y la instancia nunca expuesta sin protección.
• Registro y supervisión. Guarda las conversaciones que gestiona la IA y ten a alguien revisando lo que se responde en tu nombre.

Preguntas frecuentes sobre Evolution API

¿Evolution API es gratis?

El software es gratuito y de código abierto, y no cobra por mensaje enviado. Lo único que pagas es el servidor donde la alojas, que para un uso normal cuesta unos pocos euros al mes. Es la diferencia principal frente a la API oficial, que factura por conversación.

¿Necesito la API oficial de Meta o una cuenta de WhatsApp Business?

No. Evolution API se conecta escaneando un QR con la aplicación de WhatsApp, igual que WhatsApp Web, así que no necesitas cuenta en Meta Business, verificación de empresa ni plantillas aprobadas. Funciona con un número de WhatsApp normal o de WhatsApp Business.

¿Es legal usar Evolution API?

La herramienta en sí es un proyecto de código abierto, pero no es un producto oficial de Meta y funciona sobre WhatsApp Web, por lo que su uso queda fuera de la API homologada. En la práctica el riesgo no es legal sino operativo: si envías mensajes masivos no solicitados, WhatsApp puede bloquear el número. Usada para conversaciones legítimas y con consentimiento, es una opción perfectamente razonable para una pyme.

¿Cómo se conecta Evolution API con n8n?

En dos direcciones. Para recibir, configuras en Evolution API un webhook que apunte a un nodo Webhook de n8n, de modo que cada mensaje entrante dispare tu flujo. Para enviar, usas un nodo HTTP Request contra el endpoint de envío de Evolution API, pasando la clave de API en la cabecera. Con esas dos piezas ya puedes montar respuestas automáticas, avisos y agentes de IA.

¿Dónde puedo instalar Evolution API?

En cualquier servidor propio. Lo más habitual es Docker sobre un VPS, o desplegarla con EasyPanel si prefieres gestionarlo desde un panel en vez de la terminal. Necesita poco: un VPS básico aguanta perfectamente el uso de una pyme, siempre con HTTPS y con el volumen de datos persistente para no perder la sesión.

¿Puedo enviar campañas masivas con Evolution API?

Técnicamente sí, pero es la forma más rápida de que te bloqueen el número. WhatsApp detecta los envíos masivos a contactos que no han interactuado contigo. Si tu objetivo son campañas de difusión a gran escala, lo correcto es la API oficial de Meta. Evolution API está para conversar, no para hacer spam.

Conclusión

Evolution API resuelve el problema que tienen la mayoría de pymes: querer automatizar WhatsApp sin entrar en el proceso de Meta ni pagar por cada conversación. Unida a n8n, deja de ser una API suelta y se convierte en el canal por el que tu negocio atiende, avisa y responde de forma automática.

La clave está en usarla para lo que sirve. Como canal conversacional con clientes que quieren hablar contigo, funciona muy bien y sale prácticamente gratis. Como herramienta de envío masivo, es cuestión de tiempo que el número acabe bloqueado.

Si prefieres aprender a montarlo tú mismo, en nacaIA Academy tienes el curso de automatizaciones con n8n, donde trabajamos este tipo de integraciones paso a paso. Y si quieres seguir leyendo, te dejo la ruta para aprender n8n desde cero, la guía de cómo montar un agente de IA en WhatsApp y un caso real de gestión automática de citas con recordatorios.