Proxy na API não oficial do WhatsApp: quando usar e como configurar

Proxy na API não oficial do WhatsApp é opcional: ele serve para escolher de qual IP a sessão do seu número conversa com o WhatsApp. Vale usar quando você quer que a conexão saia do mesmo país do número, da rede da sua empresa ou de um IP estável que você controla. Na WAME, basta um POST /instance/proxy com a URL do proxy. O que proxy não faz é proteger um número que envia mensagem para quem não pediu — isso é comportamento, e comportamento o IP não esconde.

Este guia explica quando o proxy ajuda, qual tipo escolher, como configurar e quais erros transformam um recurso útil em mais um sinal de risco.

O que o proxy muda na sessão

A API não oficial conecta seu número da mesma forma que o WhatsApp Web: a instância abre uma sessão como se fosse um aparelho conectado. Todo aparelho real tem um endereço de rede, e esse endereço diz algo sobre ele — de que país vem, se é uma casa, um celular ou um servidor.

Sem proxy, a sessão sai pela infraestrutura da WAME. Com proxy, ela sai pelo IP que você configurou. É só isso: o proxy troca a origem da conexão. Ele não altera o que você envia, para quem envia nem em que ritmo.

Por isso vale ter clareza sobre o que já vem pronto. A plataforma existe desde 2017, roda mais de 50 mil instâncias e já cuida da camada de conexão para você:

• Identidade de dispositivo única por instância, coerente com o país do número — idioma e fuso batem com o DDI.
• Reconexão com backoff e variação aleatória, para que várias instâncias não reconectem todas juntas no mesmo segundo.
• Ritmo de envio com cara de gente: "digitando…" antes de cada envio e freio para fan-out e texto repetido.

O proxy entra por cima disso, quando você quer controlar também o IP. Se quiser entender a camada inteira, veja anti-detecção na API não oficial.

Quando vale usar proxy

Nem toda operação precisa. Os casos em que o proxy realmente faz diferença:

1. Número de um país, servidor em outro. Um número brasileiro que se conecta sempre de um IP de outro continente é um desenho estranho para um aparelho pessoal. Um proxy no Brasil deixa a origem coerente com o 55 do número.
2. Exigência de rede corporativa. Algumas empresas querem que todo tráfego saia de IPs próprios, por política de segurança ou auditoria.
3. Separar clientes. Se você é software house ou agência e opera números de clientes diferentes, dar a cada grupo de instâncias um IP próprio evita que o histórico de um afete a percepção sobre o outro.
4. IP estável que você controla. Quando você quer saber exatamente de onde cada número se conecta, para diagnosticar problemas.

Se nenhum desses casos é o seu, provavelmente você não precisa de proxy — e tudo bem.

Como configurar na WAME

A configuração é uma chamada. O formato recomendado inclui usuário e senha do proxy:

curl -X POST "https://us.api-wa.me/SUA_KEY/instance/proxy" \
  -H "Content-Type: application/json" \
  -d '{ "proxy": "http://usuario:[email protected]:8080" }'

Sem autenticação, o formato é o mesmo sem as credenciais:

curl -X POST "https://us.api-wa.me/SUA_KEY/instance/proxy" \
  -H "Content-Type: application/json" \
  -d '{ "proxy": "http://203.0.113.10:8080" }'

Para a sessão passar a usar o novo caminho, reinicie a instância:

curl -X POST "https://us.api-wa.me/SUA_KEY/instance/restart"

E confira se ela voltou conectada:

curl "https://us.api-wa.me/SUA_KEY/instance"

Os campos exatos da resposta estão na documentação. Uma boa prática é testar o proxy antes, de fora da API — um curl simples através dele para qualquer site — e só depois apontar a instância. Proxy fora do ar derruba a conexão do número, e você não quer descobrir isso com cliente esperando resposta.

Residencial, móvel ou datacenter?

Não existe um tipo "certo" para todo mundo, mas existe uma lógica:

O ponto que mais pesa, porém, não é o tipo: é a estabilidade. Um aparelho de verdade não muda de país a cada meia hora nem troca de IP a cada requisição. Proxies "rotativos", que mudam o endereço a cada conexão, fazem exatamente o contrário do que você quer para uma sessão de WhatsApp. Prefira um IP fixo (ou de sessão longa) por número.

Três regras para não piorar as coisas

1. Coerência entre IP e número

O número tem DDI; o IP tem país. Deixe os dois combinando. Número brasileiro, IP no Brasil. Número mexicano, IP no México. A identidade de dispositivo da instância já é montada coerente com o país do número — um proxy de outro país desfaz parte desse cuidado.

2. Poucos números por IP

Vinte números conversando a partir do mesmo endereço não parecem vinte pessoas. Distribua as instâncias em grupos pequenos por IP e mantenha cada número sempre no mesmo endereço. Trocar um número de proxy toda semana é pior que não usar proxy.

3. Mudança devagar

Se você for migrar uma instância que está funcionando bem para um proxy, faça isso uma vez, num horário calmo, e observe o comportamento nos dias seguintes. Mudanças bruscas — IP novo, volume novo, tipo de mensagem novo, tudo de uma vez — somam sinais.

O que proxy não resolve

Vale repetir, porque é a confusão mais comum: proxy não é ferramenta para disparo em massa. Os bloqueios de número acontecem, na enorme maioria das vezes, por comportamento:

• mensagem para quem não pediu e denuncia;
• volume muito acima do que uma pessoa enviaria;
• muitos contatos novos em pouco tempo (o famoso fan-out);
• insistir depois que o número já deu sinal de restrição.

Nenhum IP apaga uma denúncia. A WAME não apoia spam, e nenhuma camada técnica — proxy, identidade de dispositivo ou limite de ritmo — foi feita para esconder envio indesejado. Ela existe para que um uso legítimo não seja confundido com robô. Para quem usa do jeito certo, a taxa de bloqueio é muito baixa; para quem dispara lista comprada, proxy nenhum ajuda. Se quiser entender o que realmente derruba um número, leia o que derruba um número na API não oficial e os sinais de risco antes do bloqueio.

Um lembrete honesto: a camada não oficial não é afiliada ao WhatsApp nem à Meta, e o uso é de responsabilidade de quem envia. Se a sua operação exige garantia formal da Meta, o caminho é a API oficial — que, aliás, não usa proxy de sessão, porque não há sessão de aparelho.

Checklist rápido

Antes de configurar:

• Existe um motivo concreto (país, rede corporativa, separação de clientes)?
• O IP é do mesmo país do número?
• O IP é fixo ou de sessão longa, não rotativo por requisição?
• Cada IP atende poucas instâncias?
• Você testou o proxy antes de apontar a instância?

Depois de configurar:

• A instância reconectou e está estável?
• As entregas seguem normais nos dias seguintes (acompanhe em métricas de campanha)?
• O ritmo de envio continua o mesmo de antes?

Conclusão

Proxy é uma ferramenta de coerência, não de disfarce. Ele ajuda quando a origem da conexão precisa bater com o país do número, com a rede da empresa ou com a separação entre clientes — e é configurado com uma única chamada em /instance/proxy. Para a maioria das operações, a camada gerenciada da WAME já entrega identidade de dispositivo, reconexão espaçada e ritmo humano sem que você precise pensar em IP. Use proxy estável, do mesmo país e com poucos números por endereço, e lembre que o que mantém o número vivo é continuar enviando só para quem quer receber.