Wafly › Tutoriais › Erro 463 no WhatsApp

Erro 463 no WhatsApp: o que é e como resolver

Por Iago Velasco, fundador da Wafly · Publicado em 5 de setembro de 2026

Quem integra WhatsApp por API costuma encontrar o 463 do pior jeito: o envio para um lead novo volta com erro, o mesmo código funciona para o cliente antigo, e a primeira suspeita é que o número foi banido ou que a API quebrou. Nenhuma das duas. Este artigo explica o que o código significa, como confirmar em dois minutos e o que muda no seu fluxo para o erro parar de aparecer.

O que significa o erro 463

O 463 é devolvido pelo servidor do WhatsApp no momento do envio de uma mensagem individual quando o destinatário não tem nenhuma interação anterior com o número que está enviando. A mensagem é recusada antes de sair. Ela não fica pendente, não é entregue depois e não aparece para o destinatário.

Três características ajudam a reconhecer:

• É por mensagem, não por conta. O mesmo número envia normalmente para quem já conversou com ele.
• Acontece na hora. O erro vem na resposta do envio, não minutos depois em um relatório de entrega.
• Não muda o estado da sessão. A instância continua conectada, recebe mensagens e responde quem escreve primeiro.

Na prática, o WhatsApp está protegendo o destinatário de abordagem fria vinda de uma conexão que não é o aplicativo oficial. Isso vale para qualquer API não oficial, seja gerenciada ou hospedada por você.

463 não é ban: como diferenciar

Os códigos que aparecem no log de uma instância de WhatsApp contam histórias diferentes. Confundir um com o outro leva a decisões erradas, como trocar o número ou reiniciar tudo.

Se o painel mostra a instância conectada e só alguns envios falham, é 463. Se todos os envios falham e a instância aparece desconectada, o problema é outro e tem um artigo próprio: por que o WhatsApp bane números de API.

Por que só aparece em números frios

Desde que o WhatsApp endureceu a proteção contra spam, a entrega de uma primeira mensagem passou a depender de um sinal de que o destinatário aceita aquela conversa. O aplicativo oficial gera esse sinal sozinho. Uma conexão de API não oficial só passa a ter esse sinal depois que existe uma troca real: o contato mandou mensagem, respondeu ou salvou o número.

É por isso que o 463 aparece em três situações típicas:

• Disparo para uma lista de leads que nunca falaram com a empresa.
• Número novo, sem histórico, usado para prospecção.
• Primeira mensagem de um fluxo automático (boas-vindas, confirmação) para alguém que preencheu um formulário mas não escreveu no WhatsApp.

E não aparece quando o contato já conversou com o número, mesmo que a última troca tenha sido meses atrás. Na operação da Wafly, o padrão é claro: mensagem para quem tem histórico entra; mensagem para lead totalmente frio recebe 463. Não é uma limitação de fornecedor, é o limite da plataforma.

Checklist de 2 minutos

1. A instância está conectada? Se não está, não é 463. Reconecte primeiro.
2. Envie para um número que já conversou com você. Se entrega, a sessão está saudável.
3. Envie para o número que deu erro a partir do seu celular, pelo aplicativo. Se entrega pelo aplicativo e não pela API, é 463.
4. Olhe o log ou o webhook. O código 463 vem na resposta do envio. Se a sua API não devolve o motivo, você só vê "não enviada".
5. Conte quantos dos erros são para contatos novos. Se forem todos, o diagnóstico está fechado.

O que fazer

1. Faça o contato iniciar a conversa. Um link wa.me/55DDDNUMERO?text=... com texto pré-preenchido na landing page, no e-mail ou no anúncio resolve a maior parte dos casos. A partir da primeira mensagem dele, o seu fluxo automático funciona sem 463.

2. Use um número com histórico para o primeiro contato. Um número que já atende clientes há meses entrega para muito mais gente do que um chip novo. Se você tem vários números, reserve o mais antigo para primeiras mensagens e os novos para conversas já abertas.

3. Trate o 463 como resposta final, não como falha temporária. Marque o contato como "aguardando iniciativa" no seu CRM e dispare outro canal (e-mail, SMS, ligação) pedindo que ele escreva no WhatsApp.

4. Reduza o volume de primeiras mensagens. Muitos 463 seguidos são um sinal de abordagem em massa. Isso não gera o ban por si só, mas caminha na direção errada.

5. Se o primeiro contato frio é essencial para o negócio, use a API oficial para essa etapa. Mensagens de utilidade e autenticação pela Cloud API da Meta são pagas por mensagem, mas chegam. Compare as duas em API oficial vs não oficial.

O que não adianta

• Reiniciar a instância ou gerar um QR novo. A sessão não é o problema.
• Retentar o mesmo envio em loop. Cada tentativa é outra recusa e piora a reputação do número.
• Trocar de fornecedor de API. A regra é do WhatsApp. O que muda entre fornecedores é se o erro chega nomeado ou se a mensagem some em silêncio.
• Trocar o texto da mensagem. O conteúdo não é avaliado nesse ponto; a recusa acontece antes.

Como a Wafly trata o 463

O 463 não desaparece com a Wafly, mas ele deixa de ser invisível. Quando um envio é recusado, o motivo volta nomeado na resposta da API e no webhook de status, o evento fica registrado na linha do tempo da instância e o painel mostra um aviso para o dono do número. Não há retentativa automática, justamente para não queimar o número.

Na prática, isso muda o que a sua automação faz: em vez de esperar uma entrega que nunca vai acontecer, o fluxo lê o código, marca o contato e segue para o próximo passo. Se você usa n8n, a integração está descrita em como integrar WhatsApp no n8n, e o formato do webhook de status em webhook de WhatsApp.

Perguntas frequentes

Continue

WhatsApp e Meta são marcas de seus respectivos donos, sem relação com a Wafly. Este texto descreve o comportamento observado na nossa própria operação e em relatos públicos, e não constitui garantia: as regras de entrega do WhatsApp mudam sem aviso. Encontrou algo desatualizado? Fale com a gente.