Códigos de erro do WhatsApp (Meta): o que significam e o que fazer

Tabela com os códigos de erro da Meta mais comuns ao enviar pelo WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) e como resolver cada um.

Oct 19, 2026

Quando a Meta recusa uma mensagem do WhatsApp, ela devolve um código de erro. O Omnifox traduz esse código e mostra o que aconteceu e o que fazer, mas vale conhecer os mais comuns: muitos não são falhas do Omnifox nem do seu canal, e sim regras da Meta sobre o cliente, o modelo ou a conta.

Onde você vê o erro

  • Na conversa: a mensagem que não saiu fica marcada como falha. Embaixo aparecem um título, a explicação e a ação recomendada. Ao abrir o detalhe técnico, aparece o código da Meta.
  • Em Configurações → Canais: quando a Meta restringe o número inteiro (por exemplo, por um problema de pagamento), o cartão do canal mostra o aviso com o código.
  • Em Campanhas: cada destinatário com falha mostra o motivo.

Tabela de códigos

Código O que significa O que fazer
131026 Mensagem não entregável. O número não tem WhatsApp, usa uma versão muito antiga do app, não aceitou os termos atuais do WhatsApp ou não pode receber mensagens de empresas. Confirme o número com o cliente e peça para atualizar o WhatsApp. Se continuar igual, fale com ele por outro canal. Tentar de novo não resolve.
131047 Passaram mais de 24 horas desde a última mensagem do cliente: a janela de atendimento está fechada. Envie um modelo aprovado. Quando o cliente responder, você volta a escrever livremente.
131049 A Meta decidiu não entregar a mensagem para proteger a experiência do usuário: ela limita quantas mensagens de marketing cada pessoa recebe. Não reenvie na hora. Espere o cliente escrever ou tente outro dia. Se a mensagem for de fato transacional (confirmação, lembrete), use um modelo de Utilidade.
130497 Sua conta do WhatsApp Business não tem permissão para enviar a usuários daquele país. É uma restrição da Meta sobre a conta, não sobre a mensagem. Fale com a gente para analisarmos. Enquanto isso, atenda esse cliente por outro canal.
141006 A Meta não conseguiu cobrar o método de pagamento da sua conta do WhatsApp Business. Não é um problema de token. Conversas novas (modelos e campanhas) ficam bloqueadas; as respostas dentro das 24 h continuam saindo. Revise e atualize a forma de pagamento no Meta Business Suite (WhatsApp Manager → configurações de pagamento). Se você paga as mensagens com o saldo de WhatsApp do Omnifox, confira se há saldo e fale com a gente.
131042 O mesmo que o anterior, mas visto em uma mensagem específica: a Meta não conseguiu processar o envio por um problema de pagamento. Mesma solução do 141006.
131031 A Meta bloqueou ou restringiu a conta do WhatsApp Business. Enquanto durar, nenhuma mensagem sai. Entre no Meta Business Suite → WhatsApp Manager e confira a qualidade e o status da conta. Por trás costuma haver um problema de pagamento (141006) ou a verificação da empresa pendente. Se achar que é um engano, recorra por lá.
131056 Mensagens demais para o mesmo número em pouco tempo. Espere alguns minutos antes de tentar de novo. Confira se nenhum fluxo de trabalho ou agente de IA está mandando mensagens em rajada para a mesma pessoa.
132000 A quantidade de variáveis enviadas não bate com a que o modelo espera. Preencha todas as variáveis (corpo, cabeçalho e botões) antes de enviar.
132001 O modelo não existe nesse idioma ou não está aprovado. Confira o nome, o idioma e o status do modelo, e sincronize os modelos da Meta.
132012 Uma variável tem um formato que a Meta recusa: quebras de linha, tabulações ou mais de 4 espaços seguidos, ou um cabeçalho com tipo de arquivo diferente do aprovado. Limpe o valor das variáveis e use no cabeçalho o mesmo tipo de arquivo (imagem, vídeo ou documento) que foi aprovado.
190 O token de acesso do canal expirou ou foi revogado (por exemplo, alguém trocou a senha do Facebook ou removeu permissões). Todos os envios do canal falham. Reconecte o canal em Configurações → Canais. O Omnifox verifica os tokens diariamente e avisa os administradores antes que expirem. Se todos os seus canais falharem ao mesmo tempo e você não mexeu em nada, pode ser uma instabilidade da Meta: espere alguns minutos antes de reconectar.
368 Bloqueio temporário por violar as políticas do WhatsApp (por exemplo, muitas denúncias ou bloqueios de usuários). Espere o bloqueio terminar e confira a qualidade da conta no WhatsApp Manager. Para não se repetir: envie só para contatos que aceitaram receber mensagens e reduza o volume de marketing.
131053 A Meta não aceitou o anexo pelo tamanho ou formato. Imagens até 5 MB, vídeo e áudio até 16 MB, documentos até 100 MB. Use JPG/PNG, MP4, MP3 ou PDF.
131048 A Meta limitou sua conta pelo volume alto de envios (possível spam). Pause as campanhas e confira a classificação de qualidade no WhatsApp Manager.

Problemas frequentes

  • O agente de IA responde, mas nada chega ao cliente: veja o erro da primeira mensagem com falha. Se for 131031, 141006 ou 190, o problema é da conta ou do canal, não do agente.
  • Só falham clientes de um país: quase sempre é 130497. Fale com a gente.
  • Os modelos falham, mas as respostas saem: costuma ser 141006 (pagamento) ou um modelo mal montado (132000, 132001, 132012).
  • Não encontro o código: abra o detalhe técnico da mensagem com falha; o número aparece ali. Se for um código que não está nesta tabela, compartilhe com o suporte.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp