Evolution API WhatsApp: Alternativa Open Source para Integrar WhatsApp [2026]

Evolution API es un proyecto open source que permite conectar aplicaciones con WhatsApp sin depender de la API oficial de Meta. A diferencia de la WhatsApp Business API, que requiere verificación empresarial, aprobación de templates y pago por conversación, Evolution API funciona emulando el protocolo de WhatsApp Web para ofrecer acceso programático a las funciones de mensajería. En esta guía os explicamos qué es exactamente, cómo instalarlo paso a paso con Docker, cuándo tiene sentido frente a la API oficial y en qué escenarios resulta una opción viable para vuestro proyecto. Si buscáis una visión general del ecosistema de desarrollo sobre WhatsApp, empezad por nuestra guía de WhatsApp API para developers.

Qué Es Evolution API WhatsApp

Evolution API es una API REST de código abierto, disponible en GitHub, que proporciona una interfaz programática para interactuar con WhatsApp. Funciona como una capa intermedia que se conecta a WhatsApp Web a través del protocolo Baileys (una implementación en Node.js del protocolo de WhatsApp), exponiendo endpoints HTTP que permiten enviar mensajes de texto, imágenes, documentos, audios, ubicaciones y contactos.

El proyecto nació como una alternativa gratuita para desarrolladores y empresas que necesitaban automatizar WhatsApp sin pasar por el proceso de aprobación de Meta ni asumir los costes por conversación de la API oficial. En 2026, Evolution API ha ganado enorme tracción -- con tendencias de búsqueda que se han multiplicado por seis en el último año -- especialmente entre equipos técnicos que integran herramientas no-code como n8n para construir flujos de automatización conversacional.

La arquitectura es sencilla: un servidor Node.js que mantiene una sesión activa de WhatsApp Web, expone una REST API con autenticación por API key y permite gestionar múltiples instancias (números de teléfono) desde una sola instalación. Los webhooks notifican eventos entrantes en tiempo real, exactamente como funciona la WhatsApp Cloud API de Meta, pero sin los requisitos de verificación empresarial.

Cómo Instalar Evolution API WhatsApp con Docker Paso a Paso

La forma más habitual de desplegar Evolution API es mediante Docker, ya que simplifica la gestión de dependencias y permite levantar el entorno en minutos. Estos son los requisitos previos y el proceso completo.

Requisitos Previos

• Un servidor con Docker y Docker Compose instalados. Cualquier VPS con 1 GB de RAM y Ubuntu 22.04+ es suficiente para pruebas.
• Un número de teléfono con WhatsApp activo. Este número quedará vinculado a la sesión de Evolution API, igual que cuando abrís WhatsApp Web en un navegador.
• Acceso SSH al servidor o un entorno local con Docker Desktop.

Paso 1: Clonar el Repositorio y Configurar Variables

Descargad el repositorio oficial de Evolution API WhatsApp desde GitHub y configurad el archivo de variables de entorno. Las variables esenciales son la API key global (que protege los endpoints), la URL base del servidor, el puerto de exposición y la configuración de la base de datos (por defecto usa SQLite, pero podéis configurar PostgreSQL para producción).

Paso 2: Levantar los Contenedores

Con un solo comando de Docker Compose levantáis el servidor completo. El contenedor expone el puerto 8080 por defecto y la API queda accesible inmediatamente. En el primer arranque, Evolution API genera las tablas de la base de datos y queda listo para crear instancias.

Paso 3: Vincular WhatsApp

Una vez el servidor está corriendo, creáis una nueva instancia a través de la API y recibís un código QR. Escaneáis ese código con la aplicación de WhatsApp de vuestro móvil -- exactamente como haríais con WhatsApp Web -- y la sesión queda establecida. A partir de ese momento, podéis enviar y recibir mensajes a través de los endpoints HTTP.

El panel Evolution Manager proporciona una interfaz gráfica para gestionar instancias, ver el estado de las conexiones y monitorizar webhooks sin necesidad de usar la línea de comandos. Es especialmente útil si gestionáis varios números de teléfono desde la misma instalación.

Evolution API vs WhatsApp Business API Oficial: Diferencias Clave

Antes de elegir entre Evolution API y la API oficial de Meta, necesitáis entender las implicaciones técnicas, legales y operativas de cada opción. No es solo una cuestión de coste.

El punto crítico: Evolution API opera sobre el protocolo no oficial de WhatsApp Web. Esto significa que Meta puede cambiar el protocolo en cualquier momento, provocando interrupciones del servicio hasta que la comunidad actualice la librería Baileys. Además, el uso de APIs no oficiales viola los términos de servicio de WhatsApp, lo que implica riesgo de baneo del número. Si la diferencia entre la app y la API oficial aún no os queda clara, tenemos una comparativa detallada de WhatsApp Business vs API.

Para proyectos personales, prototipos rápidos o integraciones internas de bajo volumen, Evolution API es una herramienta potente y gratuita. Para atención al cliente en producción, envíos masivos o cualquier caso donde la continuidad del servicio sea crítica, la WhatsApp Business API oficial sigue siendo la opción responsable.

Casos de Uso y Ejemplos Prácticos

