Evolution API v2 em Produção: Docker Compose com PostgreSQL, Redis e S3

1. Arquitetura e pré-requisitos no ambiente

A Evolution API v2 trouxe ganhos expressivos de estabilidade usando Prisma + PostgreSQL para persistência de sessões e Redis para cache. Configurar esses três pilares evita que instâncias desconectem ao reiniciar o container.

• VPS no Brasil com pelo menos 4 GB RAM (até 5 instâncias) ou 12 GB RAM (Performance) para dezenas de números.
• PostgreSQL 16 e Redis 7 dedicados na stack Docker.
• Bucket S3 ativo para salvar áudios, figurinhas, PDFs e vídeos fora do disco local.

2. Passo a passo de implementação e validação

1. Defina DATABASE_PROVIDER=postgresql e informe a URL de conexão em DATABASE_CONNECTION_URI.
2. Ative o cache de sessão no Redis com CACHE_REDIS_ENABLED=true e CACHE_REDIS_SAVE_INSTANCES=true.
3. Desative sincronização desnecessária de histórico completo (DATABASE_SAVE_DATA_HISTORIC=false) se você já salva as conversas no Chatwoot ou CRM.
4. Troque a AUTHENTICATION_API_KEY padrão por um token aleatório de 32+ caracteres e suba a stack.

3. Boas práticas de produção, segurança e escala

Desativar o download de histórico antigo ao escanear o QR Code reduz em 80% o pico de CPU e memória nos primeiros 2 minutos de conexão de cada chip.

• Nunca exponha a porta 8080 da Evolution API direto sem Nginx/HTTPS e rate limit.
• Use DEL_INSTANCE=false para evitar exclusão acidental de instâncias desconectadas temporariamente.