Erros comuns ao enviar modelos (API do WhatsApp)

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.