Códigos de erro da Cloud API do WhatsApp: o que significam e como resolver

Onde o erro aparece e o que vem dentro dele?

A Cloud API devolve o erro de dois jeitos. Quando a Meta recusa o pedido de envio, o erro volta na hora, na resposta da chamada. Quando a mensagem é aceita, mas não chega ao celular, o aviso vem depois, pelo webhook de status, com o status failed. Nos dois casos o erro traz um código, um título, uma mensagem e, em muitos casos, um campo de detalhe e um link para a documentação.

O código é o que importa. Com ele, você sabe se o problema está na credencial, no texto do template, no número do contato, no pagamento ou no ritmo do envio. Para entender como o webhook entrega esses avisos, veja o que é webhook e o guia de status de entrega da API.

Todos os códigos desta página foram conferidos na tabela oficial de códigos de erro da Meta em 31/10/2026. Se um código que você viu não está aqui, a tabela oficial é a fonte final, e os links ficam no fim da página.

Quais são os erros mais comuns e o que fazer em cada um?

A tabela agrupa por causa, porque é assim que se resolve na prática: primeiro descobre-se em que camada está o problema, depois se aplica a ação.

Por que o erro de template é o mais frequente em disparo?

No disparo em massa, toda mensagem que a empresa começa sai por template. Por isso a maior parte dos erros de campanha mora nessa camada. Três situações explicam quase tudo:

• 132000 e 132012 (variáveis). A planilha tem uma coluna a menos, uma célula vazia ou um valor em formato errado, e o envio daquele contato falha. A causa é quase sempre a base, não o template.
• 132001 (template não encontrado). O nome está com letra diferente, o idioma não bate ou o template ainda está em análise. Cada idioma é um template separado, e a Meta não traduz sozinha.
• 132015 e 132016 (qualidade). O template recebeu muito feedback negativo ou leitura baixa e foi pausado. A pausa dura 3 horas na primeira vez e 6 horas na segunda; na terceira, o template é desativado e precisa ser substituído por um novo.

Para evitar reprovação antes mesmo do envio, veja o guia de template reprovado no WhatsApp e as regras de templates do WhatsApp API. Se o seu caso é de pausa, a causa de fundo costuma ser a qualidade do número e dos templates.

O que significam os erros que dependem do contato?

Alguns erros não têm conserto do seu lado, porque a causa está no contato ou na regra da Meta para ele. O trabalho é reconhecer o tipo e agir certo.

• 131026: a Meta lista como causas um número que não tem WhatsApp, um contato que não aceitou os termos mais recentes e um aplicativo desatualizado. Em lista grande, parte dos 131026 costuma ser número inválido; por isso a higienização da base vem antes do envio.
• 131047: a conversa está fora da janela de 24 horas. Texto livre não passa; só template. Entenda a regra em janela de 24 horas do WhatsApp.
• 131050: a pessoa pediu para não receber marketing da sua empresa. A orientação da Meta é não tentar de novo. Registre a saída na sua base e respeite o pedido, como manda a política de opt-in descrita em opt-in no WhatsApp.
• 131056: muitas mensagens do mesmo remetente para o mesmo contato em pouco tempo. Mensagens para outros contatos não são afetadas. Espaçar o envio resolve.

E quando o erro é da conta, do pagamento ou do limite?

Esses são os que param a operação inteira, não só um contato. Vale reconhecê-los rápido.

• 368 e 131031: a conta foi restringida ou desativada por violação de política. A ação é ler a documentação de aplicação de políticas da Meta e resolver o ponto citado. O 131031 também aparece quando os dados do pedido não batem com os da conta, como um PIN de duas etapas incorreto.
• 131042: problema de pagamento. A Meta manda revisar a configuração de cobrança: limite de crédito, moeda e fuso horário não definidos, ou solicitações pendentes.
• 131037: a Meta descreve este erro para números 555 sem nome de exibição aprovado. Resolva a aprovação do nome antes de tentar de novo.
• 130429: o limite de vazão da Cloud API foi atingido. A saída é reduzir a frequência e tentar depois. O limite de quantas pessoas diferentes você alcança por dia é outro assunto, explicado em limite de envio do WhatsApp API.

Se o erro for de conta restrita, o caminho é recorrer pelos canais da Meta. Para entender o que leva a isso e como evitar, leia conta restrita no WhatsApp API.

Como diagnosticar um erro em cinco passos?

1. 1
   Anote o código e a mensagem completa

   O número sozinho engana. O título e o campo de detalhe do erro trazem o contexto, como qual parâmetro falhou ou qual mídia não subiu.

2. 2
   Descubra a camada

   Use a tabela acima: credencial, parâmetro, template, destinatário, ritmo, conta ou instabilidade. Isso define quem resolve.

3. 3
   Veja quantos contatos tiveram o mesmo erro

   Um contato com 131026 é número ruim. Mil contatos com 132000 é problema de coluna na planilha. A proporção diz a causa.

4. 4
   Corrija na origem

   Planilha, template, pagamento ou token. Reenviar sem corrigir só repete o erro e pode gastar qualidade do número.

5. 5
   Reenvie só a parte que falhou, respeitando a espera

   Nos erros que pedem espera (como 131049, 24 horas), aguarde antes de repetir. Não reenvie a lista inteira.

Campanha: ____________________  Data: ___/___/_____
Template: ____________________  Idioma: ______

Código do erro: ________   Título: ______________________
Mensagem / detalhe: ____________________________________
Quantos contatos afetados: ______ de ______ enviados

Camada (marque uma):
[ ] credencial/permissão  [ ] parâmetro  [ ] template  [ ] destinatário
[ ] ritmo/vazão  [ ] conta/pagamento  [ ] instabilidade

Causa confirmada: ______________________________________
Correção feita: ________________________________________
Reenvio: [ ] não precisa  [ ] sim, para os ______ contatos, após ___ horas de espera
Aprendizado para a próxima campanha: ___________________

Como a AD PRO reduz erro de envio antes do disparo?

O resultado prático é que você não precisa ler webhook nem decorar tabela de código. Entenda o serviço completo em serviço de disparo em massa e veja como o relatório funciona em relatório de disparo em massa. Se você prefere montar a operação por conta própria, a página do hub de disparo em massa mostra os caminhos.