Introducción
Una vez instalado Evolution API, es fundamental aplicar ciertas configuraciones para optimizar su funcionamiento y evitar ser detectados por Meta. Estas configuraciones son esenciales para mantener activo nuestro número de WhatsApp sin riesgo de baneo.
Configuración de Webhooks
Paso 1: Acceder a Portainer
- Abre Portainer en tu navegador
- Selecciona tu servidor
- Ve al apartado Stacks
- Selecciona la Stack de Evolution
- Haz clic en Editor
Paso 2: Localizar las Variables de Entorno
Desplázate hacia abajo hasta encontrar las variables de entorno relacionadas con webhooks. Estas variables aparecen con valores por defecto que NO permiten el funcionamiento correcto de los webhooks.
Paso 3: Reemplazar Variables de Webhook
Sustituye todas las variables de webhook existentes por las siguientes configuraciones optimizadas:
- WEBHOOK_GLOBAL_ENABLED=false
- WEBHOOK_GLOBAL_URL=https://URL
- WEBHOOK_GLOBAL_WEBHOOK_BY_EVENTS=false
- WEBHOOK_EVENTS_APPLICATION_STARTUP=false
- WEBHOOK_EVENTS_QRCODE_UPDATED=true
- WEBHOOK_EVENTS_MESSAGES_SET=true
- WEBHOOK_EVENTS_MESSAGES_UPSERT=true
- WEBHOOK_EVENTS_MESSAGES_EDITED=true
- WEBHOOK_EVENTS_MESSAGES_UPDATE=true
- WEBHOOK_EVENTS_MESSAGES_DELETE=true
- WEBHOOK_EVENTS_SEND_MESSAGE=true
- WEBHOOK_EVENTS_CONTACTS_SET=true
- WEBHOOK_EVENTS_CONTACTS_UPSERT=true
- WEBHOOK_EVENTS_CONTACTS_UPDATE=true
- WEBHOOK_EVENTS_PRESENCE_UPDATE=true
- WEBHOOK_EVENTS_CHATS_SET=true
- WEBHOOK_EVENTS_CHATS_UPSERT=true
- WEBHOOK_EVENTS_CHATS_UPDATE=true
- WEBHOOK_EVENTS_CHATS_DELETE=true
- WEBHOOK_EVENTS_GROUPS_UPSERT=true
- WEBHOOK_EVENTS_GROUPS_UPDATE=true
- WEBHOOK_EVENTS_GROUP_PARTICIPANTS_UPDATE=true
- WEBHOOK_EVENTS_CONNECTION_UPDATE=true
- WEBHOOK_EVENTS_LABELS_EDIT=true
- WEBHOOK_EVENTS_LABELS_ASSOCIATION=true
- WEBHOOK_EVENTS_CALL=true
- WEBHOOK_EVENTS_TYPEBOT_START=false
- WEBHOOK_EVENTS_TYPEBOT_CHANGE_STATUS=false
- WEBHOOK_EVENTS_ERRORS=false
- WEBHOOK_EVENTS_ERRORS_WEBHOOK=https://url
Importante: Asegúrate de que todas las variables estén correctamente alineadas con espacios al principio si es necesario.
Configuración de Versión de WhatsApp Web
¿Por qué es importante?
Evolution API viene configurado con una versión antigua de WhatsApp Web por defecto. Para evitar la detección por parte de Meta, debemos usar siempre la versión más reciente.
Paso 1: Encontrar la Versión Actual
- En el código de Docker Compose, busca la sección «Configuración del Cliente»
- Localiza la variable
config.SessionVersion
Paso 2: Obtener la Versión Más Reciente
- Copia la URL: https://wppconnect.io/whatsapp-versions/
- Pégala en una nueva pestaña del navegador
- En la página que se abre, encontrarás el historial completo de versiones de WhatsApp Web
- Copia la versión más reciente (la primera de la lista)
- Importante: Copia solo los números, sin el guión alfa
Paso 3: Actualizar la Configuración
- Regresa a Portainer
- Localiza la variable
config.SessionVersion
- Reemplaza el valor existente con la versión más reciente que copiaste
Configuración de Chatwoot
Variable Crítica: Chatwoot Import Placeholder Media Message
Por defecto, esta variable está configurada como False
, lo que causa problemas con archivos multimedia.
Cambio requerido:
CHATWOOT_IMPORT_PLACEHOLDER_MEDIA_MESSAGE: true
¿Qué hace esta configuración?
- True: Muestra tanto el archivo multimedia (imagen, documento, etc.) como el texto que lo acompaña
- False: Solo muestra el texto, omitiendo el archivo multimedia
Esta configuración es esencial para una experiencia completa al recibir mensajes con archivos adjuntos.
Aplicar los Cambios
Paso Final: Actualizar la Stack
- Revisa que todas las configuraciones estén correctas
- Desplázate hacia abajo en Portainer
- Haz clic en «Update the Stack»
- Confirma la actualización
Resumen de Configuraciones Aplicadas
✅ Webhooks optimizados – Para mejor integración con sistemas externos ✅ Versión actualizada de WhatsApp Web – Para evitar detección ✅ Chatwoot configurado correctamente – Para manejo completo de multimedia
Próximos Pasos
Con estas configuraciones aplicadas, Evolution API estará optimizado para:
- Reducir el riesgo de detección por Meta
- Mejorar la funcionalidad de webhooks
- Manejar correctamente archivos multimedia si usamos chatwoot
- Mantener compatibilidad con la versión más reciente de WhatsApp Web
Recuerda: Siempre sigue las buenas prácticas de uso para evitar cualquier tipo de restricción en tu número de WhatsApp.