En esta lección vamos a instalar una pieza clave para tus automatizaciones: Evolution API.
Si alguna vez has intentado conectar WhatsApp a un sistema automático usando la API oficial de Meta, sabrás que es un auténtico «dolor de barriga»: procesos eternos, bloqueos y configuraciones imposibles. Evolution API es la solución definitiva. Es un software que nos permite conectar nuestro WhatsApp (como si fuera WhatsApp Web) para que nuestros agentes de IA puedan hablar con los clientes.
Aunque tiene versiones de pago que rondan los 300$, nosotros vamos a instalar la versión Open Source en nuestro servidor de Contabo por 0€ adicionales. ¡Vamos allá!
Videotutorial Paso a Paso:
Aquí tienes el video completo donde realizo el proceso en tiempo real para que no te pierdas ningún detalle.
1. El registro DNS (Tu dirección de acceso)
Como siempre, antes de instalar, necesitamos crear la «puerta de entrada» en nuestro panel de Contabo (nueva interfaz):
- Ve a Servicios de Red > Gestión de DNS.
- Entra en tu zona de dominio (ej.
touch.digital). - Crea un nuevo registro de tipo CNAME.
- En el nombre pon:
app-evoapi.tudominio.com - Apúntalo a tu dirección principal:
workspace.tudominio.com.
2. Instalación con Orion Design
Ahora entramos en nuestra terminal (Termius) y ejecutamos el comando rápido que ya conocemos:
./setupOrion (Recuerda la ‘S’ y la ‘O’ en mayúsculas).
- Aceptamos las políticas escribiendo
y. - Elegimos la opción 03 (Evolution API).
- Cuando nos pida el dominio, pegamos el que acabamos de crear:
app-evoapi.tudominio.com. - Confirmamos y… ¡a esperar!
¿Qué está pasando por detrás? El sistema detectará que Evolution API necesita una base de datos PostgreSQL. Si no la tienes, Orion la instalará por ti automáticamente. Puedes ver cómo se crean estos «stacks» en tiempo real desde tu panel de Portainer.
3. Acceso y Configuración (El Manager)
Una vez termine la instalación, Orion Design te mostrará unos datos vitales: la URL del Manager y la Global API Key.
¡Guarda estos datos como oro en paño! Los necesitarás para conectar cualquier flujo de automatización.
- Para entrar: Copia la URL que termina en
/manager, pégala en tu navegador y usa la Global API Key para hacer login. - ¿Y si pierdo la clave?: No te preocupes. Entra en tu Portainer, busca el stack de
evolution-api, ve a la pestaña Editor y dentro de las «Variables de Entorno» (Environment) encontrarás de nuevo tu API Key.
4. Verificando la versión
Al igual que con las otras apps, en Portainer verás que estamos usando la versión latest (la última). Esto es genial porque siempre tendrás las últimas mejoras de conexión con WhatsApp sin tener que configurar nada complicado.
Resumen de lo que hemos logrado:
Todo integrado en nuestra propia infraestructura de IA.
Hemos esquivado las complicaciones de la API oficial de Meta.
Tenemos un gestor de instancias de WhatsApp profesional.