Mensagem recusada pelo WhatsApp (erro 463)

Às vezes o painel aceita o envio e, segundos depois, a mensagem aparece como falhou no histórico. Quando o motivo é o erro 463, o WhatsApp recusou a mensagem porque ela era um primeiro contato: a pessoa ainda não tinha conversa com o seu número.

As duas situações

Primeiro contato bloqueado. Só aquele contato não recebeu. O WhatsApp não liberou a primeira mensagem para quem nunca falou com o número. O histórico mostra o motivo FIRST_CONTACT_BLOCKED.

Número restrito. O WhatsApp restringiu o seu número, por um tempo, para iniciar conversas novas. Enquanto durar, nenhum contato novo recebe mensagens. O card da instância, na tela Instâncias, mostra o aviso "WhatsApp restringiu este número", com a previsão de fim quando o WhatsApp informa. O histórico mostra o motivo ACCOUNT_RESTRICTED.

Nas duas situações, as conversas que já existem continuam funcionando.

Não reenvie

Não mande de novo a mensagem que falhou. Para o WhatsApp, cada tentativa é mais um contato novo, e insistir é o que leva à restrição do número ou faz ela durar mais. O DevZap também não reenvia sozinho.

O que fazer

1. Peça para o contato mandar a primeira mensagem. Com a conversa aberta por ele, as suas mensagens passam a chegar. Um link https://wa.me/55DDDNUMERO no site, no e-mail ou no boleto ajuda.
2. Peça para o contato salvar o seu número na agenda.
3. Use um número antigo e aquecido, que já conversa com clientes há tempo. Número novo ou parado há muito tempo recebe mais recusas.
4. Mande para poucos contatos novos por hora, espalhando ao longo do dia em vez de disparar tudo de uma vez.
5. Evite cobrança seca como primeira mensagem. Apresente-se, diga de onde vem o contato e dê uma forma fácil de responder.
6. Se o número estiver restrito, pare os primeiros contatos até o fim da restrição e continue atendendo quem já conversa com você.

Para quem integra pela API

O webhook message.failed traz o motivo em errorCode (FIRST_CONTACT_BLOCKED, ACCOUNT_RESTRICTED ou DELIVERY_FAILED), e a rota GET /instances/{id}/limits mostra se o número está restrito. Veja o guia Erro 463.

← Todos os guias