Proxy pra Baileys, Evolution API e WAHA: Setup e Evite Ban do WhatsApp [2026]

21 abr 2026•8 min read•

proxy

Por que API não-oficial do WhatsApp precisa de proxy

APIs não-oficiais como Baileys, Evolution API, WAHA e WhatsMeow conectam direto aos servidores do WhatsApp via WebSocket — sem passar pela infra oficial do WhatsApp Business Platform. Isso significa que o IP da conexão é o fingerprint mais visível pra detecção do WhatsApp.

Quando você roda 3, 10 ou 50 números numa mesma máquina com IP compartilhado — seja no seu cloud provider (AWS, GCP, DigitalOcean) ou num VPS brasileiro — o WhatsApp cruza dezenas de sinais:

Mesma faixa de IP pra vários números → provável "farm de contas"
IP de datacenter (ASN) → desconfiança aumentada
IP estrangeiro com número brasileiro → red flag
Reputação do IP (se outros usuários spamaram dele antes) → penalidade hereditária

Proxy dedicado brasileiro resolve os 4 sinais de uma vez: IP residencial de operadora BR, limpo, exclusivamente seu.

Como o WhatsApp detecta conexões suspeitas

O WhatsApp não publica o critério de ban. Mas pela engenharia reversa das bibliotecas e observação de centenas de operações no Brasil, os sinais principais são:

IP

ASN de datacenter: AWS, Google Cloud, Oracle Cloud, Azure, DigitalOcean, Hetzner — todos conhecidos. IP desses provedores tem rótulo de "não-residencial" em bases públicas.
IP geograficamente distante do número: número +55 conectando de +1 ou +33 → red flag.
IP compartilhado com outros casos "sujos": se o IP já teve histórico de spam, a reputação tá queimada.

Comportamento

Mudança constante de IP na mesma sessão: proxy rotativo = desconecta-reconecta = "é o mesmo celular mudando de wifi"? Provavelmente não.
Volume de mensagens enviadas × sem mensagens recebidas = padrão de disparador.
Mesmo device_id e user_agent em vários números = automação óbvia.

Device fingerprint

push_name padrão ("Android Web") em todos os números
Mesmo device fingerprint do Baileys (configurável via Browsers.ubuntu('Chrome'))

Proxy dedicado brasileiro cobre os sinais de IP. Boas práticas de device fingerprint cobrem o resto (explico abaixo).

Requisitos técnicos do proxy pra WhatsApp

Nem todo proxy serve. Requisitos mínimos:

IP fixo (não rotativo) — sessão WhatsApp precisa do mesmo IP pra não derrubar
IP brasileiro — mesma geo do número
IP residencial ou de operadora — não datacenter
IP dedicado — sem sharing com outros clientes
HTTP/HTTPS — bibliotecas aceitam esse protocolo
Baixa latência (menos de 50ms pro Brasil) — WhatsApp tem timeout agressivo
Uptime 99%+ — queda de 1h já pode forçar re-scan do QR Code

No Proxy Brasil os planos IPv4 e IPv6 cumprem os 7 requisitos. IPv4 universal, IPv6 pra escala (mais barato, 50+ instâncias).

Setup: Evolution API com proxy

Evolution API é o fork brasileiro mais popular de Baileys — tem Manager UI, Swagger, webhook, multi-instância. Configuração de proxy é via env:

# docker-compose.yml ou .env da Evolution API
 
# HTTP/HTTPS proxy
PROXY_HOST=host.proxybrasil.com
PROXY_PORT=3128
PROXY_USERNAME=seu_usuario
PROXY_PASSWORD=sua_senha
PROXY_PROTOCOL=http
 
# Ou setado por instância via REST API ao criar

# docker-compose.yml ou .env da Evolution API
 
# HTTP/HTTPS proxy
PROXY_HOST=host.proxybrasil.com
PROXY_PORT=3128
PROXY_USERNAME=seu_usuario
PROXY_PASSWORD=sua_senha
PROXY_PROTOCOL=http
 
# Ou setado por instância via REST API ao criar

Via REST API, passando proxy na criação da instância:

curl -X POST https://seu-evolution-api/instance/create \
  -H "Content-Type: application/json" \
  -H "apikey: SUA_API_KEY" \
  -d '{
    "instanceName": "loja-principal",
    "qrcode": true,
    "proxy": {
      "host": "host.proxybrasil.com",
      "port": 3128,
      "protocol": "http",
      "username": "seu_usuario",
      "password": "sua_senha"
    }
  }'

curl -X POST https://seu-evolution-api/instance/create \
  -H "Content-Type: application/json" \
  -H "apikey: SUA_API_KEY" \
  -d '{
    "instanceName": "loja-principal",
    "qrcode": true,
    "proxy": {
      "host": "host.proxybrasil.com",
      "port": 3128,
      "protocol": "http",
      "username": "seu_usuario",
      "password": "sua_senha"
    }
  }'

Cada instância roda com seu proxy — ideal pra separação estrita de 1 número = 1 IP.

Setup: Baileys (Node.js)

Baileys puro (sem Evolution) aceita proxy via agent do Socks/HTTP:

import makeWASocket from '@whiskeysockets/baileys'
import { HttpsProxyAgent } from 'https-proxy-agent'
 
const proxyUrl = 'http://seu_usuario:[email protected]:3128'
const agent = new HttpsProxyAgent(proxyUrl)
 
const sock = makeWASocket({
  auth: state,
  agent, // ← proxy vai por aqui
  fetchAgent: agent, // ← pra uploads/downloads de mídia
  browser: ['Chrome (Linux)', 'Chrome', '120.0.0.0'],
})

import makeWASocket from '@whiskeysockets/baileys'
import { HttpsProxyAgent } from 'https-proxy-agent'
 
const proxyUrl = 'http://seu_usuario:[email protected]:3128'
const agent = new HttpsProxyAgent(proxyUrl)
 
const sock = makeWASocket({
  auth: state,
  agent, // ← proxy vai por aqui
  fetchAgent: agent, // ← pra uploads/downloads de mídia
  browser: ['Chrome (Linux)', 'Chrome', '120.0.0.0'],
})

Importante: passe agent E fetchAgent. Sem o segundo, uploads de áudio/imagem saem pelo IP real da máquina — comprometendo o fingerprint.

Setup: WAHA (WhatsApp HTTP API)

WAHA roda em Docker com proxy via env var:

# docker-compose.yml
services:
  waha:
    image: devlikeapro/waha
    environment:
      - WHATSAPP_PROXY_SERVER=http://host.proxybrasil.com:3128
      - WHATSAPP_PROXY_SERVER_USERNAME=seu_usuario
      - WHATSAPP_PROXY_SERVER_PASSWORD=sua_senha
    ports:
      - "3000:3000"

# docker-compose.yml
services:
  waha:
    image: devlikeapro/waha
    environment:
      - WHATSAPP_PROXY_SERVER=http://host.proxybrasil.com:3128
      - WHATSAPP_PROXY_SERVER_USERNAME=seu_usuario
      - WHATSAPP_PROXY_SERVER_PASSWORD=sua_senha
    ports:
      - "3000:3000"

Todas as requisições da instância passam pelo proxy automaticamente.

Setup: WhatsMeow (Go)

WhatsMeow não tem proxy nativo, mas aceita via http.Client customizado:

import (
    "net/http"
    "net/url"
    "go.mau.fi/whatsmeow"
)
 
proxyURL, _ := url.Parse("http://seu_usuario:[email protected]:3128")
httpClient := &http.Client{
    Transport: &http.Transport{
        Proxy: http.ProxyURL(proxyURL),
    },
}
 
client := whatsmeow.NewClient(deviceStore, nil)
client.Proxy = http.ProxyURL(proxyURL)  // método do client

import (
    "net/http"
    "net/url"
    "go.mau.fi/whatsmeow"
)
 
proxyURL, _ := url.Parse("http://seu_usuario:[email protected]:3128")
httpClient := &http.Client{
    Transport: &http.Transport{
        Proxy: http.ProxyURL(proxyURL),
    },
}
 
client := whatsmeow.NewClient(deviceStore, nil)
client.Proxy = http.ProxyURL(proxyURL)  // método do client

A configuração varia por versão do WhatsMeow — sempre consulte a doc atual da biblioteca.

Multi-instância: quantos números por proxy?

Essa é a pergunta de ouro. Duas abordagens com trade-offs:

Abordagem 1: 1 proxy = 1 instância (mais seguro)

Instância A (Comercial)  → Proxy IPv4 #1 (R$ 18)
Instância B (Suporte)    → Proxy IPv4 #2 (R$ 18)
Instância C (Cobrança)   → Proxy IPv4 #3 (R$ 18)

Quando usar: operação crítica (atendimento ao cliente), números com volume alto, cada número tem dono/função distinto. Zero risco de correlação.

Abordagem 2: N instâncias = 1 proxy (escalável)

Instâncias A, B, C (mesma equipe) → Proxy IPv6 (R$ 12)

Quando usar: números da mesma operação, mesmo dono legal, mesmo contexto (ex: 5 vendedores de uma loja). WhatsApp tolera IPs compartilhados entre números da mesma "organização" — porque espelha residência/escritório onde várias pessoas usam a mesma rede.

Limite prático: 3-5 instâncias por IP em produção. Mais que isso, o padrão começa a parecer bot-farm.

No Proxy Brasil você escolhe:

IPv4 R$ 18 — 1 proxy = 1 instância crítica
IPv6 R$ 12 — 1 proxy = até 5 instâncias correlacionadas

Boas práticas pra não cair ban

Proxy é necessário mas não suficiente. Pra operação longa sem perder conta:

