Empresa brasileira · Entrega automática · Suporte em português Seg a sex, 9h as 18h · PIX em reais
ProxyBox
API de WhatsApp · Começar

Restrição 463 do WhatsApp: o que é, o que a trava faz e o que fazer

O que é a restrição a contatos novos do WhatsApp (463), como a API reage com a trava de 6 horas e o que fazer enquanto ela dura.

6 min de leitura Atualizado em 14 de novembro de 2026

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:

  1. Responde o envio que levou o erro com 409 new_contacts_locked, com retry_after em segundos.
  2. Marca a instância com risco alto no painel e grava o fato no histórico.
  3. Envia o aviso number.restricted ao seu sistema (se você o marcou no aviso automático).
  4. 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_locked sem tentar.
  5. 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.

json
{ "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):

json
{ "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 /instance traz signal com level, label e until. Um level igual a warn significa restrito para contato novo.
  • O aviso number.restricted chega 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átis

O que fazer durante a restrição?

  1. Pare as filas de contato novo do seu lado. Mantenha só respostas a quem já escreveu.
  2. Leia o retry_after e só tente de novo depois dele.
  3. 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.
  4. Deixe o número quieto com contato novo até a restrição acabar. Responder a clientes que escreveram continua normal.
  5. 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

Í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.

Guias relacionados

Pronto para colocar no ar?

Comece no sandbox, grátis. Quando funcionar, contrate a instância do seu número e pague com PIX ou saldo.

Com IP brasileiro dedicado R$ 89,90/mês
Só a instância (traga o seu IP) R$ 39,90/mês
Travou em alguma etapa?Manda o print do erro no WhatsApp. Respondemos em português.
Suporte em português Fale no WhatsApp