Mensagem da API do WhatsApp não entregue: as causas, em ordem
Uma mensagem aceita pela API do WhatsApp não é uma mensagem entregue: a Meta informa o resultado depois, em um webhook de status, como status sent, delivered, read ou failed, com um código de erro. Verifique nesta ordem: o status failed e seu código, a janela de 24 horas (131047), o método de pagamento (131042), o template (132001, 132015), o destinatário (131026, 131049, 131050) e, por último, os limites e a conexão do número.
A easyCoexistence monitora cada número conectado o tempo todo, envia um e-mail quando a Meta para de entregar, derruba a conexão ou reduz a qualidade, e encaminha os webhooks de status da Meta sem alterações para o seu sistema.
sent (um tique), delivered (dois tiques), read (dois tiques azuis) e failed (um triângulo vermelho de erro), como os webhooks de status os informam.
Já se passaram mais de 24 horas desde a última resposta do destinatário; a Meta indica enviar um template no lugar.
Não foi possível entregar: o número não está no WhatsApp, o destinatário não aceitou os novos termos ou usa uma versão antiga do WhatsApp.
Tempo padrão em que o WhatsApp repete a entrega de um template de utilidade ou de marketing não entregue antes de descartá-lo; templates de autenticação têm padrão de 10 minutos.
Throughput fixo de um número usado tanto no app do WhatsApp Business quanto na Cloud API.
Por que uma mensagem aceita ainda não chega?
Porque a resposta da API e a entrega são dois eventos separados. Ao enviar, a Meta retorna um id da mensagem assim que aceita a requisição; se a mensagem chega ao celular do cliente, isso é informado depois, em um webhook de status no campo messages. sent significa que saiu dos servidores da Meta (um tique), delivered que chegou ao aparelho (dois tiques), read que foi aberta (dois tiques azuis) e failed que não pôde ser enviada ou entregue, mostrada a você em um array errors: code, title e error_data.details. Por isso, o primeiro passo nunca é adivinhar: encontre o status failed desse id da mensagem e leia o código. Se você não tiver um destino de webhook, nada registra isso.
Quais são as causas, na ordem em que devem ser verificadas?
Das mais comuns em um número recém-conectado às mais raras. Cada item indica o código da Meta, para que o status failed mostre em qual caso você está:
- Janela fechada: 131047, mais de 24 horas desde a última mensagem do cliente. Mensagens livres precisam de uma janela aberta; envie um template.
- Pagamento: 131042, ou templates descartados em silêncio. Desde 1º de outubro de 2026, as mensagens de serviço também param depois de mil mensagens por mês sem um método de pagamento.
- Template: 132001 não aprovado ou idioma errado, 132000 número errado de variáveis, 132012 formato errado, 132015 pausado, 132016 desativado.
- Destinatário: 131026 fora do WhatsApp, versão antiga ou termos não aceitos; 131050 parou as mensagens de marketing; 131049 retido para manter o engajamento saudável; templates de marketing para números dos EUA não são entregues.
- Limites: 131048 restrito após sinais de spam, 131056 mensagens demais para uma mesma pessoa, 130429 throughput, 20 mensagens por segundo em um número de Coexistência.
- Conta: 131031 ou 368, a conta do WhatsApp Business restrita ou desativada por violação de política.
- Conexão: o número não está mais vinculado, por exemplo depois de 14 dias sem abrir o app do WhatsApp Business.
Como lidar com os códigos do lado do destinatário?
De forma diferente, porque alguns merecem repetir e outros nunca. 131050 significa que a pessoa decidiu sair da lista de mensagens de marketing enviadas por você: a Meta diz para não repetir, e o webhook user_preferences informa quando ela para ou volta a receber. 131049 é a Meta retendo uma mensagem de marketing para manter o engajamento saudável, muitas vezes um limite por usuário em templates de marketing: a Meta recomenda esperar pelo menos 24 horas antes de reenviar, já que reenviar antes só retorna o mesmo erro. 131026 abrange números fora do WhatsApp, usuários que não aceitaram os termos atuais do WhatsApp e versões do app muito antigas; verifique antes o formato do número e o código do país e, depois, fale com o cliente por outro canal.
Por quanto tempo o WhatsApp continua tentando entregar?
Pelo tempo de vida da mensagem (TTL). Quando o celular está desligado ou fora de cobertura, o WhatsApp repete a entrega em vez de falhar de imediato: por padrão, por 30 dias em templates de utilidade e de marketing, e por 10 minutos em templates de autenticação. Uma empresa pode encurtar isso por template com message_send_ttl_seconds, de 30 segundos a 12 horas para utilidade e de 30 segundos a 15 minutos para autenticação. Uma mensagem que não pode ser entregue dentro do TTL é descartada. Assim, uma mensagem com status sent e sem status delivered depois de horas normalmente está aguardando o celular do cliente, e não perdida; defina um TTL curto para códigos e alertas urgentes, para que uma entrega atrasada nunca confunda ninguém.
O que isso significa para respostas de IA e automações?
Leia primeiro a execução e depois o status. Na aba Runs, uma execução Skipped não enviou nada e informa o motivo: "More than 24 hours since the customer's last message", "You answered this chat from your phone recently" ou "AI reply limit for this chat reached this hour". Uma execução Done significa que a Meta aceitou todas as respostas, o que não é prova de entrega. A easyCoexistence não armazena status de mensagens: com as automações ativas, eles chegam à sua URL de encaminhamento, se você definir uma, e no modo direto vão para o seu próprio endpoint. Pelo ChatGPT ou pelo Claude, peça à sua IA para executar get_number_health: ela retorna o status ao vivo, a classificação de qualidade e os últimos 15 eventos de monitoramento, incluindo um bloco sending com o código da Meta.
Como configurar
- Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
- Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
- Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
- Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
- Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.
Erros comuns
- Repetir em um 131050. A pessoa parou as mensagens de marketing vindas de você; novas tentativas nunca são entregues e só podem somar sinais negativos.
- Tomar um id de mensagem como entregue. A Meta aceita primeiro e informa as falhas depois, então um fluxo que para no id deixa passar cada mensagem recusada.
- Enviar uma resposta livre um dia depois. Depois de 24 horas sem mensagem do cliente, só um template é aceito.
- Operar sem um destino de webhook. Os status de falha chegam apenas por webhook; sem ele, o motivo de uma mensagem não ter chegado se perde.
Sua IA pode verificar um número pelo ChatGPT ou pelo Claude com get_number_health. De US$ 9 até US$ 0.75 por número por mês, com o valor caindo conforme você adiciona números, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Por que a mensagem mostrou um tique por horas?
Um tique é o status sent: a Meta enviou, mas o celular ainda não recebeu, geralmente porque está desligado ou offline. O WhatsApp continua repetindo até o tempo de vida do template acabar, 30 dias por padrão para utilidade e marketing.
Por que as respostas chegam, mas os templates não?
Geralmente é um problema de método de pagamento na conta do WhatsApp Business. A Meta entrega mensagens de serviço dentro da cota mensal gratuita do número sem um, mas não entrega templates. Adicione um cartão em Billing & payments.
Dá para ver mensagens com falha no app do WhatsApp Business?
Não de forma confiável. Em um número de Coexistência, as mensagens enviadas pela API aparecem na conversa do app, mas o motivo da falha só aparece no código de erro do webhook de status.
A Meta cobra por mensagens que não foram entregues?
Não. A Meta cobra apenas por mensagens entregues, e tentativas com um template pausado também não são cobradas.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em