# 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](/books/canais-e-integracoes/page/reconectar-um-canal-que-caiu-ou-trocar-de-numero).

### 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.

## Artigos relacionados
- [Por que minha mensagem não foi entregue?](/books/perguntas-frequentes/page/por-que-minha-mensagem-nao-foi-entregue)
- [Reconectar um canal que caiu ou trocar de número](/books/canais-e-integracoes/page/reconectar-um-canal-que-caiu-ou-trocar-de-numero)
- [Meu WhatsApp pode ser bloqueado? Como evitar](/books/perguntas-frequentes/page/meu-whatsapp-pode-ser-bloqueado-como-evitar)
- [Enviar um modelo de mensagem (WhatsApp Oficial)](/books/atendimentos/page/enviar-um-modelo-de-mensagem-whatsapp-oficial)