SuperdindaDocs

Número banido

O WhatsApp restringiu o número de uma pessoa protegida — como reconhecer, o que olhar primeiro e o que não fazer.

Em aberto

O código não tem um sinal próprio de ban. Para nós, um número banido aparece como uma sessão que caiu e não volta: FAILED → degraded → 3 tentativas → disconnected. Também não há onde registrar "este número foi banido". Este runbook é o procedimento manual até isso existir.

Sintomas

  • A sessão segue o caminho de Sessão caiu e termina disconnected.
  • Um novo pareamento não completa, ou cai de novo logo em seguida.
  • A pessoa relata, pelo responsável, um aviso do WhatsApp no próprio celular.

Confirmar

  1. Linha do tempo da vaga (GET /admin/seats/<seat-uid>/timeline): quedas provider.failed repetidas, inclusive depois de pareamentos novos.

  2. A confirmação real vem do celular da pessoa: o próprio app do WhatsApp diz se o número está restrito. Nós não lemos nada do aparelho.

  3. Primeira pergunta depois de um ban: em qual endereço estava e quem mais estava lá.

    API=https://api.superdinda.com
curl -s "$API/admin/proxies" -H "Authorization: Bearer <ADMIN_ACCESS_TOKEN>"
curl -s "$API/admin/proxies/<proxy-uid>/bindings" -H "Authorization: Bearer <ADMIN_ACCESS_TOKEN>"

    A rota de bindings mostra só os vínculos vivos; o histórico (com released_reason) fica na tabela proxy_bindings.

O que o sistema faz sozinho

Nada específico de ban: o backoff de reconexão, a desistência com notificação pairing.disconnected ao responsável e a sessão apagada no WAHA.

Passos

  1. Não insista em parear. A pesquisa pede evitar repareamento, e cada código pedido conta contra o número (o produto já para em 5 por pareamento).
  2. Olhe os vizinhos de endereço. Outras sessões do mesmo IP caindo ou com queda recente: drene o endereço (status: "draining", reversível) e avalie queimar.
  3. Confira se o endereço ainda é o que a compra prometeu: refaça a sonda (POST /admin/proxies/probe) e veja se o tipo detectado ou o registro mudou.
  4. Registre o caso (vaga, endereço, data, vizinhos) fora do sistema até existir ferramenta.

A pesquisa sugere, para reativar números após restrição, 1–2 portas de proxy móvel 4G/5G (o schema já aceita kind: "mobile"). Não há fluxo para isso.

Quando escalar

  • Dois ou mais bans no mesmo endereço → trate o endereço como queimado.
  • Bans em endereços diferentes do mesmo fornecedor → reveja o fornecedor (a pesquisa recomenda ter um segundo).
  • Bans recorrentes com endereços cheios → reveja PROXY_SEATS_PER_IP para baixo.

Fontes

  • backend/src/domains/channels/use-cases/apply-provider-state.ts, refresh-challenge.ts (MAX_CODES_PER_PAIRING)
  • backend/src/http/routes/admin/proxies.route.ts ("the first question after a number gets banned"), backend/src/domains/proxies/tables/index.ts
  • backend/src/domains/proxies/use-cases/probe.ts, backend/src/config/env.ts
  • Vault: AD-002, research/2026-09-11-whatsapp-nao-oficial (anti-ban), research/2026-09-11-proxies-residenciais-br (mobile, dois fornecedores)

Sessão caiu

Um WhatsApp pareado parou de responder — como confirmar, o que o sistema já faz sozinho e quando agir.

Proxy queimado

Um endereço do pool começou a ser recusado pelo WhatsApp — como confirmar, drenar ou queimar, e o que acontece com as famílias que estavam nele.

On this page

SintomasConfirmarO que o sistema faz sozinhoPassosQuando escalarFontes