# Enviado, entregue, lido e falhou: como ler o status de cada mensagem na API do WhatsApp

> O status de mensagem WhatsApp API mostra em que ponto da entrega cada mensagem está: sent (saiu dos servidores), delivered (chegou ao aparelho), read (foi exibida em conversa aberta) e failed (não saiu ou não chegou). A Meta informa cada mudança por webhook. Na AD PRO, o relatório de entrega traz o total enviado, os entregues e as evidências da campanha.

Página original: https://www.adprotecnologia.com.br/disparo-em-massa/status-de-entrega-whatsapp-api
Autor: AD PRO Tecnologia. Publicado em 2026-10-31.

## Quais são os status de uma mensagem na API do WhatsApp?

Cada mensagem enviada pela Cloud API recebe um identificador e passa por estados que a Meta comunica por webhook. Os quatro que importam em campanha são estes, com a definição da documentação oficial:

**Status de mensagem da Cloud API do WhatsApp (fonte: documentação oficial da Meta)**

| Status | O que significa | O que você faz com ele |
| --- | --- | --- |
| sent | A mensagem saiu dos servidores do WhatsApp com sucesso | Confirma que o envio foi aceito; ainda não prova que o contato recebeu |
| delivered | A mensagem chegou ao aparelho do contato | É o número que paga a conta e o que mede o alcance real |
| read | A mensagem foi exibida em uma conversa aberta no aparelho do contato | Sinal de engajamento; só conta depois de entregue |
| failed | Houve falha ao enviar ou ao entregar | Traz o código do erro; é preciso ler a causa e corrigir |

Para mensagens de voz existe ainda o status **played**, que marca a primeira vez que o aparelho do contato reproduz o áudio. Em disparo de texto, imagem e vídeo, você trabalha com os quatro da tabela.

> **Detalhe que confunde o relatório:** Se o contato lê a mensagem no instante em que ela chega, a Meta não envia um aviso separado de delivered. Por isso, um read pode aparecer sem o delivered correspondente na sua ferramenta. Ao contar entregues, some quem tem delivered e quem tem read.

## O que vem dentro de cada aviso de status?

O aviso de status é um pacote de dados enviado pela Meta ao endereço que você cadastrou (o webhook). Ele traz estes campos principais:

