Recurso em beta: pode mudar. Esta é uma versão beta, em fase de testes.
Resposta curta: a restrição 463 (e a 475) é um bloqueio temporário em que o WhatsApp deixa de aceitar mensagens do seu número para contatos novos, mas mantém as conversas que já existem. A API reage travando os envios para quem nunca falou com o número, por cerca de 6 horas, e avisa você. Nada disso é garantia contra bloqueio.
O que é a restrição de contato novo?
O WhatsApp limita, por conta própria, quantas pessoas novas um número pode abordar. Quando considera que o número passou do que espera, ele responde com um erro (códigos 463 ou 475, também chamado de "reachout timelock") e o envio para quem nunca conversou com o número falha. Conversas com quem já escreveu para você, e grupos, seguem funcionando.
O WhatsApp não publica o limite exato nem o prazo. Quem opera APIs não oficiais descreve a mesma coisa: costuma aparecer quando um número recém-conectado, ou de pouco uso, tenta falar com muita gente nova em pouco tempo, ou quando há denúncias. A restrição tem um fim marcado, que o aviso informa em expires_at quando o WhatsApp o informa.
O que a trava faz, exatamente?
Quando o WhatsApp devolve a restrição, a API:
- Responde o envio que levou o erro com
409 new_contacts_locked, comretry_afterem segundos. - Marca a instância com risco alto no painel e grava o fato no histórico.
- Envia o aviso
number.restrictedao seu sistema (se você o marcou no aviso automático). - Liga a trava por cerca de 6 horas (renova se a restrição voltar). Nesse período, qualquer envio só vai para telefones vistos nos últimos 60 dias: quem recebeu uma mensagem sua ou escreveu para o seu número. Para qualquer outro telefone, a API responde
409 new_contacts_lockedsem tentar. - Não bloqueia grupos nem as respostas a quem já conversou.
O objetivo é impedir que o seu sistema continue batendo na restrição. Insistir em contato novo enquanto ela dura costuma prolongá-la. A trava não destrava nada: ela só evita que a insistência piore.
{ "ok": false, "error": "new_contacts_locked", "message": "O WhatsApp restringiu o envio para contatos novos neste número. Por enquanto, só dá para escrever a quem já conversou com você.", "retry_after": 20931 }
O aviso number.restricted tem esta forma (campos completos em aviso automático):
{ "event": "number.restricted", "uid": "rb_9f3a0c1d2e4b5a69", "data": { "reason": "reachout_timelock", "code": null, "expires_at": "2026-11-12T02:14:58Z" } }
Como saber que o número está restrito?
- O painel mostra o sinal da instância (ok, atenção ou ruim) e, quando restrita, até quando vai a trava.
GET /instancetrazsignalcomlevel,labeleuntil. Umleveligual awarnsignifica restrito para contato novo.- O aviso
number.restrictedchega ao seu sistema. - Os envios para contatos novos voltam
409 new_contacts_locked.
Quer rodar isto agora? O sandbox é grátis, não precisa de número e já vem com a chave da API.
Testar grátisO que fazer durante a restrição?
- Pare as filas de contato novo do seu lado. Mantenha só respostas a quem já escreveu.
- Leia o
retry_aftere só tente de novo depois dele. - Revise a origem: quem recebeu mensagem, com que texto, em que volume. Mensagem para quem não espera receber e conteúdo repetido são os motivos mais comuns de denúncia.
- Deixe o número quieto com contato novo até a restrição acabar. Responder a clientes que escreveram continua normal.
- Peça aos contatos para responderem. Quem responde a uma mensagem sua passa a ser "visto" e entra na lista dos que podem receber depois.
O que não fazer?
- Não troque de chip nem de instância só para escapar. A restrição é do número, e criar outra instância com o mesmo número só soma tentativas.
- Não reenvie em laço. Cada tentativa fora da lista é recusada pela API, mas laços no seu sistema só geram ruído e erro.
- Não use outro número para falar com a mesma lista de imediato; o WhatsApp pode ver o padrão.
- Não prometa ao cliente final uma hora de volta. O prazo é do WhatsApp.
- Não combine trocas de mensagens entre contas para "reforçar" o número. A ProxyBox não oferece esse tipo de serviço nem promessa de "anti-ban".
E se a restrição virar bloqueio?
A restrição é diferente do bloqueio. No bloqueio, o WhatsApp desconecta o número e o aviso number.logged_out chega. A ProxyBox não consegue desfazer o bloqueio e não reembolsa por ele (veja a página do produto). A prevenção continua sendo comportamento: consentimento, ritmo baixo, texto variado e número dedicado. As causas estão em WhatsApp banido: causas na API e no Business, e os limites que a API aplica estão em erros e limites.
Quais ajustes reduzem o risco?
| Ajuste | Por que ajuda |
|---|---|
| Ritmo menor que o padrão (no painel) | Menos pessoas novas por hora |
| Verificar números antes de enviar | Menos tentativas para quem não tem WhatsApp |
| Lista de não perturbe | Quem pediu para parar não recebe, e não denuncia |
| Texto variado e personalizado | Mensagens idênticas em volume são um sinal conhecido |
| Número dedicado e com histórico de uso | Número novo e sem histórico tende a ser o mais sujeito à restrição |
Nenhum deles é garantia. São o que a experiência de quem opera esse tipo de API aponta, e o que a ProxyBox consegue medir e limitar do lado dela.
Veja também
- Erros e limites da API de WhatsApp
- Não perturbe e recusar chamadas: API de WhatsApp
- Equipe, papéis e métricas da API de WhatsApp
Índice completo: documentação.
Autoria: equipe técnica da ProxyBox. Atualizado em 11/11/2026. Códigos 463/475 e a regra de 6 horas e 60 dias conforme a versão 1.1 da API, revisados em 11/11/2026.