Status de mensagem e o que cada um quer dizer#
O cliente não respondeu e você não sabe se ele não quis, não viu, ou não recebeu. O status de cada mensagem responde isso — e é o primeiro lugar a olhar antes de cobrar o cliente por silêncio.
Os quatro estados#
| Estado | O que significa | O que fazer |
|---|---|---|
| Não enviado | A mensagem não saiu. A Meta ou o provedor recusaram | Ler o motivo, que vem junto |
| Enviado | Saiu do sistema e foi aceita pelo WhatsApp | Esperar |
| Entregue | Chegou ao aparelho do cliente | Esperar |
| Visto | O cliente abriu a conversa | O silêncio é escolha dele |
"Entregue" e "Visto" só aparecem se o cliente tiver a confirmação de leitura ligada — a ausência de "Visto" não prova que ele não leu.
O estado que mais importa: "Não enviado"#
Este é o único que exige ação, e ele nem sempre existiu de forma visível. Havia um caso em que a mensagem recusada pela Meta ficava na tela com o risquinho de enviada, indistinguível da que chegou — e o atendente só descobria pelo silêncio do cliente, que é o pior jeito possível de descobrir.
Hoje a falha aparece com o motivo junto, traduzido. Quando o código não é conhecido, aparece o texto do provedor: pior, mas verdadeiro. Uma mensagem que falhou nunca fica sem motivo na tela.
Os motivos e o que fazer com cada um estão em Erros comuns da Cloud API.
Por que o status às vezes "volta atrás"#
Os estados chegam por avisos separados da mensagem, e podem chegar fora de ordem. As regras são:
- Um "entregue" atrasado não apaga o "visto" que já chegou. O que já foi lido continua lido.
- A falha vence tudo que ainda não chegou ao aparelho, e perde de "entregue" e "visto". O que o aparelho recebeu não falhou.
- Uma mensagem marcada como falha pode voltar a "entregue" se a confirmação chegar depois — a Meta reprocessa envios, e o que aconteceu de fato vale mais do que a ordem em que os avisos chegaram.
Ou seja: um status que muda depois não é defeito da tela. É informação nova chegando.
Como fazer#
- Abra a conversa e olhe o indicador ao lado da mensagem.
- Se estiver como não enviada, leia o motivo.
- Trate o motivo — reenviar sem entendê-lo costuma repetir o erro. Em vários casos (
131049,131050,130472), reenviar dá exatamente o mesmo resultado. - Se a mensagem foi entregue e o cliente não responde, o problema não é técnico.
Se algo der errado#
Todas as mensagens ficam em "Enviado" e nunca avançam. As confirmações chegam por webhook. Se ele não está entregando no seu servidor, os estados param no primeiro. Confira a publicação do webhook — veja Erros comuns da Cloud API.
A mensagem aparece como entregue e o cliente jura que não recebeu. Confira se o número está certo e se não há um segundo WhatsApp no mesmo número. Vale também confirmar por outro canal.
A mensagem foi apagada pela empresa e o status ficou estranho. O aviso de mensagem apagada não é um estado de entrega e não é desenhado como tal.
No Baileys os estados são os mesmos? Os quatro estados são os mesmos na tela. O que muda é a origem da informação e a existência dos códigos de erro da Meta.