- **id:** o identificador da mensagem na Meta. É a chave para cruzar o status com a linha da sua planilha.
- **status:** sent, delivered, read ou failed.
- **timestamp:** o momento em que o aviso foi gerado, em horário Unix.
- **recipient_id:** o telefone do contato.
- **errors:** só aparece na falha. Traz código, título, mensagem, detalhe e um link para a documentação. Os códigos estão em [erros da API do WhatsApp](https://www.adprotecnologia.com.br/disparo-em-massa/codigos-de-erro-whatsapp-api).
- **pricing:** aparece no status sent, junto de delivered ou read, com a categoria da mensagem (marketing, utilidade etc.).

Para entender como esse pacote chega ao seu CRM e vira atendimento, veja [webhook do WhatsApp API](https://www.adprotecnologia.com.br/disparo-em-massa/webhook-do-whatsapp-api) e [o que é webhook](https://www.adprotecnologia.com.br/crm/blog/o-que-e-webhook).

## Como ler o resultado de uma campanha com esses status?

Resultado de disparo é uma sequência de funis. De cada mil mensagens enviadas, nem todas chegam, nem todas são lidas, e só parte responde. Cada etapa mede uma coisa diferente:

**Como cada etapa da campanha se mede**

| Etapa | Fórmula | O que ela diz |
| --- | --- | --- |
| Entrega | entregues ÷ enviados | Qualidade da base (números válidos) e da conta |
| Leitura | lidos ÷ entregues | Força do início da mensagem, do horário e do vínculo com a marca |
| Clique | cliques ÷ entregues | Força da oferta e da chamada para ação |
| Resposta | respostas ÷ entregues | Interesse real; é o que abastece o time comercial |

Exemplo (números fictícios): numa campanha de 10.000 mensagens enviadas, 9.000 entregues e 2.700 lidas, a entrega é de 9.000 ÷ 10.000, ou 90 por cento, e a leitura é de 2.700 ÷ 9.000, ou 30 por cento. Esses valores são só para mostrar a conta, não uma referência de mercado. Compare sempre uma campanha com a anterior da mesma base. O guia [métricas de campanha de WhatsApp](https://www.adprotecnologia.com.br/crm/blog/metricas-de-campanha-de-whatsapp) aprofunda cada indicador. Para calcular a proporção de entregues e agir quando ela cai, veja [taxa de entrega do disparo](https://www.adprotecnologia.com.br/disparo-em-massa/taxa-de-entrega-do-disparo).

Leia "lido" como sinal de engajamento, não como contagem exata de quem viu. A definição oficial é mensagem exibida em conversa aberta, e isso não cobre todas as formas de uma pessoa ter visto o conteúdo.

## Por que algumas mensagens ficam em sent e não viram delivered?

É a dúvida mais comum de quem lê o primeiro relatório. A mensagem saiu, mas o aparelho não confirmou o recebimento. As causas que a documentação da Meta nomeia, em geral, aparecem como falha, e não como um sent parado. Entre as mais frequentes:

- **Número sem WhatsApp, termos não aceitos ou aplicativo desatualizado:** a Meta agrupa essas causas no erro 131026.
- **Limite de marketing por pessoa:** quando o contato já recebeu mensagens de marketing demais, o envio volta com o erro 131049. Veja [mensagem de marketing não entregue](https://www.adprotecnologia.com.br/crm/blog/mensagem-de-marketing-nao-entregue-whatsapp).
- **Contato que pediu para não receber marketing da empresa:** o erro é o 131050.
- **Template pausado por qualidade:** o envio é recusado enquanto o template está pausado. Entenda em [qualidade do número no WhatsApp API](https://www.adprotecnologia.com.br/crm/blog/qualidade-do-numero-whatsapp-api).

Se a diferença entre enviados e entregues for grande, o primeiro lugar para olhar é a base. Validar e higienizar antes do envio reduz esse buraco. Veja [limpeza de base para disparo](https://www.adprotecnologia.com.br/disparo-em-massa/limpeza-de-base-para-disparo).

## E a cobrança: ela acompanha o status?

Sim, no sentido de que a Meta cobra por mensagem **entregue**, por categoria (marketing, utilidade e autenticação) e pelo país do contato. Mensagem que o cliente manda para a empresa não é cobrada. Esse é o motivo de a taxa de entrega mexer tanto no custo real por contato alcançado.

O modelo da AD PRO segue a mesma lógica: o saldo é pré-pago em quantidade de disparos, e o débito acontece conforme as mensagens entregues, comprovado no relatório. A tabela com o valor médio por faixa de volume está em [quanto custa disparo em massa](https://www.adprotecnologia.com.br/disparo-em-massa/quanto-custa-disparo-em-massa).

## Como organizar o resultado em uma planilha simples?

**Planilha de resultado da campanha (colunas para copiar)**

```text
Aba 1: Envios (uma linha por contato)
nome | telefone | variavel_1 | variavel_2 | id_da_mensagem | status | horario_do_status | codigo_do_erro | observacao

Aba 2: Resumo da campanha
Campanha: ____________  Template: ____________  Data do envio: ___/___/_____
Total de contatos na base: ______
Enviados (sent): ______
Entregues (delivered + read): ______
Lidos (read): ______
Falhas (failed): ______

Fórmulas (Google Planilhas ou Excel):
Taxa de entrega = entregues / enviados
Taxa de leitura = lidos / entregues
Falhas por código = contar linhas por codigo_do_erro

Aba 3: Falhas por código
codigo | titulo | quantidade | causa provável | ação feita | reenviar após (horas)

Regra de ouro: nunca reenviar a lista inteira. Reenviar só quem falhou, depois de corrigir a causa e de esperar o prazo do código.
```

> **Como a AD PRO faz:** Há dois níveis de status no serviço da AD PRO. O da mensagem (enviada, entregue, lida, falhou) é o da API oficial e alimenta o relatório de entrega, que traz total enviado, entregues e evidências. O da campanha aparece no portal de disparos, onde você cria a demanda: em análise, teste, aprovado, disparado e relatório. Com os dois, a planilha acima fica pronta em minutos. Veja o formato em [relatório de disparo em massa](https://www.adprotecnologia.com.br/disparo-em-massa/relatorio-de-disparo-em-massa). As respostas podem ir para o time comercial, para o CRM ou para o fluxo combinado; se você ainda não tem CRM, a AD PRO faz a [implementação de CRM](https://www.adprotecnologia.com.br/crm/implementacao-de-crm).

## Perguntas frequentes

### Qual a diferença entre sent e delivered no WhatsApp API?

Sent significa que a mensagem saiu dos servidores do WhatsApp com sucesso. Delivered significa que ela chegou ao aparelho do contato. Só delivered indica que o destinatário foi alcançado, e é o status usado na cobrança por mensagem entregue.

### O que significa o status read na API do WhatsApp?

Significa que a mensagem foi exibida em uma conversa aberta no aparelho do contato. Só conta depois de entregue. Trate como sinal de engajamento, não como contagem exata de quem viu o conteúdo.

### Por que apareceu read sem delivered?

Quando o contato lê a mensagem no momento em que ela chega, a Meta não envia um aviso separado de delivered. Na hora de contar entregues, some os que têm delivered e os que têm read.

### O que fazer com mensagens failed?

Leia o código do erro que vem no aviso, descubra a causa e corrija na origem (base, template, pagamento ou ritmo). Depois reenvie só para quem falhou, respeitando a espera que o código pede, como as 24 horas do erro 131049.

### Como receber os status das mensagens?

Pelo webhook: você cadastra um endereço na Meta e ela envia a esse endereço cada mudança de status, com o id da mensagem. Quem contrata a AD PRO não precisa configurar nada disso, porque o relatório de entrega já traz enviados, entregues e evidências.

### A AD PRO entrega o status de cada mensagem?

A AD PRO entrega o relatório de entrega ao fim da campanha, com total enviado, entregues e evidências. Durante a campanha, o portal de disparos mostra o status da demanda: em análise, teste, aprovado, disparado e relatório.

## Fontes

- [Meta for Developers, webhook de status de mensagens (sent, delivered, read, failed)](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/messages/status), conferido em 2026-10-31
- [Meta for Developers, códigos de erro da WhatsApp Cloud API](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes), conferido em 2026-10-31
- [Meta for Developers, preços da WhatsApp Business Platform](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing), conferido em 2026-10-31
- [Meta for Developers, limite de marketing por pessoa](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits/), conferido em 2026-10-31

---

AD PRO Tecnologia LTDA, CNPJ 68.425.611/0001-15, São Paulo/SP. Atendimento on-line para todo o Brasil. Diagnóstico comercial gratuito de 30 minutos: https://www.adprotecnologia.com.br/#agendar. WhatsApp +55 11 98604-5939. Fatos e preços publicados: https://www.adprotecnologia.com.br/fatos