1. Device fingerprint único por instância

No Baileys, seta browser diferente por instância:

browser: ['Chrome (Linux)', 'Chrome', '120.0.0.0']
// Instância 2:
browser: ['Firefox (Windows)', 'Firefox', '115.0.0.0']
// Instância 3:
browser: ['Safari (macOS)', 'Safari', '17.0']

browser: ['Chrome (Linux)', 'Chrome', '120.0.0.0']
// Instância 2:
browser: ['Firefox (Windows)', 'Firefox', '115.0.0.0']
// Instância 3:
browser: ['Safari (macOS)', 'Safari', '17.0']

2. Aquecimento de conta

Antes de disparar mensagens, use o número uma semana como humano:

Envia mensagens pra conhecidos
Recebe mensagens de outros
Participa de grupos
Atualiza foto, status

Conta "virgem" que começa com 100 mensagens em 1 hora = ban quase garantido.

3. Ritmo humano em disparos

// MAU: 100 mensagens em 30 segundos
for (const num of lista) {
  await sock.sendMessage(num, { text: msg })
}
 
// BOM: rate limit com jitter
for (const num of lista) {
  await sock.sendMessage(num, { text: msg })
  const delay = 8000 + Math.random() * 7000 // 8-15s aleatório
  await sleep(delay)
}

// MAU: 100 mensagens em 30 segundos
for (const num of lista) {
  await sock.sendMessage(num, { text: msg })
}
 
// BOM: rate limit com jitter
for (const num of lista) {
  await sock.sendMessage(num, { text: msg })
  const delay = 8000 + Math.random() * 7000 // 8-15s aleatório
  await sleep(delay)
}

4. Opt-in obrigatório pra disparo

LGPD e WhatsApp punem dispara-em-frio pra lista comprada. Disparo apenas pra quem deu opt-in explícito — idealmente com link de opt-in rastreado.

5. Monitoramento de sessão

Alertas se connection.update retornar state: 'close' com lastDisconnect.error.output?.statusCode === 401 (logged out — recomeça)
Alertas se QR refresh > 3x na mesma janela (sessão instável, pode ser proxy com queda)
Dashboard de status por instância (seu Evolution Manager já faz)

FAQ

Qual a diferença entre proxy brasileiro e proxy residencial?

Proxy brasileiro = IP com geolocalização BR. Pode ser de datacenter ou residencial. Proxy residencial = IP de operadora (Vivo, Claro, TIM, Oi) alugado/revendido — se parece tráfego humano normal. No Proxy Brasil, todos são residenciais brasileiros de operadora.

Quanto custa rodar 10 números com proxy dedicado?

Depende da estratégia:

10 instâncias × 1 proxy IPv4 dedicado = 10 × R$ 18 = R$ 180/mês (máxima segurança)
10 instâncias × 5 proxies IPv6 (2 números por IP) = 5 × R$ 12 = R$ 60/mês (economia)
10 instâncias × 2 proxies (5 números por IP) = 2 × R$ 12 = R$ 24/mês (agressivo, maior risco)

Proxy compartilhado não serve?

Não. Proxy compartilhado (que é oferecido barato em lojas de "proxy social") tem dezenas/centenas de usuários no mesmo IP. Se um desses manda spam, TODOS os números no IP pegam ban simultâneo. Nunca use compartilhado pra WhatsApp.

WhatsApp detecta proxy?

Proxy em si não é detectado como proxy pelo WhatsApp. O que o WhatsApp detecta é o tipo de IP: datacenter vs residencial. Proxy residencial dedicado brasileiro se parece com conexão de casa/escritório comum — invisível como "proxy".

Tenho que trocar o proxy se a conta cair?

Não necessariamente. Se a conta caiu por comportamento (spam, volume alto, aquecimento curto), o proxy tá limpo — reativa ele com novo número. Se caiu por reputação de IP (raro em dedicado), abra ticket e nós trocamos.

Proxy serve também pra WhatsApp Business oficial?

A API oficial do WhatsApp Business Platform (Cloud API da Meta) não precisa de proxy — a Meta hospeda a conexão. Proxy só faz sentido com APIs não-oficiais que conectam via Baileys.

Conclusão

Proxy brasileiro dedicado não é opcional quando você roda Evolution API, Baileys, WAHA ou qualquer API não-oficial em produção. Define a diferença entre uma operação estável por anos e um ciclo eterno de bans + números novos.

Comece com 1 proxy por instância crítica e expanda pra multi-instância conforme a operação amadurece. O custo por número produtivo é baixíssimo perto do custo de reaver uma conta banida (cliente perdido, chip novo, aquecimento de dias).

Pronto pra configurar? Crie sua conta no Proxy Brasil, adicione saldo via PIX, compre IPv4 R$ 18 ou IPv6 R$ 12, e conecte no teu Baileys/Evolution em 2 minutos.