Pular para o conteúdo
Português
Login
  • Não há sugestões porque o campo de pesquisa está em branco.

Erros comuns ao enviar modelos (API do WhatsApp)

Descubra o código de erro que a Meta devolveu quando um modelo não foi enviado e saiba como corrigir cada caso.

Quando um modelo de mensagem não é enviado pela API do WhatsApp, a Meta devolve um código que explica o motivo. Na Whaticket, você vê esse erro direto na mensagem. Com o código em mãos, use a lista abaixo para saber a causa e o que fazer.

Como identificar o erro

  1. Abra o chat em que a mensagem não foi enviada.
  2. Ao lado da mensagem, aparece um ícone vermelho de erro.
  3. Passe o cursor sobre o ícone para ver o código e a descrição devolvidos pela Meta. O texto aparece no formato Meta API, o número do código, error: e a descrição. Exemplo: Meta API 131047 error: seguido do motivo.
  4. Depois de corrigir a causa, clique no ícone para tentar enviar de novo.

Ícone vermelho de erro mostrando o código da Meta em uma mensagem na Whaticket

Em campanhas, abra Campanhas, clique em Visualizar campanha e filtre por Falharam para ver os contatos que não receberam a mensagem. Depois de corrigir, use Reagendar falhadas para enviar de novo.

Erros mais comuns: causa e solução

Resumo dos principais códigos de erro da Meta no envio de modelos

200 — Erro genérico de solicitação

Causa: Estrutura da solicitação com erro, dados incompletos ou inválidos, ou formato incorreto.

Solução:

  • Revise a estrutura da solicitação enviada.
  • Confira se todos os campos obrigatórios foram preenchidos.
  • Confirme se os dados estão no formato correto.

100 — Parâmetro inválido

Causa: Parâmetros incorretos, campos enviados de forma errada no modelo ou erro nas variáveis.

Solução:

  • Confira se as variáveis correspondem às do modelo.
  • Confirme os nomes dos campos e a estrutura enviada.
  • Compare com a documentação oficial da Meta.

131026 — Mensagem não entregue

Causa: O número não tem WhatsApp, o cliente bloqueou seu número, está em um país com restrição ou usa uma versão desatualizada do app ou não aceitou os termos.

Solução:

  • Confirme se o número tem WhatsApp.
  • Peça ao cliente para desbloquear seu número.
  • Peça para ele atualizar o aplicativo e tente de novo.

131031 — Conta bloqueada

Causa: A conta foi bloqueada por violar políticas ou há problema na verificação, como PIN da verificação em duas etapas incorreto.

Solução:

  • Desative a verificação em duas etapas do número na Meta.
  • Registre o número novamente.
  • Ative a verificação em duas etapas outra vez.
  • Se continuar, solicite uma revisão à Meta.

131042 — Problema de pagamento

Causa: Falta de forma de pagamento, linha de crédito inválida ou conta configurada incorretamente.

Solução:

  • Configure a forma de pagamento na Meta.
  • Revise a conta no Gerenciador de Negócios.
  • Confira a moeda e as configurações de cobrança.

131047 — Fora da janela de 24 horas

Causa: Tentativa de enviar texto livre depois de 24 horas da última mensagem do cliente.

Solução:

  • Envie um modelo de mensagem aprovado.
  • Ou aguarde o cliente responder para reabrir a janela.

131049 — Envio limitado pela Meta

Causa: Envios em massa muito rápidos, baixa qualidade do número ou contatos que não interagem ou denunciam.

Solução:

  • Aguarde pelo menos 24 horas antes de tentar de novo.
  • Reduza o volume de envios e aumente aos poucos.
  • Envie só para contatos que aceitaram receber mensagens (opt-in).

130497 — País com restrição

Causa: A conta não está habilitada para enviar mensagens para esse país.

Solução:

  • Confirme se o país é permitido para sua conta.
  • Suba o nível (tier) da conta ou aguarde a liberação pela Meta.

131037 — Nome de exibição não aprovado

Causa: O nome de exibição do número não foi aprovado pela Meta.

Solução:

  • Solicite a aprovação do nome de exibição.
  • Ajuste as configurações do número na Meta.

130472 — Usuário em experimento

Causa: A Meta está fazendo testes internos com esse usuário.

Solução:

  • Não há ação direta. Tente de novo mais tarde.
  • Evite reenvios em massa.

132000 — Variáveis incorretas

Causa: Variáveis mal configuradas ou parâmetros incompletos.

Solução:

  • Revise a estrutura do modelo.
  • Confira a ordem e a quantidade de variáveis.

132001 — Modelo não aprovado

Causa: O modelo não está aprovado ou o idioma enviado não corresponde.

Solução:

  • Confira o status do modelo na Meta.
  • Confirme o nome e o idioma do modelo.

131021 — Envio para o mesmo número

Causa: Tentativa de enviar a mensagem para o próprio número da conexão.

Solução:

  • Use outro número como destino.

Resumo rápido

  • Entrega: 131026 (número ou cliente), 131049 (limitação por comportamento), 130497 (país com restrição).
  • Conta: 131031 (conta bloqueada), 131042 (pagamento).
  • Modelo: 132000 e 132001 (variáveis ou aprovação).
  • Outros: 131047 (fora da janela de 24 horas), 130472 (experimento da Meta).

A lista completa de códigos está na documentação oficial da Meta.

Perguntas frequentes

Apareceu o erro 130403. O que significa?
Significa que o contato está bloqueado nessa conexão do seu lado. A Whaticket marca o contato como bloqueado e resolve o chat automaticamente. Para voltar a conversar, abra os dados do contato no chat e clique em Desbloquear contato.

Posso só reenviar a mensagem sem corrigir nada?
Na maioria dos casos, não adianta. Cada código aponta uma causa específica. Corrija a causa antes de tentar de novo, principalmente nos erros de conta, pagamento e modelo.

Por que a Whaticket não envia texto livre fora das 24 horas?
É uma regra da Meta para a API do WhatsApp. Depois de 24 horas sem resposta do cliente, só é possível iniciar a conversa com um modelo aprovado.

Artigos relacionados

Tem alguma dúvida adicional? 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.

Ainda não tem uma conta na Whaticket? Crie sua conta e experimente grátis por 14 dias!