Documentação
Conexão WhatsAppErros e problemas

Códigos de erros da Meta

Referência dos códigos de erro retornados pela API da Meta ao usar o WhatsApp — causas prováveis e como agir em cada caso.

Ao integrar ou usar os serviços da Meta, alguns códigos de erro podem ser retornados pela API. Abaixo estão os mais comuns, com a causa provável e como agir.

A maioria destes erros vem de restrições aplicadas diretamente pela Meta, e não da plataforma. Nesses casos, não há como a plataforma remover o bloqueio — as orientações abaixo ajudam a contornar ou aguardar a liberação automática.

Erro 100 — Mensagem não suportada

Geralmente ocorre por parâmetros inválidos/ausentes na requisição ou por permissões insuficientes do aplicativo na API da Meta.

Causas mais comuns:

  • Parâmetros incorretos, incompletos ou em formato inválido (ex.: ID inválido).
  • Recurso inexistente ou inacessível ao aplicativo.
  • Permissões insuficientes para a ação.
  • URLs malformadas em mensagens com links.

Como resolver:

  • Verifique se todos os parâmetros obrigatórios estão presentes e no formato correto.
  • Confirme se o aplicativo tem as permissões necessárias.
  • Valide se os recursos/IDs informados existem e estão acessíveis.
  • Teste as URLs usadas nas mensagens.

Erro 130472 — Experimento da Meta

A Meta seleciona cerca de 1% dos números conectados ao WhatsApp Cloud API no mundo para um experimento controlado, avaliando o impacto de mensagens de marketing na experiência dos usuários.

Para os números incluídos, o envio de modelos da categoria Marketing pode ser temporariamente limitado, mesmo com a conta corretamente configurada, com saldo, com templates aprovados e sem infrações. Não é erro de configuração nem penalização.

Como contornar:

  1. Use modelos da categoria Utilidade (confirmação de pedido, boleto, lembretes) — geralmente não afetados.
  2. Aguarde o cliente iniciar a conversa (janela de 24 horas), na qual você responde sem as restrições de marketing.
  3. Use canais alternativos (telefone, SMS, e-mail) para pedir que o cliente envie a primeira mensagem.

Não é possível solicitar a remoção do teste — é automático e aleatório. Os experimentos são temporários, mas a Meta não divulga prazo de encerramento.

Erro 130497 — Conta comercial impedida de enviar mensagens

Indica uma restrição geográfica de envio: a Meta não conseguiu validar a localização da empresa, normalmente por o campo País estar vazio ou incorreto no Business Manager.

A Meta não identifica o país apenas pelo prefixo do número (ex.: +55). Sem o país configurado, o sistema pode aplicar restrições de envio entre países.

Como resolver:

  1. Acesse o Meta Business Manager → Configurações do negócio.
  2. Selecione Informações da empresa.
  3. Verifique o campo País (ex.: Brasil).
  4. Se estiver vazio/incorreto, clique em Editar, selecione o país correto e salve.
  5. Aguarde a propagação da configuração na Meta.

Erro 131000 — Erro desconhecido

Falha técnica no processamento do envio pela API do WhatsApp, geralmente por problemas temporários de comunicação, configuração incorreta ou instabilidade nos serviços da Meta.

Como resolver:

  • Verifique o status da API em metastatus.com.
  • Confirme sua conexão com a internet.
  • Tente enviar a mensagem novamente após alguns instantes.

Se o erro ocorrer logo após conectar um número, pode ser necessário reconfigurar a integração: acesse o portfólio empresarial, exclua as informações da conexão do número e refaça o processo de conexão à API Oficial.

Erro 131026 — Número não registrado no WhatsApp

Tentativa de envio para um número sem conta ativa no WhatsApp.

Causas mais comuns: número sem conta no WhatsApp, mudança de número pelo usuário, erro de digitação ou conta desativada.

Como resolver:

  1. Verifique o número: formato internacional com código do país (ex.: +55) e nono dígito quando aplicável; confirme com o cliente.
  2. Confira se o número tem WhatsApp: tente iniciar conversa pelo app ou use https://wa.me/[número].
  3. Teste com outro número que você sabe estar ativo — se funcionar, o problema está no número original.

