Caderno de pesquisa · 18/10/2026 · GoWA · WAHA · whatsmeow

Como não perder o número usando GoWA e WAHA

Os dois rodam o WhatsApp Web não oficial — GoWA direto no whatsmeow (Go), o WAHA com engines trocáveis, incluindo a mesma lib no modo GOWS. O que decide se o número sobrevive não está no código deles: está no comportamento que chega até a Meta. Este caderno reúne o que os mantenedores, as docs e a comunidade documentam em 2026.

4 camadas de detecção erro 463 · timelock erro 475 · capping sem garantia
6,8 mi
contas banidas pela Meta no 1º semestre de 2025 — a maioria empresas, não spammers
14 dias
é o aquecimento recomendado antes de qualquer volume maior que 100–200 msgs/dia
2–30 s
janela de jitter recomendada entre mensagens; intervalo fixo é assinatura de bot
463 / 475
shadow-restriction e cota de novos contatos — sinais para pausar, não para re-parear

TL;DR

01

Três perdas diferentes (e só uma é o número)

O pânico geralmente vem da confusão entre “a sessão caiu” e “a conta caiu”. O WAHA documenta dois estados de shadow-restriction que mantêm a sessão WORKING — é exatamente o que o erro 463 do GoWA aponta.

Logout remoto sessão

Alguém removou o aparelho no celular (WhatsApp → Dispositivos conectados). O número não foi banido — só o companion foi deslinkado. Re-parear com QR resolve.

GoWA: evento REMOTE_LOGOUT · WAHA: status FAILED

Reachout Timelock 463

A conta é shadow-restringida por iniciar chat com contatos novos demais. A sessão segue conectada e WORKING. A restrição some sozinha em timeEnforcementEnds.

WAHA: GET /api/sessions/{s}/timelock · GoWA: erro 463 distinto

Message Capping 475

Cota por ciclo de mensagens para novos contatos (ex.: 1.000/ciclo). Chega em avisos: FIRST_WARNING → SECOND_WARNING → CAPPED. Reseta no cycleEnd.

WAHA: GET /api/sessions/{s}/capping

Regra de ouro das duas restrições

Não reinicie, não faça logout e não re-pareie a sessão. A restrição é server-side e não se limpa com QR novo — re-parear só troca o device e recomeça a reputação. Enquanto durar: pause outreach a contatos novos; chats já existentes continuam funcionando.

02

O que a Meta mede: 4 camadas

O motor de ban é cumulativo: cada sinal vira peso negativo numa pontuação de confiança. Não existe gatilho único — existe acúmulo até cruzar o limiar, e aí o ban é instantâneo. Vale para GoWA e WAHA igual, porque por baixo o protocolo é o mesmo.

L1 Impressão digital

Onde você conecta. IP fora da região do número, IP de datacenter/VPN compartilhada, chip VoIP em vez de SIM físico, fingerprint de dispositivo. Um número BR saindo de servidor na Europa é sinal em toda sessão.

L2 Comportamento

Como você envia. Taxa de resposta, velocidade, volume, contatos novos, rajada de chats inéditos, grupo em massa, checagem em massa de existência. É onde a maioria dos bans começa.

L3 Bloqueios e denúncias

O que os destinatários fazem. Bloqueio/report por mil mensagens acima de ~2% derruba a classificação de qualidade para Baixa; se não recuperar em 7 dias, escala para restrição de conta.

L4 Metadados de conteúdo

Sem ler o texto (é E2E). Mesmo comprimento, mesmo anexo, mesmo link, mesma estrutura para muitos destinatários = padrão de broadcast. Mesmo arquivo de mídia repetido = mesmo hash. 15+ mensagens estruturalmente idênticas/hora já acumula sinal.

Novidade de 2026

Entrou um contador de mensagens sem resposta em 48 h, acumulado numa janela móvel de 30 dias. Engajamento ruim de três semanas atrás ainda pesa na confiança de hoje — higiene de lista (remover quem parou de responder) virou rotina semanal, não só pré-campanha.

03

Números de referência

Estimativas testadas pela comunidade (não são dados oficiais da Meta — o WhatsApp não publica limites). Use como régua de calibragem, não como contrato.

SinalZona seguraZona de perigo
Taxa de resposta≥ 30% (meta: 50%)< 15%
Velocidade< 30 msgs/hora> 60 msgs/hora
Volume diário (maduro, 3+ semanas)< 200/diapicos sem histórico
Número novo (primeiros 10 dias)20–50/dia200+/dia
Taxa de bloqueio< 1%≥ 2% (qualidade cai p/ Baixa)
Intervalo entre enviosjitter aleatório (2–30 s)fixo, ex. 500 ms
Estrutura de mensagempersonalizada, varia comprimento15+ idênticas/hora
IP de conexãomesma região do númerodatacenter/VPN em outro país
Chats novosfatia pequena do tráfegorajada de conversas inéditas
Atividade sem mensagemgrupos e checks graduaiscria/add em massa, check de 100k
04

