Optimizando Evolution API

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

1. Abre Portainer en tu navegador
2. Selecciona tu servidor
3. Ve al apartado Stacks
4. Selecciona la Stack de Evolution
5. 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

1. En el código de Docker Compose, busca la sección «Configuración del Cliente»
2. Localiza la variable config.SessionVersion

Paso 2: Obtener la Versión Más Reciente

1. Copia la URL: https://wppconnect.io/whatsapp-versions/
2. Pégala en una nueva pestaña del navegador
3. En la página que se abre, encontrarás el historial completo de versiones de WhatsApp Web
4. Copia la versión más reciente (la primera de la lista)
5. Importante: Copia solo los números, sin el guión alfa

Paso 3: Actualizar la Configuración

1. Regresa a Portainer
2. Localiza la variable config.SessionVersion
3. 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

1. Revisa que todas las configuraciones estén correctas
2. Desplázate hacia abajo en Portainer
3. Haz clic en «Update the Stack»
4. 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.