Guía completa para instalar Evolution API en Docker con WhatsApp

Aprende a instalar Evolution API en Docker para automatizar WhatsApp en tu VPS. Guía paso a paso con PostgreSQL y Redis. ¡Despliega tu propia API!

19 jun 2026 • 3 min read • Q2BSTUDIO Team

Despliega WhatsApp en tu VPS con Evolution API y Docker

En el panorama actual de la comunicación empresarial, la integración de WhatsApp en procesos automatizados se ha convertido en un pilar para mejorar la eficiencia operativa y la cercanía con el cliente. Sin embargo, la API oficial de WhatsApp puede resultar costosa o restrictiva para muchos proyectos, especialmente para aquellos que buscan un control total sobre sus datos y una personalización sin límites. Ahí es donde entra en juego Evolution API, una plataforma de código abierto basada en la librería Baileys, que permite desplegar una API REST propia para gestionar cuentas de WhatsApp de forma autónoma, sin depender de terceros. Este artículo ofrece una guía práctica y detallada para instalar Evolution API utilizando Docker, abordando desde los requisitos previos hasta configuraciones avanzadas, y mostrando cómo esta solución se alinea con estrategias de transformación digital que incluyen automatización de procesos y desarrollo de aplicaciones a medida.

Utilizar Docker para montar Evolution API simplifica enormemente la gestión de dependencias y garantiza entornos reproducibles. Con un simple archivo docker-compose.yml, es posible levantar el servicio principal junto con PostgreSQL como base de datos persistente y Redis para caché, todo en contenedores aislados. Este enfoque evita problemas de incompatibilidad de sistemas y facilita la migración entre servidores, ya sea en un VPS tradicional o en servicios cloud AWS y Azure, donde la escalabilidad y la seguridad son críticas. La comunidad de Evolution API mantiene actualizada la imagen oficial en Docker Hub, lo que permite obtener las últimas mejoras de compatibilidad con WhatsApp Web y parches de seguridad de forma inmediata.

El proceso de instalación comienza clonando un repositorio preparado para Docker, como el de devalexcode, y configurando las variables de entorno en un archivo .env. Allí se definen la clave de autenticación global (AUTHENTICATION_API_KEY), los puertos de los servicios y las credenciales de PostgreSQL. Luego, basta ejecutar docker compose up -d para que se levanten los contenedores de Evolution API, la base de datos y Redis. La API se expone por defecto en el puerto 8080, accesible mediante el panel de control /manager. Para entornos de pruebas rápidas, también se puede lanzar el contenedor con un solo comando docker run, aunque la opción con Compose es más recomendable para producción.

Una vez desplegado, la autenticación se gestiona mediante la clave maestra, pero cada sesión de WhatsApp añadida puede generar su propia API Key, lo que permite manejar múltiples cuentas de forma independiente. Esta flexibilidad es ideal para empresas que necesitan integrar diferentes canales de atención o departamentos. La configuración de webhooks permite procesar mensajes en tiempo real, conectándose con sistemas como n8n o motores de IA para empresas. Precisamente, la inteligencia artificial aplicada a estos flujos de comunicación abre posibilidades como chatbots avanzados, análisis de sentimiento o agentes IA que automatizan respuestas. En este contexto, contar con un socio tecnológico como Q2BSTUDIO resulta fundamental, ya que ofrecen servicios de desarrollo de software a medida, integración de herramientas de business intelligence como Power BI, y soluciones de ciberseguridad para proteger estos entornos críticos.

Para asegurar la persistencia y el rendimiento, Evolution API emplea PostgreSQL para almacenar mensajes y sesiones, y Redis para acelerar operaciones de caché. Es recomendable realizar copias de seguridad periódicas de la base de datos y mantener las imágenes Docker actualizadas. En escenarios multiusuario con altos volúmenes de tráfico, se puede escalar horizontalmente añadiendo más instancias o utilizando orquestación con Kubernetes, siempre bajo la supervisión de expertos en servicios cloud AWS y Azure. La combinación de Evolution API con Docker ofrece, por tanto, una puerta de entrada profesional a la automatización de WhatsApp, permitiendo a las empresas tomar el control de su canal de comunicación, reducir costes recurrentes y cumplir con normativas de protección de datos. Para proyectos que vayan más allá de lo básico, como la creación de aplicaciones a medida que integren múltiples canales o la implementación de agentes IA, es recomendable apoyarse en un equipo especializado. Q2BSTUDIO cuenta con experiencia en el desarrollo de soluciones personalizadas que abarcan desde la automatización hasta la inteligencia de negocio, garantizando resultados robustos y alineados con los objetivos de cada organización.

A BREAK?

Play for a moment before you go

OUR SERVICES

How we can help you

Artificial intelligence

AI agents, chatbots, and intelligent assistants that automate tasks and serve your customers 24/7 to improve the efficiency of your business.

More info

Software Development

Web, mobile, and desktop applications, intranets, e-commerce, SaaS, and management platforms designed for your company's specific needs.

More info

Cloud services

Migration, infrastructure, managed hosting, high availability, and security on Microsoft Azure and Amazon Web Services to help your business scale without limits.

More info

Cybersecurity and pentesting

Security audits, penetration testing and protection of applications, data and infrastructure on-premise and cloud, with ethical hacking and regulatory compliance.

More info

Business Intelligence

Dashboards and data analysis with Power BI: we integrate your sources, design dashboards and KPIs and turn your data into decisions.

More info

Process automation

We automate repetitive tasks and connect your applications with n8n, Power Automate, Make, and RPA, eliminating manual work and increasing productivity.

More info

Training for Companies

We train your teams in technology with criteria: web development, databases, Git, best practices and security, automation with n8n, artificial intelligence for companies and creation of AI solutions with Azure AI Foundry.

More info

Code Auditing

We audit the code that you, your team or an AI create: we tell you what is good and what to improve, we secure it and make it ready for production, web or app.

More info

AI Image Generation

We create for you the images that your business needs with artificial intelligence: product, networks, advertising, illustration and avatars. You tell us what you want and we deliver it ready to use.

More info

AI Video Generation

We create videos with artificial intelligence for you: promotional, networking, virtual presenters, dubbing and animations. You tell us the idea and we will deliver it assembled and ready to publish.

More info

AI Conversational Avatars

We create conversational avatars with AI – digital humans with a face and voice – that serve your customers and teams with the knowledge of your company, on your website, interactive monitors, WhatsApp or Teams.

More info

Online Marketing and AI

Google Ads, Meta Ads, LinkedIn Ads and AI Engine Positioning (GEO/AEO): we attract customers and make your brand appear where they search for you, also on ChatGPT, Gemini and Perplexity.

More info

Do you have a project in mind?

Tell us your vision and we'll turn it into a software solution. Whatever the scope, we make your idea real.

Live Chat