Evolution API: escalar com segurança

Evolution API pode resolver este cenário em uma VPS quando a arquitetura separa a entrada pública, o processamento e os dados persistentes. Este guia mostra um caminho reproduzível usando 443 no proxy; 8080 para a API apenas na rede privada; Redis e banco sem exposição pública, com foco em operações que usam WhatsApp com automações e múltiplos fluxos. As recomendações são de dimensionamento inicial: confirme o consumo real no seu ambiente antes de aumentar capacidade.

Veja a infraestrutura: VPS para Evolution API no Brasil para colocar este projeto no ar.

Resposta direta: comece com uma arquitetura simples, proteja serviços internos e observe o gargalo antes de alterar o plano. O caso mais comum aqui é separar recebimento de mensagens, automação e persistência para reduzir acoplamento; a decisão muda se houver processamento pesado, múltiplas instâncias ou histórico crescente.

O que é Evolution API neste cenário?

Em resumo: Evolution API é a camada que atende o problema descrito, mas não substitui proxy, persistência, fila, backup ou monitoramento. A primeira pergunta é qual parte da carga deve ficar disponível para a internet e qual parte deve ficar somente na rede privada.

Quem se beneficia

Operações que usam whatsapp com automações e múltiplos fluxos se beneficia quando precisa de uma operação repetível, com configuração documentada e uma forma clara de retornar após uma alteração. O objetivo não é esconder complexidade, mas colocá-la em camadas que possam ser verificadas.

O limite da ferramenta

O serviço não corrige automaticamente payloads inválidos, credenciais expostas ou falta de espaço. Quando o sintoma aparece, registre horário, rota, código HTTP, tamanho da fila e uso de CPU/RAM. Sem esse contexto, uma mudança de infraestrutura vira apenas tentativa.

Arquitetura recomendada e requisitos

O desenho recomendado: termine TLS no proxy, mantenha a aplicação em rede privada e reserve persistência para o banco e volumes. Para uma instalação inicial, considere pelo menos 2 vCPUs e 4 GB de RAM para um serviço leve; quando houver fila, banco e workers juntos, o ponto de partida mais coerente é 4 vCPUs e 8 GB. Esses números são referências de planejamento, não uma medição do seu ambiente.

Portas e fronteiras

Exponha somente 80/443 quando houver proxy. A porta específica indicada para este artigo é 443 no proxy; 8080 para a API apenas na rede privada; Redis e banco sem exposição pública. Redis, banco e painéis administrativos devem ser limitados por firewall e rede interna. Se uma integração exige acesso externo, prefira autenticação, TLS e uma rota com escopo reduzido.

RAM, disco e crescimento

Reserve espaço para logs e dados antes de publicar. Uma VPS com 6 vCPUs, 12 GB de RAM e 150 GB NVMe atende o perfil comercial recomendado neste lote, mas a compra deve seguir a carga real. Verifique memória disponível, conexões do banco, I/O e backlog; não use uma porcentagem inventada como garantia de capacidade.

Comparação para escolher a abordagem

A escolha depende do fluxo, não do nome da ferramenta: compare operação, risco e capacidade de recuperação. A tabela resume o recorte deste artigo e evita tratar soluções diferentes como equivalentes.

O que muda na prática

Uma opção mais simples reduz o número de componentes, mas pode concentrar falhas. Uma opção distribuída melhora a separação, porém exige logs, retry, permissões e uma rotina de restauração. A decisão deve ser revisada depois de observar o padrão de uso.

Trade-off que não deve ser escondido

Hospedar por conta própria entrega mais controle, mas também transfere para a equipe atualizações, credenciais, backups e investigação de incidentes. Documente essa responsabilidade antes de tratar a VPS como solução automática.

Passo a passo de implementação

Faça a mudança em etapas: valide cada camada antes de abrir tráfego. O roteiro abaixo é um procedimento geral; adapte nomes, variáveis e credenciais ao seu ambiente.

1. Definir o volume e o estado necessário.
2. Isolar api, redis e banco.
3. Colocar tls e autenticação no proxy.
4. Processar eventos por fila.
5. Acompanhar logs e reconexões.

Comandos mínimos de verificação

Em um projeto Docker, estes comandos ajudam a confirmar estado e resposta. Eles não substituem backup nem revisão do arquivo Compose.

docker compose ps
docker compose logs --tail=100 SERVICE
curl -I https://seu-dominio.example/health

Como validar sem interromper usuários

Teste primeiro uma rota de saúde, depois uma operação representativa e por fim a recuperação de uma falha controlada. Preserve a configuração anterior e registre o horário, o resultado e a ação de retorno.

Erros comuns e como investigar

O diagnóstico começa pelo sintoma observável: não altere CPU, RAM ou timeout sem saber qual camada está saturada. Os erros abaixo são recorrentes neste tipo de projeto.

• expor Redis: trate este risco antes de considerar a publicação concluída.
• confundir mais processos com mais capacidade: trate este risco antes de considerar a publicação concluída.
• não documentar recuperação de sessão: trate este risco antes de considerar a publicação concluída.

Logs antes de opinião

Compare logs do proxy, aplicação, worker e banco no mesmo intervalo. Um 502 pode ser rota, processo parado, firewall ou timeout; o código isolado não identifica a causa.

Segurança operacional

Use variáveis de ambiente protegidas, permissões mínimas e uma janela de mudança. Não publique tokens, IPs privados, dados de clientes ou saídas de terminal que revelem segredos.

Critérios de decisão para este projeto

O critério central é o efeito operacional, não a quantidade de componentes: Usar fila e limites por instância antes de adicionar mais processos. Antes de escolher uma arquitetura, escreva qual evento entra, qual estado precisa ser preservado e qual resultado deve ser repetível. Essa pequena especificação evita que uma tela, um worker ou um proxy sejam tratados como a solução inteira.

O que medir antes de mudar

Registre pelo menos horário, rota, código de resposta, duração, tamanho do payload, uso de CPU, memória, espaço em disco e quantidade de itens pendentes. A coleta precisa distinguir uma falha de rede de uma falha da aplicação. Se a operação envolve dados persistentes, registre também conexões ativas, erros do banco e o tamanho do volume. Não transforme esses valores em promessa comercial: eles servem para comparar o mesmo ambiente antes e depois.

Como documentar a mudança

Guarde a configuração anterior, a nova configuração, o motivo da alteração, o teste realizado e o plano de retorno. Para Evolution API, descreva quem pode acessar a rota, quais serviços ficam internos e como uma credencial é substituída. No caso específico de separar recebimento de mensagens, automação e persistência para reduzir acoplamento, a recuperação deve ser executada em teste antes do tráfego principal. Isso transforma conhecimento tácito em um procedimento que outra pessoa consegue repetir.

Quando não aumentar o plano

Se os logs mostram erro de configuração, rota incorreta, bloqueio de firewall ou retry sem limite, mais CPU e RAM não resolvem a causa. Corrija a camada responsável, repita o teste e só então reavalie o dimensionamento. A recomendação de 6 vCPUs, 12 GB de RAM e 150 GB NVMe é um ponto de partida comercial para o perfil deste artigo; não substitui uma medição de capacidade nem garante uma métrica de performance.

Perguntas relacionadas

Como dimensionar Evolution API em uma VPS?

A resposta depende da carga e da topologia. Comece pelos limites descritos neste guia, meça o comportamento real e só então altere recursos ou componentes.

Quais portas devo expor para Evolution API?

A resposta depende da carga e da topologia. Comece pelos limites descritos neste guia, meça o comportamento real e só então altere recursos ou componentes.

Quando separar banco e worker?

A resposta depende da carga e da topologia. Comece pelos limites descritos neste guia, meça o comportamento real e só então altere recursos ou componentes.

Como testar uma restauração?

A resposta depende da carga e da topologia. Comece pelos limites descritos neste guia, meça o comportamento real e só então altere recursos ou componentes.

Próximo passo: escolher a VPS

Para este perfil, o plano Performance (R$ 169/mês) é o ponto de partida recomendado: 6 vCPUs, 12 GB de RAM e 150 GB NVMe. Ele faz sentido quando o projeto precisa de margem para separar recebimento de mensagens, automação e persistência para reduzir acoplamento; se a carga for menor, valide o consumo antes de contratar mais recursos. Veja os detalhes reais e a disponibilidade em VPS Brasil Performance.