Esta página fornece uma visão geral dos códigos de erro mais comuns da API do WhatsApp Business da Meta, suas causas e as soluções recomendadas.
Como Acessar
Disponível para usuários com permissão de acesso ao Caixa de Entrada e à seção Equipes.
Passos:
-
Vá até o módulo Caixa de Entrada no menu lateral.
-
Selecione Registro de mensagens com falha na seção Equipes para visualizar informações detalhadas sobre erros.
Códigos de Erro e Soluções
| Código | Descrição | Possíveis Causas | Soluções Recomendadas |
|---|---|---|---|
| 131026 | Mensagem não entregue | Número não registrado no WhatsApp; Termos de Serviço não aceitos; Versão desatualizada do app | Verifique o número; solicite aceite dos termos; peça para atualizar o aplicativo |
| 131042 | Algo deu errado | Problemas temporários no servidor; parâmetros incorretos | Tente novamente após um curto intervalo; verifique formatação dos parâmetros |
| 131042 | Problema de pagamento de elegibilidade comercial | Pendência no pagamento da conta | Atualize os dados de cobrança no WhatsApp Business Account |
| 132001 | Template não existe | Template não aprovado ou idioma incorreto | Verifique nome e idioma; confirme aprovação no WhatsApp Manager |
| 131047 | Mensagem de reengajamento | Passaram-se mais de 24h desde a última mensagem do cliente | Use template pré-aprovado para reengajar |
| 131048 | Limite de taxa de spam atingido | Muitas mensagens em pouco tempo | Reduza frequência; melhore qualidade e variedade do conteúdo |
| 131049 | Mensagem bloqueada por proteção do ecossistema | Meta limitando para evitar spam | Envie apenas para usuários que optaram por receber; personalize mensagens |
| 131051 | Tipo de mensagem não suportado | Tentativa de envio de tipo não permitido | Consulte a documentação do WhatsApp |
| 133010 | Número de telefone não registrado | Número não registrado na plataforma WhatsApp Business | Registre o número antes de enviar |
| 132016 | Template desativado | Baixa qualidade do template | Crie novo template com conteúdo melhorado e envie para aprovação |
Mais detalhes: Meta Error Codes
Casos de Uso Práticos
-
Monitorar falhas de mensagens — revisar logs e agir rápido
-
Melhorar qualidade — analisar padrões de erro e ajustar templates
-
Garantir conformidade — manter-se atualizado com as políticas do WhatsApp
Boas Práticas
-
Auditorias regulares — revisar mensagens para identificar problemas recorrentes
-
Gestão de templates — manter repositório organizado de modelos aprovados
-
Engajamento ativo — incentivar respostas para manter canal ativo
-
Manter-se informado — acompanhar atualizações da Meta
Perguntas Frequentes (FAQs)
-
O que significa “Mensagem não entregue”?
Cliente não está no WhatsApp, não aceitou termos ou usa app desatualizado. -
Como resolver “Limite de spam atingido”?
Reduzir frequência e personalizar conteúdo. -
Por que o template está “Não existe”?
Não aprovado ou idioma incorreto. -
O que fazer se o template for desativado?
Criar nova versão e enviar para aprovação. -
Posso reenviar mensagens com erro?
Sim, após corrigir a causa. -
Como verificar status da conta?
No WhatsApp Business Manager. -
O que é a janela de 24h?
Limite para responder mensagens iniciadas pelo cliente. -
Por que mensagens são bloqueadas para proteção do ecossistema?
Para evitar spam e proteger usuários. -
Como prevenir problemas de entrega?
Garantir opt-in, usar templates aprovados e monitorar relatórios. -
Onde encontrar mais informações?
Meta Error Codes e blog da Sanoflow.