Evolution API brilla en escenarios donde la velocidad de prototipado y el coste cero son prioritarios frente a la estabilidad a largo plazo. Estos son los casos más habituales.

Automatización con n8n

La combinación n8n + Evolution API WhatsApp es una de las integraciones más populares en la comunidad. n8n es una plataforma no-code de automatización de workflows que se conecta directamente con Evolution API a través de su nodo nativo. Podéis construir flujos que reciban mensajes de WhatsApp, consulten una base de datos, llamen a una API externa y respondan automáticamente -- sin escribir una línea de código.

Chatbots con Typebot

Typebot permite diseñar flujos conversacionales visuales que se ejecutan directamente sobre Evolution API. Es una opción popular para crear chatbots de cualificación de leads, encuestas automatizadas o menús interactivos de atención al cliente. La integración se configura apuntando los webhooks de Typebot a la instancia de Evolution API.

Notificaciones Internas

Para equipos que necesitan recibir alertas de sistemas internos (monitoring, deploys, errores de producción) directamente en un grupo de WhatsApp, Evolution API es una solución rápida. Un simple POST al endpoint de envío de mensajes desde vuestro pipeline de CI/CD o sistema de alertas y el equipo recibe la notificación al instante.

CRM y Soporte con Chatwoot

Chatwoot es una plataforma open source de atención al cliente que se integra nativamente con Evolution API. Esto permite crear una bandeja de entrada compartida donde varios agentes gestionan conversaciones de WhatsApp simultáneamente. Si necesitáis una solución multiagente para atención al cliente por WhatsApp, consultad nuestra guía de WhatsApp multiagente.

Integración con PHP

Si vuestro stack técnico se basa en PHP (WordPress, Laravel, custom), Evolution API expone endpoints HTTP estándar que podéis consumir desde cualquier lenguaje. Para integraciones más directas con la API oficial usando PHP, tenemos un tutorial de WhatsApp API con PHP.

Preguntas Frecuentes

¿Qué es la Evolution API?

Evolution API es una API REST de código abierto que permite enviar y recibir mensajes de WhatsApp sin usar la API oficial de Meta. Funciona emulando el protocolo de WhatsApp Web a través de la librería Baileys y se despliega habitualmente con Docker. Es gratuita, pero opera fuera de los términos de servicio oficiales de WhatsApp.

¿Cuánto se paga por la API de WhatsApp?

La API oficial de Meta cobra por conversación: entre 0,03 y 0,15 euros dependiendo de la categoría (utilidad, marketing, autenticación o servicio) y del país. Además, si usáis un BSP como proveedor, añadid su tarifa mensual. Evolution API, en cambio, es completamente gratuita como software, aunque necesitáis un servidor para alojarla. Para un desglose completo de costes, consultad nuestra guía de precios de WhatsApp API.

¿Cuál es la mejor API para WhatsApp?

Depende del contexto. Para producción empresarial con garantía de estabilidad, soporte oficial y cumplimiento normativo, la WhatsApp Cloud API de Meta es la referencia. Para prototipos, proyectos personales o integraciones internas donde el riesgo de baneo es asumible, Evolution API ofrece una alternativa potente y sin coste. Si queréis entender qué es exactamente la API oficial, tenemos una explicación completa de qué es WhatsApp API.

¿Cuál es la API oficial de WhatsApp?

La API oficial es la WhatsApp Business Platform de Meta, que se ofrece en dos modalidades: Cloud API (alojada en la infraestructura de Meta, la recomendada) y On-Premise (en servidores propios, en proceso de deprecación). Requiere verificación empresarial, aprobación de plantillas de mensaje y cumplimiento de las políticas de uso de Meta. Todo el detalle técnico está en nuestra guía de WhatsApp API para developers.

Cómo GuruSup Complementa Tu Estrategia en WhatsApp

Si estáis evaluando Evolution API para montar un canal de atención al cliente en WhatsApp, probablemente buscáis automatización, coste reducido y rapidez de implementación. Esos mismos objetivos los cubre GuruSup de forma profesional y con las garantías que un canal de soporte en producción exige.

Funcionalidades Clave de GuruSup

GuruSup conecta con la WhatsApp Business API oficial de Meta y despliega agentes IA capaces de resolver consultas automáticamente, sin flujos rígidos ni árboles de decisión. Los agentes entienden lenguaje natural, consultan vuestra base de conocimiento, escalan a humanos cuando es necesario y aprenden de cada interacción. Todo desde una plataforma con bandeja multiagente, analítica en tiempo real e integraciones con CRM.

A diferencia de una instalación de Evolution API que requiere mantenimiento técnico continuo, actualizaciones ante cambios de protocolo y asunción del riesgo de baneo, GuruSup opera sobre la infraestructura oficial con SLA garantizado.

Cómo Empezar con GuruSup

Configurar un agente IA en WhatsApp con GuruSup lleva minutos, no semanas. Sin servidores, sin Docker, sin gestionar webhooks manualmente. Si queréis ver cómo un agente de IA transforma la atención al cliente por WhatsApp, consultad nuestra guía de agente IA para WhatsApp.

Prueba GuruSup gratis: automatiza tu soporte al cliente con agentes IA en WhatsApp. Empieza ahora.