ztgrowth e Sallve ganham bronze no WhatsApp Awards 2026 em Experiência do Cliente, com o case Escute sua Pele no WhatsApp. Ver a notícia →
Desenhar minha cobertura
Guias

Por que a mensagem do WhatsApp não chegou: os erros mais comuns da API

Mensagem do WhatsApp não chegou? Os erros mais comuns da API oficial, o que cada código quer dizer e o que fazer: do número sem WhatsApp à conta travada.

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

  1. 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.
  2. 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.
  3. Olhe a janela. Se a falha é 131047, o fluxo está mandando mensagem livre para quem não escreveu nas últimas 24 horas.
  4. Confira o template. Pausado, desativado ou com variável errada aparece em todos os envios daquele template.
  5. 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.
  6. 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.

Leia também

Guias

Black Friday no WhatsApp: o que mandar, quando e para quem

Calendário de WhatsApp para a Black Friday de 27/11: o que mandar em cada dia, para quem e em que ritmo, sem queimar a base nem a qualidade do número.

Ler →
Glossário

O que é LTV (lifetime value)

LTV é quanto um cliente gasta na loja ao longo da relação. Veja como medir por coorte e como a recompra pelo WhatsApp entra na conta.

Ler →
Glossário

O que é opt-in no WhatsApp

Opt-in é a permissão do cliente para receber mensagens da marca no WhatsApp. Veja o que conta como consentimento, o que não conta e como dar a saída.

Ler →

Quer ver o agente conversando com os seus produtos?

Fale direto com o fundador. Resposta em 5 minutos no horário comercial, sem SDR, sem compromisso.