Resposta curta: quando a mensagem do WhatsApp não chega, a Meta devolve um código de erro, e ele diz de quem é o problema. Há cinco tipos: o destinatário (número sem WhatsApp, pessoa que parou de receber marketing), a janela de 24 horas (mensagem livre para quem não escreveu nas últimas 24 horas), o template (pausado, desativado, variáveis que não batem), a conta (pagamento, bloqueio, token) e as falhas temporárias da própria Meta. Os três primeiros se resolvem na mensagem ou na lista. Os de conta param todos os envios até alguém agir no Business Manager. E os temporários pedem só uma nova tentativa.
Enviada não é entregue
Antes do código, o caminho da mensagem. Na API oficial (WhatsApp Cloud API), cada envio passa por estados:
| Estado | O que significa |
|---|---|
| Enviada | A Meta aceitou o pedido de envio. Ainda não chegou ao aparelho. |
| Entregue | Chegou ao celular do cliente. É o que a Meta cobra. |
| Lida | O cliente abriu. Depende da confirmação de leitura, que parte das pessoas desliga. |
| Falhou | A Meta não entregou, e diz por quê num código de erro. |
Duas consequências práticas. A primeira: a Meta pode aceitar o envio e falhar depois, quando a mensagem já saiu da plataforma. Por isso, um disparo que "foi enviado" pode ter falhado inteiro. A segunda: mensagem que não foi entregue não é cobrada, então uma taxa de falha alta não aparece na fatura. Ela aparece na receita que não veio.
Os erros mais comuns, por tipo
1. O destinatário
São falhas de uma pessoa, não da campanha. A lista mais limpa reduz esses erros, mas eles nunca chegam a zero.
| Código | O que quer dizer | O que fazer |
|---|---|---|
| 131026 | O número não tem WhatsApp, ou não recebe. | Tirar o número da audiência. Não é opt-out: a pessoa não recusou nada. |
| 131050 | A pessoa parou de receber mensagens de marketing da marca. | Tratar como opt-out. Ela não deve receber marketing de novo. |
| 131049 | A Meta segurou a mensagem para proteger a experiência do usuário. | Não reenviar em seguida. A Meta limita quantos templates de marketing a mesma pessoa recebe. |
| 131009 | A Meta recusou um valor da mensagem: o número de destino, uma variável ou um botão. | Ler o detalhe. Se for número mal formatado, corrigir o cadastro do cliente. |
O 131049 é o que mais confunde, porque o número existe e a pessoa não saiu. A categoria do template importa aqui: é na de marketing que a Meta aplica o limite por pessoa.
2. A janela de 24 horas
| Código | O que quer dizer | O que fazer |
|---|---|---|
| 131047 | A janela de 24 horas fechou, e só template pode sair. | Trocar a mensagem livre por um template aprovado. |
A janela de 24 horas abre quando o cliente escreve e dura 24 horas desde a última mensagem dele. Fora dela, a loja só fala com o cliente por template aprovado. Esse erro aparece quando um fluxo manda mensagem livre (texto, imagem, áudio) para quem não escreveu recentemente.
3. O template
| Código | O que quer dizer | O que fazer |
|---|---|---|
| 132001 | O nome ou o idioma do template não existe na conta. | Recriar o template ou escolher outro. |
| 132015 | A Meta pausou o template por qualidade baixa. | Editar o template ou trocar por outro. |
| 132016 | A Meta desativou o template de vez. | Criar um novo. |
| 132000 | A mensagem manda um número de variáveis diferente do que o template tem. | Conferir as variáveis do envio. |
| 132012 | Uma variável não está no formato que o template espera. | Corrigir o valor da variável. |
| 132005 | O texto com as variáveis preenchidas passou do limite do WhatsApp. | Encurtar o texto ou as variáveis. |
| 132007 | A Meta sinalizou o conteúdo do template por política. | Reescrever o template. |
| 132018 | A mensagem preenche uma parte que o template aprovado não tem, como um cabeçalho. | Alinhar o envio ao template aprovado. |
O template tem nota de qualidade própria, separada da do número. Um template com muita rejeição pode ser pausado ou desativado mesmo com o número no verde. O 132015 é o aviso para reescrever, não para insistir.
4. A conta
Aqui o problema não é de quem recebe. Enquanto o erro está aberto, nenhuma mensagem sai, e mandar para outra lista não muda nada.
| Código | O que quer dizer | O que fazer |
|---|---|---|
| 131042 | Há um problema de pagamento na conta do WhatsApp. | Corrigir a cobrança no Meta Business Manager. |
| 368 | A Meta bloqueou a conta temporariamente por política. | Ver o motivo no Business Manager. |
| 131031 | A Meta travou a conta. | Resolver com a Meta no Business Manager. |
| 0 e 190 | O token de acesso ao WhatsApp é inválido ou venceu. | Reconectar o WhatsApp na integração. |
| 10 e 200 | O aplicativo perdeu a permissão na conta do WhatsApp. | Dar o acesso de novo no Business Manager. |
| 131037 | O nome de exibição do número não foi aprovado. | Aprovar o nome no Business Manager. |
| 133010 | O número não está registrado no WhatsApp. | Registrar o número de novo. |
| 130429 | O número mandou mais rápido do que o WhatsApp permite naquele momento. | Esperar. Passa sozinho. |
| 131048 | A Meta está limitando o número por sinais de spam. | Diminuir o ritmo e rever o conteúdo. |
O 131042 merece atenção depois de outubro de 2026. Desde 1º de outubro, a Meta cobra as mensagens livres dentro da janela de atendimento, e avisou que, sem forma de pagamento cadastrada, deixaria de entregá-las. Se o atendimento parou de entregar respostas, comece por aí. Os detalhes estão em quanto custa mandar mensagem pela API oficial.
5. As falhas temporárias da Meta
| Código | O que quer dizer | O que fazer |
|---|---|---|
| 2 | Serviço temporariamente indisponível. | Tentar de novo depois de alguns segundos. |
| 131000 | "Algo deu errado" do lado da Meta. | Tentar de novo, poucas vezes. |
| 1 | Erro desconhecido na Meta. | Não repetir na hora. Se continuar, consultar o status da Meta. |
O 131000 tem uma pegadinha: a Meta responde com erro, mas não garante que a mensagem não saiu. Uma nova tentativa pode duplicar o envio. Por isso as tentativas devem ser poucas.
Como investigar, passo a passo
- Veja se é uma pessoa ou todo mundo. Uma falha isolada é do destinatário. Muitas falhas com o mesmo código, de uma vez, são do template ou da conta.
- Separe os códigos de conta. Se aparecer pagamento, bloqueio, token ou permissão, pare de procurar na lista: o problema está no Business Manager.
- Olhe a janela. Se a falha é 131047, o fluxo está mandando mensagem livre para quem não escreveu nas últimas 24 horas.
- Confira o template. Pausado, desativado ou com variável errada aparece em todos os envios daquele template.
- Limpe a lista sem confundir os motivos. Número sem WhatsApp sai da audiência. Quem parou de receber marketing é opt-out. São coisas diferentes, e misturar as duas atrapalha a leitura das métricas.
- Acompanhe a qualidade. Número inválido gera erro de entrega, não derruba a qualidade do número. O que derruba é bloqueio e denúncia.
Erros comuns
- Ler "enviada" como "entregue". A Meta aceita o envio e pode falhar depois.
- Reenviar o 131049 no mesmo dia. A Meta segurou a mensagem de propósito. Reenviar bate no mesmo limite.
- Tratar número sem WhatsApp como opt-out. A pessoa não recusou nada. Se ela escrever para a loja, o número volta a valer.
- Continuar disparando com a conta travada. Toda mensagem falha, e a campanha queima a lista.
- Repetir sem limite em erro temporário. No 131000, a mensagem pode ter saído. Muitas tentativas viram mensagem duplicada.
- Mandar mensagem livre fora da janela. O 131047 não se resolve com nova tentativa, só com template.
Como a ztgrowth faz
A ztgrowth opera na API oficial da Meta e trata cada tipo de erro de um jeito:
- Erros temporários com nova tentativa. Nos códigos 2 e 131000, o envio é repetido até duas vezes, depois de 1 segundo e de 4 segundos. O código 1, timeout e falha de rede não são repetidos, porque não garantem que a mensagem não saiu.
- Número sem WhatsApp à parte. No 131026, o cliente é marcado como inalcançável e sai das audiências. Não é opt-out, e a marcação some quando a pessoa escreve para a loja.
- Opt-out aplicado. No 131050, o cliente vira opt-out e deixa de receber mensagens automáticas.
- Janela conferida antes do envio. Na jornada, a plataforma verifica a janela de cada cliente antes de mandar uma mensagem livre. Com a janela fechada, o passo é pulado em vez de tomar o 131047.
- Campanha pausada por erro de conta. Quando os erros de conta passam de 1% dos envios de uma campanha, com pelo menos 50 envios contados, a campanha pausa em vez de seguir queimando a lista. Pagamento, bloqueio, conta travada, token, permissão, nome de exibição e registro do número viram um aviso no portal, com o link para o Meta Business Manager. O aviso some sozinho quando a Meta volta a entregar uma mensagem.
- Ritmo acima do permitido. O 130429 também pausa a campanha, mas não marca a conta como travada, porque passa sozinho.
- Resultado esperado sem alarme. O 131049 fica registrado sem aviso, porque é a Meta aplicando o limite de marketing por pessoa. No 131009, o número mal formatado fica como problema de cadastro do cliente; qualquer outro valor recusado avisa o time.
- Template e spam avisam o time. Os erros de template (132001, 132015, 132016, 132000, 132012, 132005, 132007, 132018), o 131048 e o erro desconhecido (1) avisam o time da ztgrowth no canal de qualidade do número, com o que cada código quer dizer.
- Saúde da conta verificada de hora em hora. A plataforma confere o token, a conexão do aplicativo e do número com a conta do WhatsApp e a qualidade dos números, para o time agir antes de o envio começar a falhar.
- Falhas por código no portal. A tela WhatsApp Quality mostra as falhas por código de erro da Meta, com o que cada um quer dizer, nos dias antes de cada mudança de qualidade.
- Template de jornada vigiado. Quando um template de jornada passa a falhar acima do normal, o time da ztgrowth é avisado.
Para ver como as campanhas pausam por qualidade e por limite, veja como fazer disparos no WhatsApp sem bloquear o número.
Perguntas frequentes
A Meta cobra mensagem que não foi entregue?
Não. A Meta só cobra mensagem entregue. Uma taxa de falha alta não aumenta a fatura, mas é venda que não acontece.
Por que a mensagem aparece como enviada e não chega?
Porque a Meta pode aceitar o envio e falhar depois. O código de erro chega depois, no status da mensagem.
O que fazer quando todas as mensagens falham ao mesmo tempo?
Procure um erro de conta: pagamento (131042), bloqueio (368), conta travada (131031), token ou permissão. Enquanto ele estiver aberto, nada sai. A correção é no Meta Business Manager ou na reconexão da integração.
Número sem WhatsApp derruba a qualidade do número?
Não. Gera erro de entrega, não rejeição. O que pesa na qualidade é bloqueio, denúncia e silenciamento. Limpar a base ajuda a ler as métricas, mas não é o que protege a nota.
Devo reenviar a mensagem que falhou?
Depende do código. Erro temporário (2 e 131000) vale uma nova tentativa, poucas vezes. Janela fechada (131047) pede um template. Opt-out (131050), número sem WhatsApp (131026) e a mensagem que a Meta segurou (131049) não devem ser reenviados.
Quer os envios pela API oficial com nova tentativa, pausa por erro de conta e as falhas explicadas por código? Fale com a ztgrowth.