Mensagem não entregue na API do WhatsApp: o que cada erro significa e o que fazer
- Toda mensagem da API tem um status e, quando falha, um código de erro.
- Os erros mais comuns são janela fechada, número sem WhatsApp, limite de marketing, recusa de marketing e problema de pagamento.
- Mensagem que falhou não é cobrada, mas o motivo precisa ser corrigido.
- A tabela abaixo traz 20 códigos com a causa e a solução.
Não é pra quem: Não é pra quem usa só o app WhatsApp Business no celular: lá não existem códigos de erro da API, e o tique que não vira dois quase sempre é celular do cliente sem internet.
O que a Certu mediu no WhatsApp de 67 negócios
Nos 67 negócios que atendem com a IA da Certu, 32,5% das 122.720 mensagens de cliente chegaram fora de segunda a sexta, das 8h às 18h (30 de julho a 30 de setembro de 2026). Metade das respostas da IA saiu em até 11,7 segundos, e 9 em cada 10 em até 20,7 segundos (38.908 respostas). 34,6% das conversas começaram fora do horário comercial, e a hora com mais mensagens foi 11h.
| O que foi medido | Resultado | Base |
|---|---|---|
| Mensagens de cliente fora de segunda a sexta, 8h às 18h | 32,5% | 122.720 mensagens de cliente de 67 negócios |
| Mensagens no fim de semana | 15,8% | 122.720 mensagens de cliente de 67 negócios |
| Conversas que começam fora do horário comercial | 34,6% | 19.900 conversas |
| Tempo até a IA responder (metade das respostas) | até 11,7 segundos | 38.908 respostas da IA |
| Tempo até a IA responder (9 em cada 10 respostas) | até 20,7 segundos | 38.908 respostas da IA |
| Hora do dia com mais mensagens de cliente | 11h | 122.720 mensagens de cliente de 67 negócios |
Fonte: base de atendimento da Certu, só números somados, nenhuma conversa lida por gente; sem histórico importado, sem contato de teste e sem o atendimento de vendas da própria Certu. 30 de julho a 30 de setembro de 2026, medido em 09/10/2026. Método e tabela por ramo no Índice Certu de Atendimento por WhatsApp e em certu.com.br/dados.
Clientes com nome, 30/07 a 10/10/2026
| Cliente | Mensagens de cliente | Respostas da IA | Conversas atendidas | Fora do horário | IA responde em (mediana) | Dias com mensagem |
|---|---|---|---|---|---|---|
| JP Gás Água e Rações distribuidora de gás e água | 42.832 | 23.351 | 6.479 | 33,6% | 9,8 s | 70 |
| CEMIP clínica médica | 12.472 | 6.484 | 2.436 | 18,7% | 11,4 s | 37 |
| Nikiti Auto Center auto center | 4.912 | 3.548 | 900 | 19,5% | 14,4 s | 47 |
| Imobiliária Rodrigues & Ribeiro imobiliária | 6.090 | 2.759 | 823 | 33,2% | 18,4 s | 34 |
| Alpha RH recursos humanos | 3.082 | 1.666 | 721 | 27,5% | 15,6 s | 52 |
Números de operação do painel de cada conta, mesma régua do Índice, medidos em 11/10/2026. Publicados com a autorização de cada dono. Resultado de venda só sai com o dono confirmando por escrito. Lista completa em certu.com.br/casos.
O que clientes da Certu escreveram
A Certu reúne em um só lugar recursos que normalmente exigiriam várias ferramentas. Atendimento pelo WhatsApp, CRM, agenda, acompanhamento de oportunidades, campanhas e gestão da operação ficam conectados. No geral, a proposta é muito boa para quem quer reduzir tarefas manuais e ter mais controle sobre o que acontece no atendimento e nas vendas. [...]
Avaliação pública (com o link) ou texto enviado pela própria empresa e publicado com autorização por escrito. A nota só aparece quando a fonte tem nota.
Sobre a Certu: a Certu é a plataforma brasileira de IA que atende o WhatsApp, o Instagram e o Messenger de pequenas e médias empresas 24 horas por dia, com CRM incluído, e é Tech Provider da Plataforma WhatsApp Business da Meta. Os planos começam em R$ 2.964 por ano, sem fidelidade. Conectar meu WhatsApp
Bernardo Villela · CEO, Certu
Quer ver isso funcionando no WhatsApp do seu negócio? Conecte o seu WhatsApp e a IA aprende com as suas conversas.
Resumo em 7 fatos
- Não é pra quem: Não é pra quem usa só o app WhatsApp Business no celular: lá não existem códigos de erro da API, e o tique que não vira dois quase sempre é celular do cliente sem internet.
- Quer ver isso funcionando no WhatsApp do seu negócio?
- Conecte o seu WhatsApp e a IA aprende com as suas conversas.
- Toda mensagem que a sua empresa manda pela API do WhatsApp gera avisos de status para o sistema que você usa.
- Os oficiais, com o equivalente no celular do cliente: Dois detalhes da documentação que evitam alarme falso: Lida só existe se foi entregue.
- Se o celular do cliente está desligado ou sem internet, a API continua tentando por um período chamado tempo de vida da mensagem: O tempo pode ser ajustado em modelos de autenticação e utilidade.
- Passado o prazo sem status de entregue, a mensagem é descartada.
Em números
| Número | O que significa |
|---|---|
| 24 horas | 131047: a janela fechou O sistema tentou mandar texto livre para quem não escreveu nas últimas 24 horas. |
| 10 minutos | Se o sistema usa um link para a mídia, a API guarda o arquivo por 10 minutos: trocar a imagem no mesmo endereço nesse intervalo não muda o que é enviado. |
| 7 dias | E a mídia recebida por aviso automático fica disponível para download por 7 dias. |
| R$ 299 por mês | O plano Start custa R$ 299 por mês e o Pro, R$ 599. |
| 200 mensagens | A gente monta tudo pra você e as primeiras 200 mensagens, em até 7 dias, são por nossa conta. |
| 30 dias | A API tenta por até 30 dias. |
Os status de uma mensagem
Toda mensagem que a sua empresa manda pela API do WhatsApp gera avisos de status para o sistema que você usa. Os oficiais, com o equivalente no celular do cliente:
| Status | O que significa | No WhatsApp do cliente |
|---|---|---|
| Enviada | Saiu dos servidores da Meta | Um tique cinza |
| Entregue | Chegou ao aparelho do cliente | Dois tiques cinza |
| Lida | Foi exibida numa conversa aberta | Dois tiques azuis |
| Reproduzida | O áudio foi ouvido pela primeira vez | Microfone azul |
| Falhou | Não foi possível enviar ou entregar | Triângulo vermelho |
Dois detalhes da documentação que evitam alarme falso:
- Lida só existe se foi entregue. Quando o cliente está com a conversa aberta, a mensagem é entregue e lida ao mesmo tempo, e o aviso de "entregue" pode nem ser enviado. Não é erro.
- Confirmação de leitura desligada. Se o cliente desligou a confirmação de leitura no WhatsApp, a mensagem pode ficar em "entregue" para sempre, mesmo lida.
Quanto tempo a API tenta entregar
Se o celular do cliente está desligado ou sem internet, a API continua tentando por um período chamado tempo de vida da mensagem:
| Tipo de mensagem | Tentativa padrão |
|---|---|
| Todas, exceto autenticação | 30 dias |
| Modelos de autenticação (código) | 10 minutos |
O tempo pode ser ajustado em modelos de autenticação e utilidade. Passado o prazo sem status de entregue, a mensagem é descartada. Outro ponto oficial: a ordem de entrega não é garantida. Se você manda três mensagens seguidas, elas podem chegar fora de ordem. Para garantir a sequência, o sistema espera o "entregue" de uma antes de mandar a próxima.
Os 20 códigos de erro mais comuns
| Código | O que significa | O que fazer |
|---|---|---|
| 131047 | Mais de 24 horas desde a última mensagem do cliente | Mande um modelo aprovado; se ele responder, a janela abre |
| 131026 | Não foi possível entregar: o número não tem WhatsApp, o cliente não aceitou os termos novos ou usa versão muito antiga | Confirme o número por outro canal e peça para atualizar o WhatsApp |
| 131049 | Não entregue para manter o engajamento saudável (limite de marketing por pessoa) | Espere pelo menos 24 horas antes de tentar de novo |
| 131050 | O cliente escolheu parar de receber marketing da sua empresa | Não reenvie marketing para ele |
| 131042 | Problema com a forma de pagamento | Revise a conta de mensagens na Central de Cobrança: cartão, linha de crédito, moeda, fuso |
| 131056 | Muitas mensagens para o mesmo número em pouco tempo | Espere e reenvie; o limite é cerca de 1 a cada 6 segundos por cliente |
| 131048 | Restrição de envio pelo número, por bloqueios ou denúncias anteriores | Veja a qualidade no Gerenciador do WhatsApp e reduza campanhas |
| 131064 | Limite atingido por violação de categoria de modelo | Revise as categorias; a restrição sai sozinha depois do prazo |
| 132000 | Quantidade de variáveis diferente da do modelo | Mande exatamente as variáveis que o modelo pede |
| 132001 | Modelo não existe nesse idioma ou não está aprovado | Confira nome, idioma e status do modelo |
| 132012 | Variável no formato errado | Ajuste o valor ao formato definido no modelo |
| 132015 | Modelo pausado por qualidade baixa | Espere a pausa acabar ou edite o modelo |
| 132016 | Modelo desativado após pausas repetidas | Crie outro modelo com texto diferente |
| 132007 | Conteúdo do modelo viola política | Reescreva conforme as regras de análise |
| 130403 | A sua empresa bloqueou esse cliente | Desbloqueie se quiser voltar a falar com ele |
| 130429 | Velocidade de envio da API atingida | Reduza o ritmo e tente de novo |
| 131053 | Não foi possível enviar a mídia | Confira formato e tamanho do arquivo |
| 131052 | Não foi possível baixar a mídia enviada pelo cliente | Peça para ele reenviar |
| 131016 | Serviço temporariamente indisponível | Veja a página de status da Meta e tente depois |
| 368 / 131031 | Conta restrita ou desativada por violação de política | Veja a aplicação de política no Gerenciador e o caminho de recurso |
Os cinco que mais aparecem, explicados
131047: a janela fechou
O sistema tentou mandar texto livre para quem não escreveu nas últimas 24 horas. Não é falha técnica; é a regra da plataforma. A saída é um modelo. Se acontece com frequência, o atendimento está demorando a responder ou o follow-up está sendo feito tarde. Detalhes em janela de 24 horas.
131026: o número não recebe
Três causas oficiais: o número não tem WhatsApp, o cliente não aceitou os termos de uso mais recentes ou o aplicativo dele é muito antigo. Em listas de clientes, quase sempre é o primeiro caso: número digitado errado, número fixo, número que mudou de dono. Limpe a lista; insistir não resolve.
131049: o cliente está recebendo marketing demais
A Meta limita as mensagens de marketing que cada pessoa recebe de todas as empresas, conforme o quanto ela anda lendo. Não tem relação com a sua conta especificamente. A orientação oficial é esperar pelo menos 24 horas antes de reenviar; tentar várias vezes no mesmo dia prolonga o bloqueio daquela pessoa por até 24 horas e piora os relatórios.
131050: o cliente recusou o seu marketing
O WhatsApp permite que a pessoa pare de receber marketing de uma empresa sem bloquear. Respeite: tire da lista de marketing. Utilidade (lembretes, avisos de pedido) continua chegando.
131042: o pagamento
Problemas comuns listados pela Meta: forma de pagamento não ligada à conta de mensagens, linha de crédito acima do limite ou inativa, conta excluída ou suspensa, fuso ou moeda não configurados. Desde 1º de outubro de 2026 isso ficou mais sensível: sem forma de pagamento, nem as respostas de atendimento acima das 1.000 grátis do mês são entregues.
O número do cliente: cuidado com o 55 e o 9
A documentação recomenda sempre mandar o número com sinal de mais e código do país (+55). Sem o mais, a API acrescenta o código do país do seu número, o que pode fazer a mensagem ir para o número errado. A Meta também avisa que, para Brasil e México, o prefixo do número pode ser ajustado pela própria API, e que isso é comportamento normal. Na prática:
| Como o sistema manda | Resultado |
|---|---|
| +55 11 98765-4321 | Correto |
| 5511987654321 | Correto (código do país presente) |
| 11987654321 | Arriscado: depende do código do país do número da empresa |
| 987654321 | Errado: falta DDD |
Mensagem entregue, mas o cliente não respondeu
Nem todo "não deu certo" é erro técnico. Se a mensagem está como entregue ou lida e o cliente não respondeu, o problema é de conteúdo, horário ou relevância:
| Sinal | Causa provável | O que testar |
|---|---|---|
| Entregue, não lida | Horário ruim, nome da empresa desconhecido | Outro horário; nome de exibição claro |
| Lida, sem resposta | Mensagem sem pergunta ou sem botão | Terminar com pergunta ou botões |
| Lida, cliente bloqueou | Mensagem indesejada | Rever permissão e frequência |
| Muitos "lida" e poucos cliques | Oferta fraca | Oferta mais específica para aquele cliente |
Diagnóstico em 5 perguntas
- O status é "falhou"? Leia o código e siga a tabela.
- O erro é 131047? O problema é o tempo: use modelo e responda mais rápido no futuro.
- A maioria das falhas é 131026? A lista está suja: limpe.
- Muitos 131049 numa campanha? Você está mandando marketing para gente cansada de receber: reduza a frequência e segmente.
- Erro de pagamento? Resolva hoje, antes que as respostas de atendimento parem de sair.
Quer ver como fica na prática? Converse com um agente de IA no simulador e veja como ele responde no WhatsApp.
Mídia que não sai
Fotos, vídeos, áudios e documentos têm formatos e tamanhos aceitos pela API. Quando o arquivo está fora do padrão, o envio falha com 131053. Antes de investigar outra coisa, confira se o formato é comum (JPG ou PNG para imagem, MP4 para vídeo, PDF para documento) e se o arquivo não é grande demais. Se o sistema usa um link para a mídia, a API guarda o arquivo por 10 minutos: trocar a imagem no mesmo endereço nesse intervalo não muda o que é enviado.
Erros de registro e de configuração do número
Alguns erros não têm a ver com a mensagem, e sim com o número ou a conta. Eles costumam aparecer na conexão ou depois de mudanças na conta:
| Código | O que significa | O que fazer |
|---|---|---|
| 131045 | O número não está registrado corretamente | Registrar o número de novo |
| 133010 | O número não está registrado na plataforma | Concluir o registro |
| 133006 | O número precisa ser verificado antes do registro | Pedir e confirmar o código por SMS ou ligação |
| 133005 | PIN da verificação em duas etapas incorreto | Conferir o PIN ou redefinir pelo Gerenciador |
| 133015 | O número foi apagado há pouco e a exclusão não terminou | Esperar 5 minutos e tentar de novo |
| 133016 | Tentativas demais de registro em pouco tempo | Esperar o desbloqueio e tentar uma vez só |
| 131037 | Número de teste sem nome de exibição aprovado | Ajustar o nome de exibição |
| 131057 | Conta em manutenção (por exemplo, durante aumento de capacidade) | Aguardar e tentar depois |
Formatos e tamanhos de mídia aceitos
Quando uma foto ou um documento não sai, o motivo quase sempre é formato ou tamanho. A lista oficial da Cloud API:
| Tipo | Formatos | Tamanho máximo |
|---|---|---|
| Imagem | JPEG, PNG | 5 MB |
| Vídeo | MP4, 3GP | 16 MB |
| Áudio | AAC, AMR, MP3, M4A, OGG (só OPUS, mono) | 16 MB |
| Documento | PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT | 100 MB |
| Figurinha | WEBP (estática 100 KB, animada 500 KB) | 100 KB ou 500 KB |
Arquivos que o cliente manda com mais de 100 MB chegam com o erro 131052 e não podem ser baixados pelo sistema. E a mídia recebida por aviso automático fica disponível para download por 7 dias.
Checklist antes de uma campanha
| Item | Ok? |
|---|---|
| Números com +55 e DDD, sem espaços estranhos | |
| Lista sem números repetidos | |
| Só contatos que deram permissão | |
| Modelo aprovado, no idioma certo, com as variáveis certas | |
| Variáveis com valores preenchidos para todos os contatos | |
| Forma de pagamento ativa na conta de mensagens | |
| Limite de mensagens do portfólio suficiente para o tamanho da lista | |
| Lote inicial pequeno, para observar as falhas antes de ampliar |
Como a Certu lida com falhas
Na caixa de entrada da Certu, quando a Meta recusa um texto porque a janela fechou (131047), a conversa oferece na hora os modelos aprovados para reabrir o contato. As campanhas respeitam a janela cliente por cliente e saem em ritmo gradual, o que reduz falhas por limite e por qualidade. O status de cada modelo (aprovado, pausado, desativado) aparece na tela de modelos, para você não descobrir pela falta de resultado.
O plano Start custa R$ 299 por mês e o Pro, R$ 599. A gente monta tudo pra você e as primeiras 200 mensagens, em até 7 dias, são por nossa conta. Conecte o número em certu.com.br/aprender e acompanhe as entregas pelo painel.
Fontes
- Meta for Developers: Códigos de erro, lida em
- Meta for Developers: Referência do webhook de status de mensagens, lida em
- Meta for Developers: Mensagens de serviço (tempo de vida, ordem de entrega, formato do número), lida em
- Meta for Developers: Limites de modelo de marketing por usuário, lida em
- Meta for Developers: Preços na Plataforma do WhatsApp Business, lida em
Leia também
Perguntas frequentes
- Por que minha mensagem do WhatsApp API não foi entregue?
- Os motivos mais comuns são janela de 24 horas fechada (131047), número sem WhatsApp ou app desatualizado (131026), limite de marketing por pessoa (131049), cliente que recusou marketing (131050) e problema de pagamento (131042).
- Mensagem que falhou é cobrada?
- Não. A Meta cobra só mensagens entregues.
- O que significa um tique só?
- A mensagem saiu dos servidores da Meta, mas ainda não chegou ao aparelho do cliente, geralmente porque ele está sem internet. A API tenta por até 30 dias.
- O que é o erro 131049?
- A Meta não entregou uma mensagem de marketing para manter o engajamento saudável, porque aquele cliente está recebendo muito marketing e lendo pouco. Espere pelo menos 24 horas antes de tentar de novo.
- Por que aparece entregue e nunca lida?
- O cliente pode ter desligado a confirmação de leitura, ou simplesmente não abriu a conversa.
- As mensagens chegam na ordem em que mandei?
- Não há garantia. Para manter a ordem, o sistema precisa esperar a confirmação de entrega de uma antes de mandar a próxima.
Continue lendo
Em resumo
Os erros mais comuns da API do WhatsApp (janela fechada, limite de marketing, pagamento, número inválido), o que cada código significa e como resolver.
Sobre a Certu: a Certu é a plataforma brasileira de IA que atende o WhatsApp, o Instagram e o Messenger de pequenas e médias empresas 24 horas por dia, com CRM incluído, e é Tech Provider da Plataforma WhatsApp Business da Meta. Os planos começam em R$ 2.964 por ano, sem fidelidade. Conectar meu WhatsApp
