Evolution API v2.3.5 Ya Disponible

📅 ¿Qué Pasó?

Si seguiste nuestro artículo anterior, probablemente estés usando la imagen evoapicloud/evolution-api:homolog para solucionar el problema de códigos QR que no se generaban.

Buenas noticias: Evolution API acaba de lanzar la versión oficial v2.3.5 que incluye la corrección del GitHub Issue #1761.

✅ Cómo Actualizar de Homolog a v2.3.5

Paso 1: Hacer Backup de tu Configuración

Antes de hacer cambios, siempre respalda tu configuración actual:

# Respalda tu docker-compose.yml o archivo de configuración
cp docker-compose.yml docker-compose.yml.backup

Paso 2: Descargar la Nueva Imagen

Descarga la imagen oficial v2.3.5:

# Pull de la imagen oficial v2.3.5
docker pull evoapicloud/evolution-api:v2.3.5

Paso 3: Actualizar tu Configuración

Si usas Docker Compose:

# ANTES (con homolog)
services:
  evolution-api:
    image: evoapicloud/evolution-api:homolog
    # ... resto de configuración

# DESPUÉS (con v2.3.5)
services:
  evolution-api:
    image: evoapicloud/evolution-api:v2.3.5
    # ... resto de configuración (sin cambios)

Si usas Docker Swarm:

# ANTES
version: '3.8'
services:
  evolution-api:
    image: evoapicloud/evolution-api:homolog

# DESPUÉS
version: '3.8'
services:
  evolution-api:
    image: evoapicloud/evolution-api:v2.3.5

Paso 4: Aplicar los Cambios

Con Docker Compose:

# Detener el servicio actual
docker-compose down

# Iniciar con la nueva configuración
docker-compose up -d

Con Docker Swarm:

# Actualizar el stack
docker stack deploy -c docker-compose.yml nombre_del_stack

Paso 5: Verificar que Funciona

Verifica que el servicio esté corriendo con la nueva imagen:

# Ver contenedores en ejecución
docker ps | grep evolution

# O en Docker Swarm
docker service ps tu_servicio_evolution

# Verificar que el API responde
curl -I http://localhost:8080

Paso 6: Probar Generación de QR

📊 Comparativa: Homolog vs v2.3.5

⚠️ ¿Cuándo Actualizar?

Deberías actualizar a v2.3.5 si:

• ✅ Actualmente usas la imagen homolog
• ✅ Necesitas una versión estable con soporte oficial
• ✅ Trabajas en ambiente productivo
• ✅ Prefieres releases versionados sobre imágenes de desarrollo

Mantén homolog solo si:

• ⚠️ Estás probando features experimentales que aún no están en releases oficiales
• ⚠️ Tienes alguna razón específica documentada

🔍 Detalles Técnicos

¿Qué es Baileys v7.0.0-rc.5?

Baileys es la librería que Evolution API usa para conectarse a WhatsApp. La versión 7.0.0-rc.5 incluye mejoras importantes en la estabilidad de conexión y actualización del protocolo WhatsApp.

¿Se Elimina CONFIG_SESSION_PHONE_VERSION?

Sí. Con v2.3.5 ya no necesitas configurar manualmente CONFIG_SESSION_PHONE_VERSION. La aplicación detecta automáticamente la versión compatible.

# YA NO ES NECESARIO:
environment:
  - CONFIG_SESSION_PHONE_VERSION=2.3000.1023204200  # ← Eliminar

# La versión se detecta automáticamente

🐛 ¿Problemas Después de Actualizar?

Si experimentas problemas después de actualizar:

1. Revisa los logs: docker logs nombre_contenedor
2. Verifica la configuración: Asegúrate de no tener CONFIG_SESSION_PHONE_VERSION configurada
3. Prueba con instancia nueva: Crea una nueva instancia desde cero
4. Rollback si es necesario: Vuelve a tu backup si algo falla

# Restaurar backup
cp docker-compose.yml.backup docker-compose.yml

# Reiniciar servicio
docker-compose down && docker-compose up -d

🔗 Referencias

• 📦 Evolution API v2.3.5 Release Notes
• 🐛 GitHub Issue #1761 - QR Code Generation Fix
• 🐋 Evolution API en Docker Hub
• 📖 Artículo anterior: Solución con Imagen Homolog
• 📚 Documentación Oficial Evolution API

💡 ¿Necesitas Ayuda?

Si necesitas asistencia para actualizar tu instalación de Evolution API o tienes problemas durante el proceso, podemos ayudarte.