🛠️ Códigos de Erro da Meta API

Código de Erro	Categoria	Descrição do Erro	Ação Recomendada para o Cliente
131026	Erros de Entrega	Mensagem Não Entregável. Causas comuns: o destinatário não tem WhatsApp, está usando uma versão desatualizada, ou não aceitou os Termos de Serviço e Política de Privacidade da Meta.	Peça ao destinatário para atualizar o app do WhatsApp e aceitar os Termos de Serviço mais recentes.
131047	Erros de Integridade	Limite de Taxa (Rate Limit) Atingido por Spam. A conta excedeu o limite de envio devido a muitas mensagens anteriores terem sido bloqueadas ou marcadas como spam pelos usuários.	Verifique o Status de Qualidade da sua conta no Gerenciador do WhatsApp da Meta. Reduza a frequência/volume de envios.
131009	Erros de Envio de Modelo	Modelo de Mensagem Inválido ou Parâmetros Ausentes. O template não existe, não está aprovado, ou o JSON da mensagem está formatado incorretamente (ex: variáveis de template não preenchidas).	Confirme que o nome do template e o idioma estão corretos e que TODAS as variáveis (os campos {{1}}, {{2}}, etc.) foram preenchidas no envio.
132016	Erros de Criação/Envio de Modelo	Modelo Desativado. O template foi desativado pela Meta devido a baixa qualidade contínua (muitas denúncias ou bloqueios).	Crie um novo modelo de mensagem. Revise o conteúdo para garantir que está em conformidade com as políticas e que é relevante para o usuário.
132015	Erros de Criação de Modelo	Cabeçalho/Corpo/Rodapé Inválido. O conteúdo do template (cabeçalho, corpo ou rodapé) está formatado incorretamente.	Revise o conteúdo do template no Gerenciador do WhatsApp para garantir que o formato (ex: limite de caracteres, caracteres especiais) está correto.
132012	Erros de Envio de Modelo	Formato do Parâmetro Não Corresponde ao Template. O tipo de mídia enviada (Imagem/Documento/Vídeo) para o cabeçalho do template não corresponde ao tipo especificado no template aprovado.	Verifique se o tipo de mídia ou o valor enviado para o cabeçalho do template corresponde exatamente ao que foi aprovado pela Meta. Ex. Se na META foi aprovado o Modelo com imagem, é necessário que no envio do modelo a imagem seja enviada.
132001	Erros de Envio de Modelo	Modelo de Mensagem Não Existe. O template especificado não foi encontrado ou não foi aprovado para o idioma ou WABA (WhatsApp Business Account) utilizada.	Confirme que o nome do template, o idioma e a WABA estão corretos. Verifique o status do template no Gerenciador do WhatsApp.
131049	Erros de Entrega	Meta Optou por Não Entregar a Mensagem. Ocorre para mensagens de Marketing. A Meta pode impor um limite de recebimento de mensagens de marketing para um usuário, visando manter um ecossistema saudável e evitar excesso de notificações.	Evite reenviar imediatamente. Tente um novo envio após um intervalo de tempo maior (ex: 24 horas).
131042	Erros de Entrega	Número do Destinatário Não é um Usuário Válido do WhatsApp. O número para o qual você está tentando enviar não está registrado no WhatsApp.	Verifique o número de telefone do destinatário.
131037	Outros Erros	Erro Relacionado ao Pagamento. Ocorreu um problema com a conta de pagamento (ex: limite de crédito excedido, conta não associada ou inativa).	Verifique as Configurações de Cobrança e Pagamento no Gerenciador de Negócios da Meta.
130472	Erros de Entrega	Número do Usuário Faz Parte de um Experimento. O número de telefone do destinatário está participando de testes internos da Meta (como o Marketing Message Experiment), e mensagens de marketing podem ser temporariamente bloqueadas.	Evite reenviar imediatamente. Como o bloqueio é da Meta, aguarde um intervalo de tempo maior para tentar novamente.
131031	Erros de Conta	Conta Bloqueada/Restrita. A conta do WhatsApp Business foi restrita ou desabilitada por violar uma política da plataforma Meta.	Consulte o Gerenciador do WhatsApp para verificar o status e detalhes da violação. Envie um recurso à Meta, se aplicável.
368	Outros Erros	Temporariamente Bloqueado por Violação de Política. A conta do WhatsApp Business associada ao app foi restrita ou desabilitada por violar uma política.	Semelhante ao erro 131031. Consulte o Gerenciador do WhatsApp e envie um recurso à Meta.