Como identificar o erro?
Se você acabou de configurar sua API e um erro aparece ao enviar um modelo de mensagem, é importante revisar os detalhes exibidos pela plataforma.
Posicione o cursor sobre o segundo ícone vermelho (erro) que aparece na mensagem.
Ali você pode ver o código e a descrição do erro retornado pelo Meta.
Ícone de erro mostrando detalhes do problema de envio.
A Meta sempre indica o motivo exato pelo qual a mensagem não pôde ser enviada.
Identificar esse erro é essencial para poder aplicar a solução correta.
Principais erros (causa e solução)
200 — Erro genérico de solicitação
Causa:
- Erro na estrutura da solicitação enviada
Dados incompletos ou inválidos na API
Problemas com o formato da solicitação - Solução:
- Analise a estrutura da solicitação enviada
Verifique se todos os campos obrigatórios foram preenchidos.
Confirme se os dados estão no formato correto.
Analise os registros ou a resposta detalhada da API.
100 — Parâmetro inválido
Causa:
- Parâmetros incorretos na solicitação
Campos preenchidos incorretamente no modelo
Erro nas variáveis ou na estrutura da mensagem - Solução:
- Validar os parâmetros enviados na API
Verifique se as variáveis correspondem ao modelo.
Confirme os nomes dos campos e a estrutura JSON.
Compare com a documentação oficial da Meta
131026 — Mensagem não entregue
Causa:
- O número não possui WhatsApp
O cliente bloqueou seu número
O cliente está em um país com restrições.
Formulário de inscrição desatualizado ou termos não aceitos - Solução:
- Verifique se o número possui WhatsApp.
Peça ao cliente para desbloquear o número
Solicitar uma atualização do aplicativo
Tente o envio manual
131031 — A conta foi bloqueada
Causa:
- Conta bloqueada devido às políticas
Problema com a verificação (PIN 2FA incorreto) - Solução:
- Desative a autenticação de dois fatores (2FA).
Registre o número novamente
Reative a autenticação de dois fatores (2FA).
Se o problema persistir → solicite uma revisão da Meta
131042 — Problema de pagamento/faturamento
Causa:
- Falta de método de pagamento
Linha de crédito inválida
Conta configurada incorretamente - Solução:
- Configure o método de pagamento no Meta
Analise a conta no Gerenciador de Negócios
Validar moeda e configurações
131047 — Fora do período de 24 horas
Causa:
- Tentativa de envio fora do prazo de 24 horas sem um modelo.
- Solução:
- Enviar mensagem com modelo aprovado
Ou aguarde uma resposta do cliente
131049 — Envio bloqueado pela Meta
Causa:
- Envios em massa muito rápidos
Baixa qualidade do número
Os usuários não interagem nem denunciam - Solução:
- Aguarde pelo menos 24 horas
Reduzir o volume de envio
Usar contatos com consentimento (opt-in)
Aumentar gradualmente a escala dos envios
130497 — País com restrições
Causa:
- Conta não habilitada para enviar para esse país
- Solução:
- Suba de nível na sua conta (nível)
Aguarde o lançamento
Validar país permitido
131037 — Nome de exibição não aprovado
Causa:
- Nome do número não aprovado pela Meta
- Solução:
- Solicitar aprovação de nome
Ajuste as configurações no Meta
130472 — Usuário em experimento
Causa:
- A Meta está realizando testes internos.
- Solução:
- Não há ação direta
Tente novamente mais tarde
Evite tentativas em massa
132000 — Variáveis incorretas
Causa:
- Variáveis mal configuradas
Parâmetros incompletos - Solução:
- Revisar a estrutura do modelo
Validar a ordem e o número de variáveis
132001 — Modelo não aprovado
Causa:
- Modelo não aprovado
Linguagem incorreta - Solução:
- Verifique o status no Meta
Confirme o nome e o idioma.
131021 — Enviar para o mesmo número
Causa:
- Tentativa de enviar uma mensagem para o mesmo número
- Solução:
- Use um número diferente como destino.
Resumo rápido para suporte
- Problemas de entrega
131026 → número / cliente
131049 → bloqueio comportamental
130497 → país restrito - Problemas com a conta
131031 → conta bloqueada
131042 → pagamento - Problemas com o modelo
132000 / 132001 → variáveis ou aprovação - Outras coisas importantes
131047 → janela externa
130472 → experimento
Documentação oficial da Meta
Você pode verificar todos os erros diretamente na documentação oficial:
https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/
Importante
Identificar corretamente o erro exibido pelo Meta é fundamental para resolver o problema.
Cada código indica uma causa específica, portanto, você deve sempre validar a mensagem antes de tentar encaminhá-la.
Tem mais alguma dúvida? Não se preocupe, estamos aqui para ajudar.
Entre em contato com nossa equipe clicando no botão "Suporte" localizado no menu à esquerda da nossa plataforma.
