Configurar proxy HTTP residencial em Baileys e Evolution API é o passo mais crítico para garantir que cada instância de WhatsApp use um IP de operadora brasileira real. Sem isso, múltiplas instâncias rodando no mesmo servidor compartilham o mesmo IP e são detectadas pelo WhatsApp como atividade automatizada.
Por Que Configurar Proxy em Baileys e Evolution API?
Baileys e Evolution API são duas das principais bibliotecas/frameworks para automação de WhatsApp no ecossistema Node.js. Ambas são poderosas — e ambas precisam de configuração de proxy para operar de forma segura em produção.
O problema sem proxy é simples: por padrão, todas as instâncias conectadas em um mesmo servidor compartilham o IP público daquela máquina. Para o WhatsApp, isso é um sinal claro de automação centralizada — e o resultado é banimento em massa de números.
Com uma proxy residencial configurada por instância, cada número aparece para o WhatsApp com um IP diferente, de uma operadora residencial brasileira real. A operação se torna praticamente indistinguível de usuários convencionais acessando de residências diferentes.
Requisitos Antes de Configurar
Antes de iniciar a configuração, garanta que você tem:
— Uma proxy residencial dedicada no Brasil com credenciais de acesso (host, porta, usuário e senha)
— Node.js instalado (v18 ou superior recomendado para Baileys e Evolution API)
— Baileys instalado no projeto ou Evolution API configurada no servidor
— Acesso SSH ao servidor onde as instâncias rodam
Para a proxy, certifique-se de que o serviço suporta protocolo HTTP e, de preferência, SOCKS5. Confirme o IP ativo antes de iniciar a configuração.
Como Configurar Proxy HTTP no Baileys (WhiskeySockets)
O Baileys (biblioteca @whiskeysockets/baileys) aceita configuração de proxy via as opções de fetch nativas do Node.js. O método mais direto usa o pacote proxy-agent:
npm install proxy-agent
Com o pacote instalado, a configuração na inicialização da sessão fica assim:
const { makeWASocket, useMultiFileAuthState } = require(‘@whiskeysockets/baileys’);
const { ProxyAgent } = require(‘proxy-agent’);
const proxyUrl = ‘http://usuario:senha@host:porta’;
const agent = new ProxyAgent(proxyUrl);
const { state, saveCreds } = await useMultiFileAuthState(“./auth_info”);
const sock = makeWASocket({
auth: state,
fetchAgent: agent,
browser: [“Chrome”, “Chrome”, “120.0.0”],
});
Substitua usuário, senha, host e porta pelas credenciais fornecidas pelo serviço de proxy. Para proxies SOCKS5, substitua o protocolo na URL: socks5://usuario:senha@host:porta.
Após a configuração, verifique o IP usando uma requisição de teste antes de conectar o número:
const axios = require(‘axios’);
const res = await axios.get(‘https://api.ipify.org?format=json’, { httpsAgent: agent });
console.log(res.data.ip); // deve mostrar o IP da proxy
Como Configurar Proxy na Evolution API
A Evolution API oferece suporte a proxy por instância, o que permite configurar IPs diferentes para cada número gerenciado pelo servidor.
A configuração pode ser feita de duas formas: via variáveis de ambiente no .env (para proxy global) ou via API REST por instância (recomendado para operações com múltiplos números).
Configuração via API REST por instância: Ao criar ou atualizar uma instância via a rota POST /instance/create, inclua o objeto proxy no body da requisição:
{
“instanceName”: “meu-numero”,
“proxy”: {
“host”: “host-da-proxy”,
“port”: “porta”,
“protocol”: “http”,
“username”: “usuario”,
“password”: “senha”
}
}
A Evolution API vai usar essas credenciais para rotear todo o tráfego daquela instância pela proxy especificada. Instâncias sem configuração de proxy vão usar o IP do servidor.
Para uma referência completa de configuração, consulte o guia de como configurar proxy para automação de WhatsApp com passo a passo para as principais ferramentas do mercado.
Proxy HTTP vs SOCKS5: Qual Usar Para WhatsApp?
Tanto HTTP quanto SOCKS5 funcionam com Baileys e Evolution API, mas há diferenças práticas:
HTTP: Protocolo mais amplamente suportado. Mais fácil de configurar e funciona na maioria dos ambientes corporativos. Limitação: não suporta UDP nativamente, o que pode afetar certas funcionalidades do WhatsApp em versões futuras.
SOCKS5: Suporte a TCP e UDP. Mais transparente — trabalha no nível de transporte em vez de aplicação. Melhor para aplicações que precisam de suporte completo de protocolo. Exige que o serviço de proxy ofereça suporte a SOCKS5.
Para a maioria das operações de automação de WhatsApp em 2026, HTTP é suficiente e mais simples de configurar. Use SOCKS5 se a ferramenta de automação recomendar explicitamente ou se você tiver problemas específicos de conectividade com HTTP.
Como Testar Se a Proxy Está Funcionando Corretamente?
Antes de conectar qualquer número real, sempre valide a proxy com os seguintes testes:
Teste de IP: Faça uma requisição para https://api.ipify.org ou https://httpbin.org/ip usando o agente de proxy configurado. O IP retornado deve ser o da proxy, não do seu servidor.
Teste de geolocalização: Valide que o IP retorna uma localização no Brasil (https://ipinfo.io/{ip}). IPs de operadoras brasileiras devem retornar à cidade e estado brasileiros.
Teste de velocidade: Uma latência muito alta da proxy pode afetar o tempo de resposta das mensagens. Valores abaixo de 200ms para conexões no Brasil são geralmente aceitáveis.
Teste de estabilidade: Rode a instância por pelo menos 30 minutos sem enviar mensagens para verificar se a conexão com o proxy se mantém estável antes de começar a usar o número.
Boas Práticas de Segurança com Proxy em APIs de WhatsApp
Além da configuração técnica, algumas práticas de segurança são essenciais para operações sustentáveis:
1 proxy por número: Nunca compartilhe o mesmo IP entre múltiplos números na mesma operação.
Rotação de IPs com cautela: Trocar o IP de um número ativo pode gerar suspeita. Se precisar trocar, faça isso gradualmente e acompanhe o comportamento do número por 24-48 horas.
Não reutilize IPs banidos: Se um número foi banido usando um IP específico, não use o mesmo IP para um número substituto imediatamente.
Logs e monitoramento: Mantenha logs de qual IP está associado a cada número. Em caso de banimento, esse histórico é essencial para identificar padrões.
Para operações com muitos números, o investimento em automação do gerenciamento de proxies — usando a API do provedor para alocar e monitorar IPs programaticamente — retorna rapidamente na forma de menor tempo operacional e maior estabilidade.
Como Contratar Uma Proxy Residencial Dedicada?
A ProxyAds oferece proxy residencial com IP de operadora brasileira real, exclusivo por cliente, sem limite de dados e com entrega imediata pelo painel automatizado.
Acesse proxyads.com para escolher seu plano.