Códigos de erro da Meta (WhatsApp Oficial)
Quando uma mensagem enviada pelo WhatsApp Oficial (API da Meta) não é entregue, a Meta devolve um código de erro. No AtendeBot, a mensagem que falhou aparece na conversa com um aviso em vermelho mostrando o código, o nome do erro e uma explicação breve — com os botões Tentar envio novamente e Excluir mensagem.
Abaixo está o significado de cada código e o que fazer em cada caso.
Dica: a maioria das falhas do dia a dia é causada pela janela de 24 horas (erro 131047) ou por número sem WhatsApp (erro 131026). Comece por eles.
Erros mais comuns
Erro 131047 — Janela de 24 horas expirada
O que significa: mais de 24 horas se passaram desde a última mensagem do cliente. Pela política do WhatsApp, depois desse prazo a empresa só pode enviar modelos aprovados.
Como resolver: envie um modelo de mensagem aprovado para reabrir a conversa. Quando o cliente responder, a janela de 24 horas reabre e o envio livre volta a funcionar.
Erro 131026 — Mensagem não entregue
O que significa: o número do destinatário não está registrado no WhatsApp, bloqueou seu contato ou não aceitou os novos termos do aplicativo.
Como resolver:
- Confira se o número está correto e no formato internacional (ex.: +55 11 99999-9999).
- Confirme com o cliente, por outro canal, se o número tem WhatsApp ativo.
- Teste enviar para outro número ativo para descartar problema no canal.
Erro 131049 — Limite de marketing da Meta
O que significa: a Meta decidiu não entregar este modelo de marketing para manter a experiência do usuário saudável — o destinatário já recebeu muitas mensagens de marketing recentemente (de você ou de outras empresas).
Como resolver:
- Use um modelo de utilidade em vez de marketing quando o objetivo for transacional.
- Reduza a frequência de campanhas para o mesmo contato.
- Aguarde: o bloqueio é temporário e liberado pela própria Meta.
Erro 130472 — Número em experimento da Meta
O que significa: o destinatário faz parte de um experimento do WhatsApp (aplicado a uma pequena parcela de usuários) que limita o recebimento de mensagens de marketing iniciadas por empresas.
Como resolver: use um modelo de utilidade, ou aguarde o próprio cliente iniciar a conversa — com a conversa aberta, o envio funciona normalmente.
Erro 131056 — Muitas mensagens para o mesmo contato
O que significa: foram enviadas muitas mensagens deste número para o mesmo destinatário em um curto período.
Como resolver: aguarde alguns minutos antes de reenviar e evite disparos repetidos para o mesmo contato.
Erro 131000 / 131016 / 133004 — Erro temporário na Meta
O que significa: falha genérica ou indisponibilidade temporária nos servidores da Meta.
Como resolver: aguarde alguns instantes e use Tentar envio novamente. Se persistir, verifique o status da API da Meta e a conexão do canal.
Erros de limite e qualidade
Erro 4 / 80007 / 130429 — Limite de envios da API
O que significa: a conta atingiu o limite de requisições ou de vazão (throughput) da Meta.
Como resolver: aguarde alguns minutos e tente novamente. Em campanhas grandes, distribua os envios ao longo do tempo.
Erro 131048 — Envios suspensos por qualidade
O que significa: a Meta suspendeu temporariamente os envios do número por suspeita de spam ou queda na classificação de qualidade (gerada por bloqueios e denúncias de destinatários).
Como resolver:
- Verifique a qualidade do número no WhatsApp Manager.
- Reduza envios em massa e evite mensagens idênticas/repetitivas.
- Priorize contatos que consentiram em receber mensagens (opt-in).
Erro 368 / 131031 — Conta restrita ou bloqueada
O que significa: a conta do WhatsApp Business foi restringida ou desabilitada por violar alguma política da plataforma.
Como resolver:
- Acesse a Página Inicial do Suporte no Gerenciador de Negócios da Meta e verifique as notificações.
- Revise as Políticas Comerciais e de Mensagens do WhatsApp.
- Corrija as práticas apontadas e, se aplicável, conteste a decisão pelo próprio Gerenciador.
Erros de modelo (template)
Erro 132001 — Modelo não encontrado
O que significa: o modelo não existe ou não foi aprovado no idioma enviado (pegadinha comum: o modelo existe em português, mas o envio saiu em outro idioma).
Como resolver: confira o nome e o idioma do modelo em Ajustes → Modelos; se o modelo foi reprovado, ajuste e reenvie para aprovação.
Erro 132000 — Parâmetros do modelo incorretos
O que significa: a quantidade de parâmetros (variáveis) enviada não confere com o modelo aprovado.
Como resolver: confira se todas as variáveis do modelo estão preenchidas.
Erro 132012 — Parâmetro em formato incorreto
O que significa: um dos parâmetros está em formato diferente do aprovado pela Meta.
Erro 132005 — Texto do modelo muito longo
O que significa: o texto final (com as variáveis preenchidas) excede o limite de tamanho da Meta.
Erro 132007 — Modelo bloqueado
O que significa: o modelo foi bloqueado por violar a política de conteúdo da Meta.
Erro 132015 / 132016 — Modelo pausado ou desabilitado
O que significa: a Meta pausa (132015) e depois desabilita (132016) modelos com baixa qualidade — muitos bloqueios ou denúncias dos destinatários.
Como resolver: edite o modelo para melhorar o conteúdo ou crie um novo; evite reutilizar modelos com histórico ruim.
Erros de conta e canal
Erro 0 / 190 — Sessão expirada
O que significa: o token de acesso do canal expirou ou foi revogado.
Como resolver: reconecte o canal em Ajustes → Contas. Veja Reconectar um canal que caiu ou trocar de número.
Erro 131042 — Problema de pagamento
O que significa: há um problema com o método de pagamento da conta Meta (cartão recusado, faturamento não configurado, limite excedido).
Como resolver: verifique o faturamento no Gerenciador de Negócios → Pagamentos, confirme os dados do cartão ou adicione um novo método de pagamento.
Erro 133010 — Número não registrado
O que significa: o número do canal não está registrado na API oficial do WhatsApp.
Como resolver: reconecte o canal em Ajustes → Contas.
Erro 131045 — Falha de registro do número
O que significa: o número está com problema de registro (certificado) na Meta.
Como resolver: reconecte o canal.
Erro 131057 — Conta em manutenção
O que significa: a conta Meta está temporariamente em modo de manutenção.
Como resolver: aguarde e tente novamente mais tarde.
Erro 10 — Sem permissão
O que significa: o aplicativo Meta não tem permissão para executar o envio.
Como resolver: reconecte o canal para renovar as permissões concedidas.
Erros de conteúdo
Erro 100 / 131008 / 131009 — Conteúdo inválido
O que significa: o conteúdo da mensagem é inválido ou está incompleto (parâmetro ausente, URL de mídia inacessível, formato errado).
Como resolver: revise o texto, a mídia e os parâmetros e tente novamente.
Erro 131051 — Tipo de mensagem não suportado
O que significa: o tipo de conteúdo não é suportado pela API oficial (ex.: reações, figurinhas animadas, formatos muito recentes do WhatsApp).
Como resolver: envie o conteúdo em um formato padrão — texto, imagem ou documento. Se o erro for em mensagem recebida, peça ao cliente para reenviar em outro formato.
Erro 131052 / 131053 — Falha na mídia
O que significa: a Meta não conseguiu baixar (131052) ou enviar (131053) o arquivo de mídia.
Como resolver: verifique o formato e o tamanho do arquivo e tente novamente.
Erro 131021 — Destinatário inválido
O que significa: o número de destino é o próprio número do canal.
Erro 135000 — Falha genérica ao enviar
O que significa: erro desconhecido da Meta, geralmente ligado à validação do modelo.
Como resolver: tente novamente; se persistir com um modelo específico, duplique o modelo e use a cópia.
No comments to display
No comments to display