Erros mais comuns e como resolver
O que a Meta retorna quando uma mensagem não sai, o que cada erro significa e o que fazer.
Quando uma mensagem não é entregue pela API Oficial, quem recusa é a Meta, não a SM Click. A plataforma mostra o retorno dela. Esta página traduz os mais frequentes.
Erros de entrega
Message Undeliverable — mensagem não entregue
A mensagem não chegou ao destinatário. Costuma ser um destes:
- Número inexistente ou desativado
- O contato bloqueou sua empresa
- O usuário não aceitou os Termos de Serviço do WhatsApp
- Aplicativo do destinatário muito desatualizado
O que fazer: confirme se o número está correto e ativo, e se aquele contato já interagiu com sua empresa antes.
Invalid Phone Number — número inválido
O número informado não está registrado no WhatsApp.
O que fazer: confira se tem código do país e DDD na ordem certa. Se persistir, confirme o contato por outro canal.
Something Went Wrong — falha genérica
Erro sem causa específica, normalmente instabilidade momentânea da Meta.
O que fazer: atualize a página, espere alguns minutos e tente de novo.
Erros de limite
Rate Limit Exceeded — limite de envio excedido
A conta passou do volume permitido para o período. Esse teto varia conforme o nível de qualidade que a Meta atribui ao seu número.
O que fazer: aguarde o período de espera antes de novos envios. Manter boas práticas melhora sua reputação e, com ela, o limite.
Spam Rate Limit Reached — limite de spam atingido
Muitos destinatários bloquearam ou denunciaram suas mensagens, e a Meta reduziu drasticamente seu limite de envio.
O que fazer: revise a estratégia de disparo. Garanta que quem recebe autorizou (opt-in) e corte mensagens excessivas ou irrelevantes.
Limite de spam não é um contratempo passageiro: é a Meta sinalizando que seus envios estão incomodando. Ignorar e continuar disparando leva à suspensão do número.
Mensagem bloqueada para manter engajamento saudável
A Meta limita mensagens de marketing consecutivas sem resposta. Se você mandou duas sem o contato interagir, novas mensagens não são entregues até a janela encerrar.
O que fazer: espere o contato responder antes de insistir. Se ele não respondeu a duas mensagens, a terceira dificilmente resolve.
Número faz parte de experimento da Meta
Cerca de 1% dos usuários participa de testes da Meta que bloqueiam mensagens de marketing.
O que fazer: tente com um modelo do tipo Utilidade, ou peça que o contato inicie a conversa.
Erros de modelo de mensagem
Paused Model — modelo pausado por baixa qualidade
O modelo foi suspenso temporariamente por baixo engajamento ou denúncias.
O que fazer: exclua o modelo pausado, revise o texto e crie outro, mais claro e mais relevante.
Model Disabled — modelo desativado em definitivo
Depois de pausas repetidas por baixa qualidade, o modelo é desativado de vez.
O que fazer: crie um novo, e inclua uma forma de a pessoa pedir para não receber mais (opt-out). Isso melhora a qualidade percebida pela Meta.
Erros de configuração
Access Denied — acesso negado
Problema de permissão: token expirado, permissões faltando ou conta com pendência no Business Manager.
O que fazer: revise o token de acesso, as permissões da API e a situação da conta de negócios vinculada. O passo 6 de contratar e configurar mostra como gerar um token permanente.
Media Loading Error — erro ao carregar mídia
Arquivo em formato não suportado ou fora dos padrões da API.
O que fazer: confira se o tipo e o tamanho do arquivo estão dentro das especificações do WhatsApp.
Como evitar chegar aqui
A maioria desses erros não é técnica: é consequência de como você usa o canal.
- Trabalhe com opt-in válido. Só mande para quem autorizou.
- Evite excesso de promoção. Marketing demais derruba a qualidade da conta.
- Acompanhe a qualidade do número. A Meta mostra esse indicador, e ele antecede os bloqueios.
- Escreva modelos claros e relevantes. Modelo bom tem resposta; modelo ruim vira denúncia.
- Respeite os limites e as políticas da Meta. Elas mudam, e vale reler de tempos em tempos.
Número com boa reputação envia mais e entrega melhor. Número queimado por disparo irresponsável não se recupera rápido — e, às vezes, não se recupera. Vale tratar isso como ativo da empresa.
Ainda travado?
Se o erro não está nesta lista ou a orientação não resolveu, fale com o suporte com o texto exato do retorno em mãos.