Aquecimento: a rotina de 14 dias

Consenso entre Green API, Whapi e guias de 2026: número novo é o mais vigiado nos primeiros 10 dias. A curva abaixo junta a sequência do Green API com o cronograma da Whapi. Banido = aquecimento zerado: recomeça do início.

Dia 0

Registrou, esperou. ~24 h de pausa entre criar a conta no celular e parear o primeiro device (QR/multidevice). Parear na hora do registro é um dos sinais clássicos.

Dias 1–3

20–50 mensagens/dia, só contatos conhecidos. Foco em conversas que geram resposta. Também receber mensagens conta: 1 a cada ~2 h vindo de outros números.

Dias 4–7

50–100/dia e começar a responder. Expande para opt-in. Rampe devagar (no Green API: de 12 a 100 no período). Mantém taxa de resposta ≥ 30%.

Dias 8–14

100–200/dia. Confere a classificação de qualidade antes de esticar: Alta/Média é o sinal verde. Volume operacional “normal” chega entre o dia 10 e o 14.

Dia 10+

Muito mais resistente. Ponto de observação da comunidade: o WhatsApp dá “luz verde” entre 25 e 30 dias sem atividade suspeita.

Depois

Escala com disciplina: < 200/dia por número maduro, janela ativa de ~8 h (nada de 24/7), ritmo de ≤ 1 msg/min em lote, orçamento separado para chats novos.

Se o número foi bloqueado antes

Ao trocar por outro número: troque o IP/proxy, sessão limpa (sem vínculo com a conta anterior), de preferência aparelho diferente (bans por IMEI existem), não copie foto/nome/bio do anterior e faça warm-up completo de novo. Número novo no IP sinalizado herda parte do risco.

05

GoWA: o que o maintainer diz

O GoWA é um cliente não oficial em cima do whatsmeow. A resposta de 25/07/2026 do próprio aldinokemal numa thread sobre limites é a peça mais honesta do assunto — e vale como política operacional.

“Não existe limite deste lado, e eu não posso confirmar nenhum número como seguro. Um pedido de envio vai direto ao WhatsApp, sem fila, sem throttle e sem delay — o que você empurra pela API é exatamente o que o WhatsApp vê. Quem te promete um número diário ‘seguro’ está chutando.”

aldinokemal · discussion #667 · 25/07/2026 (tradução)

O que realmente bloqueia

Não é o número bruto por dia, é: mandar para quem nunca te escreveu, destinatário apertar Bloquear/Denunciar, corpo idêntico para muitos, e número novo ou recém-re-pareado já em volume no dia 1.

463 é freio, não retry

O GoWA expõe o 463 como erro distinto — é o reach-out timelock do WhatsApp para chat novo. Retentar piora. Pare o outreach frio e espere.

O que fazer do seu lado

Ritmo no chamador (o GoWA não tem rate limiter embutido), priorizar quem abriu a conversa, variar conteúdo, aquecer por dias, e opcionalmente POST /send/chat-presence (digitando) antes de enviar.