Erro 131031 — Conta restrita ou bloqueada

A conta do WhatsApp Business está restrita ou bloqueada pela Meta, normalmente por violação de política.

Causas mais comuns: violação das políticas da Meta, muitas reclamações/denúncias de usuários ou atividades suspeitas (envio em massa, automações agressivas).

Como resolver: verifique alertas na página inicial de suporte.

Revise as Políticas Comerciais e de Mensagens, responda às notificações da Meta e corrija práticas inadequadas — reduza envios a listas frias, priorize mensagens relevantes e garanta o opt-in dos contatos. Veja Solicitar revisão de banimento.

Erro 131042 — Falha no pagamento

A Meta não conseguiu processar o pagamento com o cartão cadastrado no Business Manager, geralmente por falha no próprio processamento da Meta, mesmo com cartão válido.

Como resolver:

  1. Confirme os dados do cartão e se há limite/saldo disponível.
  2. Pague manualmente: em Contas → Contas do WhatsApp → Configurações de pagamento, verifique o saldo pendente e realize o pagamento. Se o valor total não processar, tente um valor ligeiramente menor (ex.: de US$ 8 para US$ 7).
  3. Atualize ou adicione um novo método de pagamento e aguarde alguns minutos para a Meta processar.

Veja Configurar pagamento.

Erro 131047 — Mais de 24h sem contato

Tentativa de enviar mensagem fora da janela de atendimento de 24 horas. Após 24h desde a última mensagem do cliente, só é possível enviar um modelo (template) aprovado pela Meta.

Como resolver: envie um modelo aprovado. Quando o cliente responder, a janela de 24 horas reabre e a conversa continua normalmente.

Este erro também pode ocorrer ao editar o número do contato durante uma conversa ativa (ex.: adicionar o nono dígito), pois o sistema pode interpretar como um novo contato sem histórico recente.

Erro 131048 — Parâmetro ausente ou limite de qualidade/spam

Problema na estrutura da mensagem ou limitação por qualidade/volume de envio.

Causas mais comuns: parâmetro obrigatório ausente/inválido, baixa classificação de qualidade (muitos bloqueios/denúncias) ou limite de taxa de envio atingido.

Como resolver:

  • Confira se todos os campos obrigatórios estão presentes e no formato correto.
  • Reduza o volume de envios do mesmo número em curto período.
  • Verifique o status de qualidade do número no WhatsApp Manager.
  • Evite mensagens idênticas/repetitivas, que podem ser interpretadas como spam.

Erro 131049 — Limite de mensagens de marketing do destinatário

Restrição aplicada pela Meta relacionada ao limite de mensagens de marketing que o destinatário recebeu recentemente. Não reenvie a mesma mensagem imediatamente.

O que fazer:

  • Envie uma mensagem do tipo Utilidade, se fizer sentido.
  • Aguarde um período maior antes de tentar novamente — o limite pode durar de horas a dias.

Boas práticas: varie os tipos de mensagem (não só marketing) e evite envios excessivos em curto período. Referência: limites de mensagens de marketing.

Erro 131051 — Mensagem não suportada pela API

Aparece quando um contato envia um tipo de conteúdo incompatível com a API Oficial da Meta (WhatsApp, Instagram ou Messenger). A plataforma não consegue exibir ou processar aquele conteúdo.

Exemplos: reações a mensagens, figurinhas animadas/stickers não compatíveis, áudios temporários, formatos muito recentes ainda não suportados e mensagens de bots/automações externas.

O que fazer:

  • Informe ao cliente que o formato não é compatível com a integração oficial.
  • Peça para reenviar em outro formato (texto, imagem, áudio padrão ou documento).

A conversa não é perdida — apenas o conteúdo específico não é exibido. É uma limitação da API da Meta, não um erro da plataforma.

Erro 131056 — Limite de volume de envios atingido

