🟢 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.
