Evolution API instável? Como fixar a versão do WhatsApp no Docker

Ontem, diversos projetos que utilizam a Evolution API (API não oficial do WhatsApp) enfrentaram instabilidades. O motivo: uma atualização na versão do WhatsApp usada nas sessões.

💡 A correção é simples — e rápida. Se você usa Docker, basta atualizar seu docker-compose.yaml, na seção api, adicionando esta variável de ambiente:

environment:
  - CONFIG_SESSION_PHONE_VERSION=2.3000.1023204200

🧩 Essa linha define manualmente a versão do WhatsApp compatível.

📂 Exemplo completo (com base no meu setup):

api:
  container_name: evolution_api
  image: atendai/evolution-api:latest
  restart: always
  depends_on:
    - redis
    - postgres
  ports:
    - "8080:8080"
  volumes:
    - evolution_instances:/evolution/instances
  networks:
    - shared-network
  env_file:
    - .env
  environment:
    - CONFIG_SESSION_PHONE_VERSION=2.3000.1023204200

🔄 Após salvar, basta rodar:

docker compose down
docker compose up -d --build

🚀 QR Code funcionando novamente e instâncias no ar.

📌 Insight final: esse tipo de ajuste técnico é comum quando lidamos com APIs que replicam comportamentos de serviços proprietários. Ter domínio sobre sua stack e capacidade de resposta rápida faz toda a diferença.

Se você também trabalha com automações em larga escala usando WhatsApp, APIs e Docker, vamos nos conectar. Sempre compartilho aprendizados técnicos como esse.