Muitas mensagens de marketing enviadas ao mesmo contato em curto período. A Meta pode pausar temporariamente novos envios de marketing para aquele destinatário. A plataforma continua funcionando normalmente.

Possíveis soluções:

  • Reduza a quantidade de mensagens para cada contato e distribua melhor os envios.
  • Varie os tipos de mensagem, usando também a categoria Utilidade.
  • Monitore o status de entrega; havendo bloqueios frequentes, reduza o volume e aguarde a liberação automática.

Erro 131060 — Mensagem indisponível (Coexistência e CTWA)

Ocorre por um atraso na classificação da conversa pelos servidores do WhatsApp, mais comum em cenários de Coexistência (COEX) com anúncios Click-to-WhatsApp (CTWA).

Quando o cliente envia uma mensagem antes de o WhatsApp exibir o aviso de segurança ("Esta empresa agora usa um serviço seguro da Meta para gerenciar esta conversa"), o conteúdo não é compartilhado com a Cloud API — a mensagem chega sem conteúdo, gerando o erro.

Por que acontece mais em anúncios (CTWA): o usuário clica no anúncio e a mensagem automática é enviada quase imediatamente, muitas vezes no primeiro contato, antes de a Meta concluir o processamento da conversa segura. Dispositivos antigos, internet instável e alto volume simultâneo podem aumentar a incidência.

Como mitigar: segundo a Meta, a única forma de evitar em fluxos CTWA é migrar o número completamente para a Cloud API, deixando o modo de Coexistência com o app físico.

A Meta confirmou que é um comportamento conhecido da plataforma, com maior impacto em números COEX de alto volume, e pretende documentá-lo e revisar a arquitetura no futuro.

Erro 132001 — Modelo não existe

Tentativa de envio de um modelo (template) não registrado ou não reconhecido pela API.

Causas mais comuns: modelo excluído no WhatsApp Manager, nome informado incorretamente, modelo ainda em análise ou reprovado.

Como resolver:

  • Sincronize os modelos com a Meta (ação de um usuário Administrador).
  • Crie um novo modelo se o anterior não existir mais.
  • Se estiver reprovado/em análise, revise o conteúdo e reenvie para aprovação, seguindo as diretrizes da Meta.

Erro 135000 — Falha ao enviar mensagem

Falha ao enviar um modelo (template) durante o atendimento, geralmente por inconsistência na sincronização/validação do modelo com a Meta — o modelo pode estar aprovado na Meta, mas não sincronizado na plataforma.

Como resolver:

  1. Peça a um usuário Administrador para sincronizar os modelos com a Meta.

Se persistir:

  1. Localize o modelo no painel de Modelos de Mensagem de Atendimento.
  2. Duplique o modelo com erro.
  3. Envie a cópia para aprovação da Meta e aguarde.
  4. Após aprovado, teste o envio com o modelo duplicado.

Se o modelo duplicado funcionar, considere duplicar outros modelos com comportamento semelhante para mantê-los atualizados e sincronizados com a Meta.

Erros e problemas

Códigos de erro da Meta, como solicitar revisão de banimento, acessar o suporte e resolver problemas comuns na API Oficial.

Erros do cadastro incorporado

Erros que podem aparecer durante o cadastro incorporado (embedded signup) da Meta — da criação do portfólio e da conta do WhatsApp Business à adição e verificação do número.

Nesta página

Erro 100 — Mensagem não suportadaErro 130472 — Experimento da MetaErro 130497 — Conta comercial impedida de enviar mensagensErro 131000 — Erro desconhecidoErro 131026 — Número não registrado no WhatsAppErro 131031 — Conta restrita ou bloqueadaErro 131042 — Falha no pagamentoErro 131047 — Mais de 24h sem contatoErro 131048 — Parâmetro ausente ou limite de qualidade/spamErro 131049 — Limite de mensagens de marketing do destinatárioErro 131051 — Mensagem não suportada pela APIErro 131056 — Limite de volume de envios atingidoErro 131060 — Mensagem indisponível (Coexistência e CTWA)Erro 132001 — Modelo não existeErro 135000 — Falha ao enviar mensagem