Proxy brasileiro e IP dedicado por número
Cada número da apiwpp sai por um IP brasileiro, com proxy incluso. Use também o seu próprio proxy ou contrate um IP dedicado por número no plano PRO.
Atualizado em
Para o WhatsApp, cada número conectado aparece a partir de um endereço IP. Quando centenas de sessões saem do mesmo IP de um data center, o padrão lembra uma fazenda de contas, e isso é um sinal conhecido de risco. Por isso, na apiwpp, cada número sai por um proxy, e você escolhe entre três opções: o proxy brasileiro incluso no plano, o seu próprio proxy ou um IP dedicado.
Por que o IP importa para a reputação do número
O WhatsApp usa vários sinais para decidir se um número se comporta como uma pessoa ou como um robô. O endereço de onde a sessão se conecta é um deles:
- Rede de hospedagem x rede de provedor. Um IP de data center é claramente de servidor. Um IP fixo de um provedor de internet brasileiro se parece com a conexão de qualquer pessoa no país.
- Quantos números dividem o IP. Muitos números saindo do mesmo endereço sugerem operação em massa. Poucos números, do mesmo dono, não.
- Estabilidade. Um IP que muda no meio da sessão é, ele próprio, um gatilho de detecção. Por isso a apiwpp nunca troca o IP de uma sessão ativa sem motivo.
- Vizinhança. Se outra empresa no mesmo IP faz spam, o problema pode respingar em você. Por isso um IP do pool nunca é dividido entre clientes diferentes.
Nenhum proxy transforma um envio ruim em um envio bom. O IP é uma camada de proteção ao lado da fila com ritmo anti-bloqueio e do aquecimento de 14 dias, e nada garante que um número nunca será restringido pelo WhatsApp.
Proxy brasileiro incluso em todos os planos
Nos planos LITE e PRO, cada número recebe um proxy do pool da apiwpp:
- IPs fixos de provedores de internet no Brasil, e não de hospedagem.
- Um cliente por IP. O mesmo endereço é compartilhado só entre alguns números do mesmo cliente, nunca com números de outra empresa.
- Verificado antes do QR code. Antes de mostrar o QR code ou o código de pareamento, a apiwpp confere por onde a conexão sai. Nenhum número é pareado a partir de um IP não verificado.
- Monitorado. O pool passa por verificações periódicas. Se um proxy para de responder, os números dele são reconectados por outro, numa reconexão planejada.
Você não precisa configurar nada: o proxy é escolhido quando o número é conectado.
Seu próprio proxy por número
Se você já tem proxies contratados, ou precisa que um número saia por um endereço específico, configure o proxy de cada conexão pela API com PUT /connections/{id}/proxy e uma chave com o escopo connections:write:
curl -X PUT https://api.apiwpp.com/connections/$CONNECTION_ID/proxy \
-H "Authorization: Bearer $APIWPP_KEY" \
-H "Content-Type: application/json" \
-d '{ "url": "socks5://usuario:[email protected]:1080", "country": "BR" }'
- Protocolos aceitos:
socks5://,socks5h://,http://ehttps://, com usuário e senha opcionais. - Verificação antes de salvar. A apiwpp faz uma requisição pelo proxy e confere por onde ele sai. Com
country, também confere o país. Se a verificação falhar, a resposta é422e diz o motivo: sem resposta, credenciais recusadas ou saída em outro país. - Tudo passa pelo proxy. A sessão do WhatsApp, o envio de mídia e o download dos arquivos saem pelo mesmo endereço, sem desvio.
- A URL fica guardada criptografada e nunca volta nas respostas.
GET /connections/{id}/proxymostra só o esquema, o host, a porta e o IP de saída verificado. - Trocar o proxy de um número conectado faz uma reconexão planejada pelo novo endereço, sem pedir QR code de novo.
Para que o número use o proxy desde o primeiro acesso, informe-o ao criar a conexão. DELETE /connections/{id}/proxy remove o proxy próprio.
IP dedicado por número (PRO)
O IP dedicado é um endereço fixo de provedor brasileiro usado por um único número. É um adicional do plano PRO, contratado número a número:
- entra na mesma assinatura da organização, na mesma fatura dos números;
- ao ser contratado no meio do mês, o restante do mês é cobrado de forma proporcional;
- o valor por número está na página de preços, e a calculadora mostra o total com os IPs dedicados.
No LITE, o IP dedicado não está disponível: o número usa o proxy compartilhado do pool ou o seu próprio proxy.
Quando vale a pena
- Números que concentram a operação, como o número principal de atendimento ou de notificações, que você quer isolar de tudo.
- Agências, que preferem que o número de um cliente nunca divida IP com o de outro cliente da própria agência. Veja o caso de uso de agências.
- Volume alto por número, perto dos limites diários da fila.
Para a maioria dos números, o proxy incluso já resolve. O IP dedicado é uma camada extra, não uma condição para usar a API.
Perguntas frequentes
O proxy brasileiro custa à parte?
Não. O proxy compartilhado do pool está incluso nos planos LITE e PRO, em todos os números. Só o IP dedicado é um adicional pago, e apenas no plano PRO.
Posso usar o meu próprio proxy no plano LITE?
Pode. O proxy próprio é configurado por conexão com PUT /connections/{id}/proxy e não depende do plano. A apiwpp verifica o proxy antes de salvar e guarda a URL criptografada.
Trocar o proxy desconecta o número?
A troca faz uma reconexão planejada pelo novo endereço. A sessão continua salva, então o número volta sem novo QR code e sem reiniciar o aquecimento.
O IP dedicado evita que o número seja bloqueado?
Não existe garantia contra bloqueio. O IP dedicado tira o risco de dividir o endereço com outros números, mas o que mais pesa é como o número envia: ritmo, destinatários que esperam a mensagem e conteúdo. A fila e o aquecimento continuam valendo com qualquer IP.
Outros recursos
Todos: Recursos →Nos 14 dias depois de conectado, cada número segue limites menores de envio e de destinatários novos, que sobem em cinco etapas. A fila aplica tudo sozinha, e o estado do aquecimento aparece em GET /connections/{id}/queue.
Cada número conectado tem uma fila que envia no ritmo de uma pessoa: limites por minuto, hora e dia, intervalo aleatório entre envios e um teto de destinatários novos por dia. Mensagens ilimitadas dentro desses limites.
Depois do pareamento, a sessão do número fica salva e criptografada nos servidores da apiwpp. Reinícios, atualizações e quedas de rede não pedem um novo QR code, e o celular não precisa ficar ligado.