BLOG
Status de mensagem WhatsApp API: enviada, entregue e lida
Status de mensagem WhatsApp API: entenda fila, enviada, entregue e lida, o que fazer quando trava e como usar webhooks. Leia o guia.

O status de mensagem WhatsApp API mostra em que etapa cada mensagem está: na fila, enviada, entregue ou lida. Cada estado diz uma coisa diferente, e confundir um com o outro leva a decisões erradas, como ligar para um cliente que já recebeu o aviso. Veja o que cada etapa significa, o que fazer quando a mensagem trava e como acompanhar tudo por webhook.
Principais pontos
- Resposta de sucesso da API de envio significa apenas mensagem aceita e na fila, não entrega.
- Enviada não prova que o celular recebeu; entregue é a confirmação de que a mensagem chegou ao aparelho.
- Lida pode nunca chegar se o destinatário desativou os recibos de leitura, e isso não é falha.
- Mensagem parada em enviada costuma indicar aparelho offline; o erro 131050 aponta para engajamento, consentimento e qualidade do número.
- Webhook seguro: validar a assinatura X-Hub-Signature-256 no corpo bruto, responder rápido e tratar duplicidade pelo ID da mensagem.
Status de mensagem WhatsApp API: o ciclo completo
Toda mensagem enviada pela API do WhatsApp passa por etapas antes de chegar à pessoa. O status de mensagem WhatsApp API é o registro de em qual delas ela está agora. Quem atende e cobra precisa dessa informação para decidir o próximo passo sem chute.
Os quatro estados em uma linha do tempo
O caminho normal tem quatro paradas:
| Estado | O que indica | O que não indica |
|---|---|---|
| Na fila (aceita) | A API validou o pedido e o colocou para processar | Que a mensagem já saiu |
| Enviada | A mensagem deixou a infraestrutura da Meta rumo à rede do WhatsApp | Que o celular recebeu |
| Entregue | A mensagem chegou ao aparelho (os dois tracinhos cinza) | Que a pessoa viu |
| Lida | A pessoa abriu a conversa onde a mensagem está | Que ela leu com atenção ou concordou |
Existe ainda a falha, um desvio do caminho: a mensagem não segue adiante e vem acompanhada de um código de erro.
Cada mudança de estado chega como um evento separado, por webhook. A ordem de chegada pode variar, então não monte seu sistema supondo que o evento “lida” sempre vem depois do “entregue” no mesmo segundo. A referência de status de mensagens da Meta descreve os estados e os campos de cada evento.
Por que o status importa para quem atende e cobra
Imagine que a financeira da sua empresa envia um aviso de cobrança às 9h. Às 14h, a equipe precisa decidir se liga para o cliente. Se a mensagem está só na fila, o problema é seu: ela nem saiu. Se está enviada há horas, o celular da pessoa pode estar desligado. Se está entregue, o aviso chegou, e a conversa pode seguir para a negociação.
Sem o status, a equipe liga para quem já recebeu ou espera por quem nunca vai receber. Com ele, cada caso ganha uma ação diferente.
O que cada estado significa na prática
Os nomes parecem simples, mas cada um tem uma pegadinha. Aqui vai o que olhar em cada etapa do status de entrega do WhatsApp.
Na fila (aceita): só foi recebida para processar
Quando você dispara uma mensagem pela API, a resposta HTTP 200 OK ou 202 Accepted indica que o pedido foi validado tecnicamente e enfileirado para processamento assíncrono. Ela não confirma que a mensagem foi enviada, muito menos entregue.
Exemplo: seu sistema dispara 200 lembretes de consulta e recebe 200 respostas de sucesso. Isso significa que 200 pedidos foram aceitos. Quantos chegaram ao celular, só os eventos seguintes dirão. Quem para de conferir na resposta da API acaba tratando mensagem na fila do WhatsApp como mensagem entregue.
Enviada: saiu da Meta, mas não prova recebimento
O estado “enviada” confirma que a Meta processou a mensagem e a transmitiu à rede do WhatsApp. Ela deixou a infraestrutura, mas o aparelho do destinatário ainda pode não ter recebido nada. É a ideia por trás de textos como enviada não significa entregue.
Na prática: se uma mensagem urgente está em “enviada”, não conte com ela. Trate como pendente.
Entregue: chegou ao aparelho
“Entregue” significa que o WhatsApp conseguiu falar com o aparelho e a mensagem foi gravada nele, o equivalente aos dois tracinhos cinza. É o estado mais confiável para saber que a mensagem chegou ao celular. Para auditar se um aviso foi recebido, é nele que você se apoia.
Lida: a conversa foi aberta
“Lida” aparece quando a pessoa abre a conversa em que a mensagem está. Aqui está a ressalva de quem pergunta como saber se a mensagem foi lida no WhatsApp API: se o destinatário desativou os recibos de leitura nas configurações de privacidade, a mensagem fica em “entregue” para sempre e o evento de leitura nunca chega.
Isso não é falha. A pessoa pode ter lido e você simplesmente não tem como saber. Por isso, “lida” funciona como um bônus de informação, não como exigência para considerar uma mensagem bem-sucedida.
Mensagem não avança: o que fazer
Mensagem parada gera ansiedade, mas a causa costuma ser uma entre poucas. A tabela abaixo ajuda a ligar o sintoma à causa provável.
| Onde parou | Causa provável | O que fazer |
|---|---|---|
| Na fila | Pedido aceito, ainda em processamento | Aguardar e acompanhar os eventos |
| Enviada por muitas horas | Aparelho desligado, sem conexão ou número inativo | Esperar e ter um plano B |
| Falha (erro 131050) | Proteção do ecossistema: engajamento, consentimento ou denúncias | Pausar envios e revisar a base |
| Entregue, sem lida | Recibos de leitura desativados ou mensagem ainda não vista | Não tratar como erro |
Parada em enviada: aparelho offline ou número inativo
Quando a mensagem fica em “enviada” por muito tempo, o destinatário geralmente está fora de área, com o telefone desligado ou sem dados. O WhatsApp tenta entregar por um período antes de expirar. Alguns guias citam uma janela de 24 a 48 horas; use isso como referência, não como regra.
Para avisos críticos, não espere esse prazo. Defina no seu sistema um tempo de espera e, passado ele, acione outro canal, como e-mail ou uma ligação da equipe. O tempo certo depende da mensagem: um código de acesso vence em minutos, uma fatura tolera mais.
Falha com erro 131050: engajamento e consentimento
O erro 131050 traz a mensagem de que, para manter um ecossistema saudável, a entrega falhou. Segundo a documentação de erros, a Meta bloqueia a entrega para proteger a experiência do usuário, e o motivo costuma estar ligado a baixo engajamento do remetente, envio sem consentimento ou muitos bloqueios e denúncias. Veja o detalhamento em guia de erros de entrega e na referência de status da Meta.
O caminho certo não é insistir nem tentar contornar. É corrigir a origem:
- pare os disparos que estão falhando;
- revise se todos os contatos autorizaram o recebimento;
- confira a qualidade do número no gerenciador do WhatsApp;
- priorize mensagens úteis, de quem já conversou com você.
Se a dúvida é sobre consentimento, o checklist de LGPD para WhatsApp Business mostra o que registrar.
Checklist de diagnóstico em ordem
- Veja em qual estado a mensagem parou: fila, enviada ou falha.
- Se ficou na fila, confirme que o envio não está pausado nem aguardando o intervalo entre mensagens.
- Se está em enviada há horas, considere aparelho offline e acione o plano B definido por você.
- Se falhou, leia o código de erro antes de reenviar.
- Se o erro é 131050, pause, revise o consentimento e a qualidade do número.
- Se está entregue e não lida, aceite que pode ser configuração de privacidade.
Webhook WhatsApp API: como receber os status
Sem webhook, você precisaria consultar a API a cada poucos segundos para saber se algo mudou. Com ele, a plataforma avisa seu servidor quando o estado muda. É o jeito padrão de acompanhar o status de mensagem WhatsApp API, seja no webhook do WhatsApp Cloud API, seja no de plataformas que o repassam.
O que o webhook envia e quando
A cada mudança (enviada, entregue, lida ou falha), seu endpoint recebe uma notificação com o identificador da mensagem, o novo estado e o horário. Seu sistema usa esse identificador para achar a mensagem correspondente e atualizar o registro. Se a mensagem falhou, o evento traz também o código de erro.
Assinatura de webhook WhatsApp: validar o X-Hub-Signature-256
Seu endpoint é uma URL pública. Qualquer pessoa pode enviar a ele um status falso de “entregue”. Por isso, cada notificação da Meta vem com o cabeçalho X-Hub-Signature-256, um HMAC-SHA256 calculado com o segredo do aplicativo. A documentação para criar o endpoint de webhook explica o formato.
A validação segue três regras:
- calcule o HMAC sobre o corpo bruto da requisição, antes de transformá-lo em objeto;
- compare com uma função segura contra ataques de tempo:
crypto.timingSafeEqualem Node ouhmac.compare_digestem Python; - rejeite o que não bater, antes de qualquer processamento.
Sem esse passo, o endpoint aceita eventos falsos e seu painel passa a mostrar entregas que nunca aconteceram.
Responder rápido e evitar duplicidade
O webhook espera um 200 OK em poucos segundos. Se o seu servidor demora ou responde com erro 5xx, a plataforma tenta de novo. Isso é útil, mas pode gerar eventos duplicados ou fora de ordem. Duas medidas resolvem:
- Responda primeiro, processe depois. Valide a assinatura, devolva o 200 e coloque o conteúdo numa fila para processar em segundo plano.
- Use o ID da mensagem como chave de idempotência. Se o mesmo evento chegar duas vezes, você reconhece e ignora a repetição.
Para mais detalhes sobre boas práticas, o guia de webhooks do WhatsApp da Hookdeck é uma boa leitura complementar. E, se você prefere montar o fluxo sem programar, veja o passo a passo do webhook do WhatsApp no n8n.
Como o FlowZap mostra e entrega os estados
O FlowZap é uma plataforma para empresas usarem o WhatsApp em equipe e por API. Em relação aos estados de mensagem, a ideia é que quem atende e quem desenvolve vejam a mesma informação.
No console: na fila, enviada, entregue e lida
No console, cada mensagem aparece com seu estado: na fila, enviada, entregue ou lida. A equipe olha para a conversa e sabe onde a mensagem parou, sem pedir ajuda a quem programa. O envio de texto é feito sem duplicidade, e a fila respeita um intervalo entre os envios, então “na fila” pode ser só a mensagem esperando a vez.
Na API: consultar o estado e receber webhooks assinados
Os mesmos estados estão na API. Você consulta o estado de uma mensagem ou, melhor, recebe os eventos por webhooks assinados. Isso permite validar a assinatura no seu servidor, como descrito acima, antes de confiar no evento. As chaves de API podem ser criadas por organização, por área ou por número, o que ajuda a separar integrações de clientes ou equipes diferentes.
Um exemplo comum: o desenvolvedor da empresa assina o webhook, valida a assinatura e atualiza o status no CRM próprio. Enquanto isso, a equipe de atendimento vê no console onde cada mensagem parou, sem abrir o sistema interno.
Eventos em tempo real e novas tentativas
Se o seu servidor estiver fora do ar por um momento, os webhooks do FlowZap têm novas tentativas, para o evento não se perder por uma instabilidade curta. Para quem prefere acompanhar na tela, há também eventos em tempo real (SSE). Mantenha de qualquer forma a idempotência pelo ID da mensagem, porque uma nova tentativa pode repetir um evento.
A documentação completa está em /docs, e a visão geral dos recursos, em /produto. A conta de API vem em todos os planos; consulte /precos para escolher o seu.
Boas práticas para o seu painel de status
Receber os eventos é metade do trabalho. A outra metade é decidir o que fazer com eles.
Defina o que é sucesso para cada tipo de mensagem
Um código de acesso, um lembrete de consulta e uma cobrança não têm a mesma urgência. Para cada tipo, defina:
- o estado mínimo aceitável (na maioria dos casos, entregue);
- o prazo para disparar um alerta se a mensagem não chegar lá;
- o plano B, como e-mail ou ligação da equipe.
Tratar “entregue” como confirmação mínima evita falsos alarmes e também falsas certezas.
Trate lida como bônus, não como obrigação
Como vimos, quem desativou os recibos de leitura nunca gera o evento. Se o seu painel marca como problema toda mensagem sem “lida”, a equipe vai perseguir clientes que já viram o aviso. Use a leitura como informação extra, por exemplo, para priorizar quem abriu e ainda não respondeu.
Cuide dos dados que você guarda nos logs
O log de status não precisa de tudo. Pelo princípio da necessidade (art. 6º, III, da Lei 13.709/2018, a LGPD), guarde só o que serve ao objetivo: ID da mensagem, horário e estado. Sempre que possível, mascare o telefone e evite gravar o conteúdo das mensagens em registros de monitoramento.
O outro pilar é o consentimento. Mensagens só devem ir para quem autorizou, e é isso também que protege a qualidade do seu número e evita erros como o 131050. O checklist de consentimento ajuda a organizar o registro. Para entender o lado dos custos, veja API do WhatsApp é paga?.
Comece com o FlowZap
Veja o que o FlowZap faz e compare os planos. Para criar a conta, basta o nome da empresa, um e-mail e uma senha: o cadastro não pede cartão de crédito, e o pagamento é por Pix ou cartão de crédito, sem fidelidade.
Perguntas frequentes
Enviada e entregue são a mesma coisa no WhatsApp API?
Não. Enviada indica que a mensagem saiu da infraestrutura da Meta rumo à rede do WhatsApp. Entregue indica que ela chegou ao aparelho do destinatário. Uma mensagem pode ficar em enviada por horas se o celular estiver desligado ou sem conexão.
Como saber se a mensagem foi lida no WhatsApp API?
Pelo evento de status “lida”, recebido por webhook quando a pessoa abre a conversa. Há uma limitação: se o destinatário desativou os recibos de leitura, a mensagem fica em entregue e o evento nunca chega. Isso não é falha.
Uma mensagem aceita pela API pode não chegar?
Sim. A resposta de sucesso da API de envio indica apenas que o pedido foi validado e enfileirado. Depois disso, a mensagem pode falhar, como no erro 131050, ou ficar parada em enviada. Confirme sempre pelos eventos de entregue.
Preciso validar a assinatura do webhook do WhatsApp?
Sim. Cada notificação traz o cabeçalho X-Hub-Signature-256, um HMAC-SHA256 calculado com o segredo do aplicativo. Valide no corpo bruto, com comparação segura contra ataques de tempo. Sem isso, o endpoint pode aceitar status falsos de entrega.
O que significa mensagem na fila no WhatsApp?
Significa que a API aceitou e validou o pedido e o colocou para processamento. Ela ainda não saiu. Em plataformas com intervalo entre envios, a mensagem também pode estar apenas esperando a vez, antes de passar para enviada.
Fontes
Atenda o WhatsApp da empresa em equipe.
Conecte o número por QR code e responda pelo navegador, com a API para integrar seus sistemas.
Cadastro sem cartão de crédito · Pix ou cartão de crédito, sem fidelidade


