Configuración Maestra de Evolution API: Optimiza tu Conexión con WhatsApp y Chatwoot

Instalar la API es solo el primer paso. Si quieres una integración profesional con WhatsApp, evitar errores de visualización y conectar correctamente tu CRM, necesitas «meterle mano» a las Variables de Entorno en Portainer.

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. Idioma y Personalización: Que tu API hable español

Por defecto, la API viene configurada en portugués. Vamos a cambiarlo para que los logs y mensajes del sistema sean claros para nosotros.

• El cambio: Busca la variable LANGUAGE y cámbiala de portugués a español usando el código es_ES (o es-ES según el formato que veas en tu archivo).
• Nombre de la instancia: Busca la variable que dice SetupOrion (es el nombre por defecto) y cámbiala por el nombre de tu proyecto (por ejemplo: MiProyecto_IA). Este es el nombre que aparecerá internamente en tus conexiones.

2. Versión de WhatsApp: ¡No la toques!

Este es un error común. Muchos intentan escribir manualmente la versión de WhatsApp en la variable VERSION.

Regla de oro: Deja esa línea comentada (con el símbolo # delante). Al hacerlo, Evolution API buscará automáticamente la última versión estable de WhatsApp por ti. ¡Un dolor de cabeza menos y siempre actualizado!

3. Conexión Estratégica con Chatwoot (Base de Datos)

Si usas Chatwoot como CRM para ver tus conversaciones, necesitas que la API pueda «leer» esa base de datos. Para ello, necesitamos conectar con pgvector (Postgres).

1. Ve al stack de pgvector en tu Portainer.
2. Copia la contraseña que aparece en POSTGRES_PASSWORD.
3. Vuelve al stack de Evolution API y busca la variable de la base de datos (donde dice algo como SENHA_DO_PGVECTOR).
4. Borra ese texto genérico y pega tu contraseña real. ¡Ahora ya están vinculados!

4. El truco de las Fotos con Comentario

¿Alguna vez te han enviado una foto por WhatsApp con un texto debajo y solo te ha llegado el texto? Eso es porque tienes la variable de archivos multimedia en false.

• Busca: CHATWOOT_IMPORT_PLACEHOLDER_MEDIA_MESSAGE (o similar).
• Cámbiala de false a true.
• Resultado: Ahora recibirás tanto la imagen como el comentario que la acompaña.

5. Aplicar los cambios

Al igual que con n8n, nada de esto funciona si no reiniciamos el motor:

1. Haz clic en Update the stack.
2. Confirma en Update.
3. Espera a que los servicios pasen de 0/1 a 1/1 (Running).

¡Listo! Tu Evolution API ya está optimizada, en español y conectada con tu base de datos de chats.