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.
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
- Resolver erros ao conectar o WhatsApp
- Recarregar o saldo do WhatsApp (Meta) e entender as cobranças por conversa
- Token de acesso do WhatsApp: o que é e quando expira
- Enviar um modelo do WhatsApp a partir de uma conversa
- Categorias de modelos do WhatsApp (Marketing, Utilidade, Autenticação)
- Sincronizar modelos da Meta
Artigos relacionados
-
Como conectar o Telegram
Conecte um bot do Telegram à sua caixa de entrada do Omnifox em minutos usando o BotFather.
-
Comentários do Instagram e do Facebook: responder e moderar pelo Omnifox
Veja e responda os comentários das suas publicações e anúncios do Facebook e do Instagram, em público ou no privado, e configure respostas automáticas.
-
Enviar e receber vídeos em cada canal: formatos e tamanhos máximos
Quais vídeos você pode enviar e receber pelo WhatsApp, Instagram, Messenger, Telegram, chat do site e e-mail, com os tamanhos máximos reais e o que fazer com um vídeo pesado.
-
Conectar o WhatsApp escaneando um código QR
Vincule seu WhatsApp ao Omnifox em um minuto, como no WhatsApp Web. Ideal para testar: tem limites, não permite campanhas e não é a API oficial.
-
Guia completo do Webchat
O chat do seu site a fundo, em 32 capítulos: instalação, aparência, idiomas e tradução com IA, pré-chat, departamentos, horários, gatilhos, IA, a caixa de entrada e a parte para desenvolvedores.