A Evolution API roda numa VPS, e todas as instâncias saem pelo endereço público daquela máquina. Esse endereço costuma ser um bloco de datacenter, muitas vezes fora do Brasil, dividido com dezenas de projetos que você não controla. Quando um número brasileiro conecta de lá, junto com outros nove números da mesma máquina, a origem fica genérica, concentrada e distante do DDD do chip.
A correção é simples de descrever: um IP fixo de provedor brasileiro (ISP) por número, em SOCKS5, configurado na própria instância. Esta página explica por que esse é o tipo certo, onde ele entra na Evolution, quantos IPs comprar e o que conferir antes de ler o QR Code.
Por que o IP da VPS derruba número
O IP da VPS não é seu no sentido de reputação. Os vizinhos do mesmo bloco fazem o que quiserem, e a geolocalização aponta o datacenter, não a cidade do chip. Nenhum desses fatos derruba uma sessão sozinho. Juntos, eles descrevem uma origem que não se parece com um aparelho no Brasil.
O segundo problema é de arquitetura: dez instâncias, um IP. Um incidente em um número vira um incidente de origem para os outros nove. Quem opera para clientes diferentes sente isso primeiro: a conta de um cliente é afetada por um número que nem é dele.
Qual proxy usar na Evolution API
| Tipo | Serve? | Por quê |
|---|---|---|
| ISP fixo | Sim, é o recomendado | IP de provedor de internet brasileiro, fixo e exclusivo, HTTP e SOCKS5, sem medidor de GB. Passou no nosso teste de conexão ao WhatsApp. |
| IPv4 dedicado | Com ressalva | Fixo e mais barato, mas anunciado sob rede de datacenter. Parte dos IPs de datacenter não abre o WhatsApp. |
| Residencial rotativo por GB | Não | O endereço muda a cada pedido ou sessão. É o oposto do que a conexão persistente da Evolution precisa. |
| Móvel 4G/5G | Raramente | Custa muito mais e não resolve nada que o ISP não resolva numa API self-hosted. |
O ISP sai por R$ 50,00 por IP no plano mensal, com planos mensal e trimestral e desconto de até 10% no prazo maior. Há também um plano de 7 dias, útil para validar a sua instalação antes de assinar o mensal. A credencial é a mesma para HTTP e SOCKS5, em portas diferentes informadas no painel.
Onde o proxy entra: por instância ou global
A Evolution aceita o proxy de duas formas, e as duas estão detalhadas no guia de configuração da Evolution API:
- Por instância (recomendado). Cada instância recebe o seu próprio proxy, com servidor, porta, protocolo, usuário e senha. É assim que "um número, um IP" vira realidade, e a configuração por instância cobre tanto a conexão principal quanto o download de mídia. Os nomes exatos dos campos variam entre versões da Evolution; a estrutura é sempre a mesma.
- Global, por variável de ambiente. Todas as instâncias saem pelo mesmo proxy. Serve para quem tem um número só, ou para uma operação em que todos os números são a mesma unidade de risco.
Use SOCKS5. A sessão persistente da Evolution se comporta melhor nele do que em HTTP, e o erro mais comum de instalação é apontar a porta do HTTP onde deveria estar a do SOCKS5: o QR Code simplesmente não aparece.
As ferramentas que conversam com a Evolution, como n8n, Chatwoot ou Typebot, não precisam de proxy. Quem conecta ao WhatsApp é a Evolution, e é nela que a origem é definida.
Quantos IPs comprar
| Cenário | Configuração |
|---|---|
| 1 número | 1 ISP fixo |
| Vários números do mesmo cliente | 1 IP por número; ou 1 IP para todos, se forem a mesma operação e você aceitar o risco conjunto |
| Vários clientes na mesma VPS | No mínimo 1 IP por cliente |
| Números críticos em produção | 1 IP por número, sem exceção |
A conta é direta: o custo mensal de um IP fixo é uma fração do custo de perder um número em produção, sem contar o tempo de reconectar, reconfigurar e avisar o cliente.
Antes de ler o QR Code: a conferência que evita retrabalho
- Teste o proxy a partir da própria VPS, com o curl apontando para o SOCKS5. A resposta precisa mostrar o IP contratado e o país Brasil. Se mostrar o IP da máquina, o proxy não está sendo aplicado.
- Codifique caracteres especiais da senha dentro da string de conexão. Uma senha com arroba, dois-pontos, barra ou cerquilha quebra a URL do proxy se for colada sem codificar.
- Confira a porta. SOCKS5 e HTTP têm portas diferentes na mesma credencial.
- Só então conecte o número. Conectar primeiro e configurar o proxy depois significa que a sessão inicial foi aberta pelo endereço errado.
Os comandos prontos, inclusive o bloco de variáveis para o Docker, estão no guia da Evolution API. Baileys direto, sem Evolution, tem o seu próprio guia, e o WPPConnect, que conecta pelo navegador, outro.
Para quem revende ou opera muitos números
Quem provisiona números para clientes não quer entrar no painel a cada instância nova. Pela API da ProxyBox o seu sistema coloca saldo por PIX, compra o IP, guarda host, porta, usuário e senha, deixa a renovação automática ligada e cancela quando o cliente sai. A renovação também pode ser feita pelo painel, em um clique.
Se um IP apresentar falha técnica, o botão Não funciona, no próprio proxy, testa o endereço e faz a troca mantendo a vigência. Os critérios estão na política de troca.
Quando o número cai mesmo com proxy
Depois que a origem está certa, o diagnóstico muda de rede para aplicação. As causas que mais aparecem:
- Sessão corrompida. Apague e recrie a instância.
- Versão desatualizada da biblioteca. O WhatsApp muda o protocolo com frequência, e a Evolution acompanha nas versões novas.
- Uso simultâneo acima do contratado. Mais conexões no mesmo proxy do que o plano permite.
- Padrão de envio. Volume, repetição e reclamações de destinatários. É a causa mais comum de banimento e nenhum IP corrige. O artigo WhatsApp banido: causas reais na API e no Business separa desconexão de banimento.
O que o proxy não faz
O proxy controla a origem da conexão: endereço exclusivo, geolocalização brasileira e independência entre instâncias. Ele não controla as políticas do WhatsApp, os limites de envio, a qualidade do número, o conteúdo das mensagens ou as reclamações de quem recebe. Também não se aplica à API oficial do WhatsApp, que conecta pelos servidores da Meta e não passa pelo seu IP.
Não vendemos promessa de "nunca cair". Vendemos a variável "origem compartilhada e fora do Brasil" removida da equação, com PIX e credenciais no painel em minutos.