Códigos de erro do WhatsApp (Meta)
Quando uma mensagem não sai pelo WhatsApp Oficial, a Meta devolve um código numérico. Esse número diz o motivo exato da falha. Esta página traduz os códigos de envio de mensagem para uma linguagem prática de clínica, e traz o nome técnico da Meta para a equipe da Auris.
Aqui tratamos só os erros ligados a enviar mensagem (limites, janela de 24h, qualidade do número, modelos, entrega e conta). Erros de configuração técnica ou de permissão de API não entram nesta lista.
Índice rápido
Seção intitulada “Índice rápido”| Código | O que é, em uma linha | O que fazer |
|---|---|---|
| 4 | O sistema disparou chamadas demais em pouco tempo | Reduzir o volume e reenviar depois |
| 80007 | A conta do WhatsApp bateu o limite de uso | Esperar e espaçar os envios |
| 130429 | Mensagens saindo rápido demais | Espaçar os disparos e reenviar |
| 131056 | Mensagens demais para o mesmo contato em pouco tempo | Aguardar antes de reenviar àquele número |
| 131048 | O número está com restrição por qualidade | Melhorar a qualidade e reduzir disparos |
| 131064 | Conta limitada por reincidência em modelos ruins | Corrigir os modelos e aguardar liberação |
| 133016 | Número bloqueou temporariamente por tentativas em excesso | Aguardar a liberação automática |
| 131047 | Passaram mais de 24h desde a última resposta do paciente | Enviar um modelo aprovado |
| 131049 | Limite de marketing por pessoa atingido | Aguardar 24h ou usar aviso de consulta |
| 131050 | O paciente saiu das mensagens de marketing | Não reenviar marketing àquele contato |
| 131026 | O destinatário não recebe mensagens (número inválido ou sem WhatsApp) | Conferir o número com o paciente |
| 130403 | A clínica bloqueou esse contato no WhatsApp | Desbloquear o contato para voltar a falar |
| 368 / 130497 | Conta ou envio restrito por política da Meta | Acionar a Auris para revisar a conta |
| 132000 | Faltou ou sobrou variável no modelo | Conferir os campos do modelo |
| 132001 | Modelo não aprovado ou idioma errado | Confirmar aprovação e o idioma do modelo |
| 132015 / 132016 | Modelo pausado ou desativado por qualidade | Ajustar ou recriar o modelo |
| 131042 | Problema no meio de pagamento da conta | Regularizar o faturamento da conta |
Erros de limitação (rate limit)
Seção intitulada “Erros de limitação (rate limit)”São os mais comuns em disparo de lembretes e campanhas. A Meta limita quantas mensagens saem e em qual velocidade, para proteger a saúde do número. Quase sempre a solução é espaçar os envios e tentar de novo mais tarde.
130429 · Envio acima do limite de velocidade
Seção intitulada “130429 · Envio acima do limite de velocidade”O que aconteceu: as mensagens estão saindo rápido demais, acima da velocidade que a Meta libera para o número naquele momento. Ou seja, muitos disparos saíram quase ao mesmo tempo (por exemplo, uma leva grande de lembretes de manhã) e o número estourou o ritmo permitido.
O que fazer: espaçar os disparos em vez de mandar tudo de uma vez, e reenviar as que falharam depois de alguns minutos. Se acontece sempre em campanha ou lembrete em massa, dividir o envio em blocos menores ao longo do dia resolve.
Nome na Meta: Message Throughput Limit.
131056 · Muitas mensagens para o mesmo contato
Seção intitulada “131056 · Muitas mensagens para o mesmo contato”O que aconteceu: foram enviadas mensagens demais para o mesmo paciente em um intervalo curto. Ou seja, o WhatsApp entendeu como excesso para aquele número específico (por exemplo, várias tentativas seguidas de confirmar a mesma consulta).
O que fazer: aguardar antes de reenviar para aquele contato. Mensagens para outros pacientes seguem funcionando normalmente. Evite reenvio automático em sequência para o mesmo número, e revise fluxos que reenviam sozinhos quando o paciente não responde na hora.
Nome na Meta: Recipient Flooding (Spam Rate Limit).
4 · Limite de chamadas do aplicativo
Seção intitulada “4 · Limite de chamadas do aplicativo”O que aconteceu: o sistema fez chamadas demais à API da Meta em pouco tempo. Ou seja, o limite estourado é o do aplicativo que conecta ao WhatsApp, não o do número da clínica em si.
O que fazer: reduzir o volume e reenviar depois. Costuma se resolver sozinho ao baixar o ritmo. Como o limite é técnico (do aplicativo), se persistir a Auris cuida do ajuste, não é algo que a clínica configure sozinha.
Nome na Meta: Application Rate Limit (código 4).
80007 · Limite da conta do WhatsApp
Seção intitulada “80007 · Limite da conta do WhatsApp”O que aconteceu: a conta do WhatsApp da clínica (WABA) bateu o limite de uso permitido. Ou seja, o limite aqui é da conta inteira, somando todos os envios, e não de um número ou aplicativo isolado.
O que fazer: esperar e espaçar os envios ao longo do dia. Se acontecer com frequência, pode ser sinal de que o volume da clínica cresceu, e a Auris revisa os limites da conta com a Meta.
Nome na Meta: WhatsApp Business Account Rate Limit.
131048 · Restrição por qualidade do número
Seção intitulada “131048 · Restrição por qualidade do número”O que aconteceu: o número está com restrição na quantidade de mensagens que pode enviar, por causa da qualidade. Ou seja, muitos pacientes bloquearam ou denunciaram as mensagens desse número, e a Meta reduziu o limite dele como proteção.
O que fazer: reduzir disparos e revisar o status de qualidade no WhatsApp Manager (aparece como verde, amarelo ou vermelho). Melhorar o conteúdo (mensagens mais claras, só para quem espera receber, sem excesso de marketing) recupera a qualidade, e a restrição afrouxa sozinha conforme o número volta ao verde.
Nome na Meta: Phone Number Quality Restrictions.
131064 · Limite por reincidência em modelos ruins
Seção intitulada “131064 · Limite por reincidência em modelos ruins”O que aconteceu: a conta atingiu o limite de mensagens por acumular violações de classificação de modelos. Ou seja, vários modelos foram marcados como fora do padrão (por exemplo, um modelo de utilidade usado na prática para vender), e a Meta somou essas violações até restringir a conta.
O que fazer: revisar e corrigir os modelos apontados, garantindo que a categoria (utilidade ou marketing) combine com o conteúdo real da mensagem. A restrição é liberada automaticamente depois de um período.
Nome na Meta: Template Classification Violation Limit.
133016 · Bloqueio temporário por tentativas em excesso
Seção intitulada “133016 · Bloqueio temporário por tentativas em excesso”O que aconteceu: o número foi bloqueado por tentativas demais de registro ou de conexão em pouco tempo. Ou seja, houve várias tentativas seguidas de conectar/reconectar o número (por exemplo, repetir o processo de ativação várias vezes), e a Meta travou por um tempo.
O que fazer: aguardar a liberação automática, sem repetir a conexão em sequência. Se você está no meio de uma migração ou reconexão e travou aqui, pare as tentativas e acione a Auris para conduzir.
Nome na Meta: Registration/Deregistration Attempt Limit.
Janela de 24 horas e marketing
Seção intitulada “Janela de 24 horas e marketing”O WhatsApp separa dois tipos de conversa: dentro de 24 horas desde a última resposta do paciente (mensagem livre liberada) e fora dessa janela (só modelo aprovado). Os erros abaixo aparecem quando essa regra é ferida.
131047 · Janela de 24 horas fechada
Seção intitulada “131047 · Janela de 24 horas fechada”O que aconteceu: passaram mais de 24 horas desde a última mensagem do paciente. Ou seja, a conversa “esfriou”: fora dessa janela de 24h o WhatsApp só permite mensagem por modelo aprovado, não texto livre.
O que fazer: enviar um modelo aprovado (template) para reabrir a conversa (por exemplo, um lembrete de consulta ou uma retomada de atendimento). Assim que o paciente responder, a janela de 24h abre de novo e a Auris volta a conversar livremente.
Nome na Meta: Re-engagement Message (fora da janela de 24h).
131049 · Limite de marketing por pessoa
Seção intitulada “131049 · Limite de marketing por pessoa”O que aconteceu: a Meta bloqueou o envio da mensagem para manter o ecossistema saudável. Cada pessoa recebe um número limitado de mensagens de marketing por período. Ou seja, esse paciente provavelmente já recebeu várias mensagens de marketing.
O que fazer: aguardar 24h ou mais antes de reenviar uma mensagem com template de marketing àquele contato. Avisos e informativos (utilidade) não entram nesse limite, prefira-os para comunicação. Portanto, a clínica pode enviar um template de utilidade, principalmente se for para confirmar consultas, lembrar de preparos, validar informações ou solicitar documentos.
Nome na Meta: Per-User Marketing Template Limit.
131050 · Paciente saiu do marketing
Seção intitulada “131050 · Paciente saiu do marketing”O que aconteceu: o paciente escolheu parar de receber marketing dessa clínica no WhatsApp. Ou seja, ele clicou em algo como “parar promoções” ou pediu para sair, e a Meta registra essa vontade.
O que fazer: não reenviar mensagens de marketing para esse contato, isso é respeitar a escolha dele e proteger a qualidade do número. Mensagens de utilidade (confirmar consulta, lembrar preparo, avisar resultado) seguem permitidas normalmente.
Nome na Meta: User Marketing Opt-Out.
Entrega ao destinatário
Seção intitulada “Entrega ao destinatário”131026 · Mensagem não entregável
Seção intitulada “131026 · Mensagem não entregável”O que aconteceu: o destinatário não recebe a mensagem. Ou seja, aquele número não é um WhatsApp válido: geralmente foi digitado errado no cadastro, não tem conta no app, não aceitou os termos ou está com versão muito antiga.
O que fazer: conferir o número com o paciente (DDD e o dígito 9), confirmar que ele usa WhatsApp e, se for o caso, pedir que atualize o app. Vale também revisar o cadastro, porque muitas vezes é erro de digitação na ficha.
Nome na Meta: Message Undeliverable (Invalid/Inactive Recipient).
130403 · Contato bloqueado pela clínica
Seção intitulada “130403 · Contato bloqueado pela clínica”O que aconteceu: a própria clínica bloqueou esse paciente no WhatsApp, então nenhuma mensagem chega a ele. Ou seja, o bloqueio partiu do número da clínica em algum momento (às vezes sem querer, num contato antigo).
O que fazer: desbloquear o contato no WhatsApp da clínica para voltar a conversar. Depois de desbloquear, a Auris consegue enviar de novo normalmente.
Nome na Meta: User Blocked by Business.
Política e conta
Seção intitulada “Política e conta”368 e 130497 · Restrição por política da Meta
Seção intitulada “368 e 130497 · Restrição por política da Meta”O que aconteceu: a conta do WhatsApp foi restrita ou desabilitada por violar uma política da plataforma (368), ou o envio está barrado para certos países (130497). Ou seja, a Meta entendeu que algo feriu as regras dela e limitou a conta, não é um problema de volume ou velocidade.
O que fazer: acionar a Auris. Esse caso é analisado junto com a Meta (às vezes com pedido de revisão da conta) e não se resolve só espaçando envios.
Nome na Meta: Account/Integrity Policy Violation.
131042 · Problema de pagamento
Seção intitulada “131042 · Problema de pagamento”O que aconteceu: há um erro no meio de pagamento ou faturamento da conta do WhatsApp, o que trava o envio. Ou seja, a Meta cobra pelas conversas e algo no pagamento falhou (por exemplo, cartão vencido, recusado ou sem forma de pagamento configurada).
O que fazer: regularizar o faturamento na conta da Meta (cartão válido ou linha de crédito ativa). A Auris orienta o passo a passo de onde ajustar.
Nome na Meta: Payment Method Error.
Modelos de mensagem (templates)
Seção intitulada “Modelos de mensagem (templates)”Erros que aparecem ao disparar um modelo aprovado. Detalhes de cadastro em Templates de WhatsApp — Guia.
132000 · Variáveis do modelo não batem
Seção intitulada “132000 · Variáveis do modelo não batem”O que aconteceu: o número de variáveis enviadas é diferente do que o modelo espera. Ou seja, o modelo tem campos para preencher (nome do paciente, data, horário) e algum ficou de fora ou veio a mais.
O que fazer: conferir se todos os campos do modelo foram preenchidos, na ordem certa. Se o modelo espera nome, data e hora, os três precisam ir juntos e na sequência definida no cadastro.
Nome na Meta: Parameter Count Mismatch.
132001 · Modelo não existe ou não aprovado
Seção intitulada “132001 · Modelo não existe ou não aprovado”O que aconteceu: o modelo não existe naquele idioma ou ainda não foi aprovado pela Meta. Ou seja, ou o modelo ainda está em análise/rejeitado, ou foi disparado num idioma diferente do que foi cadastrado.
O que fazer: confirmar no WhatsApp Manager que o modelo está com status aprovado e que o idioma (ex.: pt_BR) confere com o que foi disparado. Modelo recém-criado costuma levar um tempo até a Meta aprovar.
Nome na Meta: Template Not Approved / Language Missing.
132015 e 132016 · Modelo pausado ou desativado
Seção intitulada “132015 e 132016 · Modelo pausado ou desativado”O que aconteceu: o modelo foi pausado por baixa qualidade (132015) ou desativado de vez após pausas repetidas (132016). Ou seja, muitos pacientes bloquearam ou ignoraram mensagens desse modelo, e a Meta parou de deixar usá-lo.
O que fazer: para o pausado, ajustar o conteúdo (mensagem mais clara, menos insistente, só para quem espera receber) e melhorar a qualidade. Para o desativado, não adianta editar: é criar um modelo novo com conteúdo diferente.
Nome na Meta: Low-Quality Template Paused / Permanently Disabled Template.
Referências
Seção intitulada “Referências”- Fonte oficial dos códigos: Meta for Developers — WhatsApp error codes.
- Regras de janela de 24h e conexão oficial: API Oficial do WhatsApp.
- Cadastro e qualidade de modelos: Templates de WhatsApp — Guia.