---
title: "Proxy na API não oficial do WhatsApp: quando usar e como configurar"
description: "Quando vale configurar proxy na API não oficial do WhatsApp, qual tipo de IP escolher, como manter o país coerente com o número e por que proxy não salva spam."
url: "https://wame.api.br/blog/proxy-api-whatsapp-nao-oficial"
language: "pt-BR"
og:type: "article"
published_time: "2026-09-28"
modified_time: "2026-09-28"
author: "Raphael Serafim"
keywords: "api whatsapp não oficial, api não oficial whatsapp, proxy api whatsapp, proxy whatsapp api não oficial, ip residencial whatsapp, configurar proxy whatsapp, anti-detecção whatsapp api"
reading_time: "7 min de leitura"
---

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

> Quando vale configurar proxy na API não oficial do WhatsApp, qual tipo de IP escolher, como manter o país coerente com o número e por que proxy não salva spam.

**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](/blog/anti-deteccao-api-whatsapp-nao-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:

```bash
curl -X POST "https://server.wame.api.br/SUA_KEY/instance/proxy" \
  -H "Content-Type: application/json" \
  -d '{ "proxy": "http://usuario:senha@203.0.113.10:8080" }'
```

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

```bash
curl -X POST "https://server.wame.api.br/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:

```bash
curl -X POST "https://server.wame.api.br/SUA_KEY/instance/restart"
```

E confira se ela voltou conectada:

```bash
curl "https://server.wame.api.br/SUA_KEY/instance"
```

Os campos exatos da resposta estão na [documentação](/docs). 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:

| Tipo de IP | Como é visto | Quando faz sentido |
| --- | --- | --- |
| Residencial | Parece uma conexão de casa | Números de atendimento com perfil de pessoa ou pequena empresa |
| Móvel (4G/5G) | Parece um celular na rede da operadora | Perfil mais próximo de um aparelho real; costuma ser mais caro |
| Datacenter | IP de servidor, compartilhado por muitos serviços | Custo baixo, mas o tipo menos parecido com um aparelho pessoal |

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](/blog/api-whatsapp-nao-oficial-bane-o-que-derruba-numero) e [os sinais de risco antes do bloqueio](/blog/sinais-numero-whatsapp-risco-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](/blog/whatsapp-api-oficial-vs-nao-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](/blog/metricas-campanha-whatsapp-api))?
- 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.

## Perguntas frequentes

### Preciso de proxy para usar a API não oficial do WhatsApp?

Na maioria dos casos, não. Na WAME a conexão já é hospedada e gerenciada, com identidade de dispositivo própria por instância e reconexão espaçada. O proxy é opcional e faz sentido quando você quer que a sessão saia de um IP específico — por exemplo, do mesmo país do número ou da rede da sua empresa.

### Como configuro um proxy na instância?

Faça um POST em https://server.wame.api.br/SUA_KEY/instance/proxy com o corpo {"proxy": "http://usuario:senha@ip:porta"}. O formato sem autenticação, http://ip:porta, também é aceito. Depois reinicie ou reconecte a instância para a sessão passar a usar o novo caminho.

### Qual tipo de proxy é melhor: residencial, móvel ou datacenter?

Para uma sessão que imita um aparelho de pessoa real, IPs residenciais ou móveis combinam mais com o perfil de uso do que IPs de datacenter, que são compartilhados por muitos serviços automatizados. O mais importante, porém, é estabilidade: um IP que troca a cada minuto chama mais atenção que um IP fixo.

### Proxy evita bloqueio do número?

Não sozinho. O bloqueio vem principalmente de comportamento — enviar para quem não pediu, volume acima do humano, muitos contatos novos em pouco tempo. Proxy só evita que o IP seja um sinal a mais contra você. Com spam, nenhum proxy salva o número.

### Posso colocar várias instâncias no mesmo proxy?

Pode, mas com moderação. Dezenas de números saindo do mesmo IP criam um padrão que um aparelho real não teria. O recomendado é distribuir as instâncias em grupos pequenos por IP e manter cada número sempre no mesmo endereço.