Relatos da comunidade GoWA (discussion #489): número novo mandando 1 mensagem de teste para contato sem histórico → restrição quase imediata; recomendações que aparecem no tópico: usar WhatsApp Business, número antigo e ativo e delays aleatórios de 2–30 s. Na thread #667, um operador com ~300 contas relatou ~10 números bloqueados num mês rodando ~200 msgs/dia antes de reestruturar o ritmo.

06

WAHA: os freios já vêm embutidos

O WAHA é uma camada de cola sobre engines: GOWS (Golang, whatsmeow — o mesmo motor do GoWA), NOWEB (Baileys/TS), WEBJS/WPP (Chromium via Puppeteer). O ponto forte: o estado de restrição da conta é exposto por API.

Monitorar em vez de adivinhar

GET /api/sessions/{s}/timelock e GET /api/sessions/{s}/capping trazem o estado real direto do WhatsApp (também em me.reachoutTimelock / messageCapping). O engine GOWS re-consulta o timelock quando o WhatsApp rejeita com 463.

Fluxo de resposta humana

A própria doc manda: sendSeen → startTyping (intervalo aleatório proporcional ao tamanho) → stopTyping → sendText. E nunca iniciar conversa — provocar o opt-in com link wa.me.

Proxy por sessão

config.proxy por sessão permite fixar o IP na região do número — ataca direto o sinal L1. Uma sessão por número, device name de navegador real (Chrome, Firefox, Edge…).

Middleware antiban (experimental)

Existe o waha-antiban: reverse-proxy entre o cliente e o WAHA que aplica rate limit com jitter gaussiano, warm-up de 7 dias, penalidade maior p/ desconhecidos, monitor de entrega/resposta e “entropia humana” (typing/leitura/presença em background). Engine-agnostic. Status do próprio repo: WIP, não usar em produção.

Faça

  • Perfil completo (foto, nome, status) — remetente sem cara é marcado como spam
  • Texto variado, com o primeiro nome, quebrado em mensagens curtas
  • Rodapé com opção de sair (“responda SAIR para parar”)
  • Maior parte do tráfego com quem já tem thread aberta
  • Grupos e checagens em lote no mesmo ritmo dos envios

Evite

  • Disparar 24/7 sem pausas — 1 h de atividade, pausa, recomeça
  • Mesmo link em todas as mensagens (padrão de phishing)
  • Mesmo arquivo de mídia repetido (mesmo hash)
  • Intervalos mecânicos fixos
  • Checagem de existência em massa num número recém-aquecido
07

Infra e sessão: o que derruba por fora do comportamento

Uma sessão por número

“Double activity” — várias sessões/dispositivos simultâneos — é flag de segurança. Encerre sessões antigas antes de abrir novas. Um número, um companion ativo.

Portas fechadas

Expor REST, WebSocket, painel ou página de QR na internet permite correlação IP do servidor ↔ conta e varredura de rotas conhecidas (WAHA/Evolution). Reverse proxy + auth, nunca 0.0.0.0 aberto.

Engines atualizados

Mudança de protocolo → loop de reconexão → rajada anômala do mesmo IP. Manter whatsmeow/WAHA em dia reduz o storm; re-parear é operação com humano no loop (QR).

Celular na tomada

O companion cai quando o celular remove o aparelho, fica dias offline ou o protocolo muda. Sem o telefone ativo, não há sessão — e re-parear reseta a reputação do device.

Re-pareou? É número “novo”

Device recém-linkado entra no balde de risco: comece devagar de novo. Vale para primeiro pareamento (espera de ~24 h pós-registro) e para re-pareamento.

Backup fora do WhatsApp

Contatos no CRM, não só no app. Extensão wa.me / WhatsApp Web como plano B humano. Número de produção crítica: planeje a portabilidade para a Cloud API oficial (o número atual pode ser mantido).

08

Caso real: o CRM Gestão Bem + GoWA

O que aconteceu no número GESTÃO BEM é o retrato de “parece ban, não é ban”. Registro do diagnóstico de 18/10/2026.

A sequência

15/10, 14:00 BRT — REMOTE_LOGOUT: alguém no celular removeu o aparelho. 18/10, 10:21 — de novo. Antes disso, um erro 463. Lote de 14/10: 31 falhas de uma vez (a sessão já estava caída). 35 de 39 falhas recentes = device desconectado.

O que isso ensina

Logout remoto não é ban — o número segue vivo e recuperável com QR. Mas derruba a entrega em lote e inflaciona o painel com falhas iguais. Monitorar presença e reconectar rápido vale mais que qualquer “truque” anti-ban. O teto diário do CRM (WHATSAPP_DAILY_LIMIT=100) já era o freio certo; a extensão wa.me ficou como backup humano para o lote de homologação.

09

Se o número cair: triagem em ordem

    1 · Diagnóstico

    Tem contador regressivo na tela do app? Sim → ban temporário (24–72 h), expira sozinho. Sem contador → permanente (recursos têm < 20% de sucesso).

    2 · Restrita?

    Chats antigos funcionam e novos falham (463/475 ou FAILED em número novo)? É a conta restrita: pause chats novos, mantenha as threads, espere o timer. Não troque de número.

    3 · Não mexa

    Não reinicie/logout/re-pareie por causa de 463/475/restrição — não limpa e recomeça reputação de device. No WAHA, me.reachoutTimelock e me.messageCapping mostram o estado real.

    4 · Banido de verdade

    Recurso: botão “Solicitar revisão” no app (caminho mais rápido) e whatsapp.com/contact. Seja objetivo: caso de uso legítimo, opt-in, sem promessas.

    5 · Número novo

    IP/proxy novo, sessão limpa, aparelho diferente se possível, nada de copiar foto/nome/bio, warm-up completo (mínimo 2–7 dias, ideal 14) e nunca day-one em volume.

10

Checklist de operação

Para colar no README do produto que roda GoWA ou WAHA.

Sem bala de prata

GoWA e WAHA são clientes não oficiais: usá-los contraria os termos do WhatsApp, e a Meta intensificou a fiscalização em 2026 — no Brasil já houve perda de número, histórico e contatos. Nenhuma técnica aqui garante imunidade; o conjunto reduz risco. Se o número precisa de garantia e SLA, o caminho é a Cloud API oficial — o número atual pode ser portado e nada muda para o cliente.