Entender os status de entrega
Cada mensagem que você envia tem um status que indica até onde chegou, desde "a caminho" até "lida pelo cliente". O Feed Connect o mostra como um pequeno ícone no balão, e o registro da mensagem guarda a palavra exata. Este artigo explica o significado de cada status por canal, os ícones, por quanto tempo são atualizados na tela e a causa comum de as marcas pararem de avançar.
Os ícones de status do balão
| Ícone | Significado |
|---|---|
| Relógio | Em andamento: aceita pelo REDA Connect e sendo processada no provedor |
| Marca de verificação | O provedor a aceitou (Enviado / Aceito) |
| Marca de sucesso | Entregue ao telefone do cliente |
| Marca de sucesso (verde) | Lida pelo cliente (somente WhatsApp) |
| Marca vermelha de erro | Falhou ou Não entregue: o motivo aparece dentro do balão |
Clique em Detalhes abaixo de qualquer balão para ver o status em palavras e a linha do tempo completa: criação, envio, entrega e leitura (ou recebimento para as recebidas). Somente as marcas de tempo existentes são mostradas.
Status do WhatsApp
As mensagens de WhatsApp de saída seguem este caminho:
Enviado → Entregue → Lido, ou Falhou.
- Enviado: o WhatsApp aceitou a mensagem.
- Entregue: chegou ao telefone do cliente.
- Lido: o cliente abriu. (Você só recebe Lido se as configurações de privacidade do WhatsApp dele permitirem confirmações de leitura; a ausência desse status não prova que não tenha lido).
- Falhou: o WhatsApp rejeitou. O motivo recebido do WhatsApp é salvo na mensagem e mostrado no balão e no painel de detalhes.
Os status podem chegar da rede fora de ordem; o feed sempre mantém a etapa mais avançada: uma mensagem nunca retrocede de Lido para Entregue.
Status de SMS
As mensagens SMS de saída (pela Twilio) têm um vocabulário mais amplo:
Na fila / Aceito / Enviando → Enviado → Entregue, ou Não entregue / Falhou.
- Na fila, Aceito, Enviando: etapas dentro da Twilio antes de passar a mensagem à operadora. Ver Na fila logo após enviar é normal.
- Enviado: entregue à operadora.
- Entregue: a operadora confirmou a entrega ao aparelho.
- Não entregue: a operadora não conseguiu entregar (número inacessível, filtragem ou problemas de roaming). É tratado como falha: marca vermelha e motivo na mensagem.
- Falhou: rejeitada antes de chegar ao provedor ou por ele; o motivo está na mensagem.
SMS não tem status Lido: as operadoras não o informam.
Mensagens recebidas
As mensagens recebidas têm o status Recebido. Mostram o indicador de respondida em vez de marcas de entrega; consulte Receber e responder.
Por quanto tempo os status são atualizados
As confirmações de entrega do provedor podem chegar ao longo de horas ou dias, e o registro é atualizado sempre que chegam. Enquanto está aberto, o feed atualiza ao vivo as marcas de mensagens recentes, com estes limites:
- WhatsApp: as marcas são atualizadas até o status Lido, por até 5 dias.
- SMS: até Entregue, por cerca de 30 minutos após o envio.
Após o limite, o feed deixa de acompanhar aquela mensagem, mas nada se perde: uma confirmação tardia atualiza o registro, e você verá o status final na próxima vez que a conversa carregar ou clicar em Atualizar.
Quando as marcas param de avançar: a causa comum
Se todos os SMS ficam em Enviado e nunca mostram Entregue, o problema comum é o endereço de retorno de status: ele deve terminar com uma barra final. Se for salvo sem ela, as confirmações da Twilio não são reconhecidas. A solução é corrigir um campo; consulte Conectar os webhooks da Twilio. As confirmações dos dois canais também dependem do Site público; consulte Criar o Site público para receber mensagens.
| Sintoma | Causa provável | Onde corrigir |
|---|---|---|
| Todos os SMS ficam em Enviado para sempre | Falta a barra final na URL de retorno de status | Conectar os webhooks da Twilio |
| Nenhum status avança em nenhum dos canais | O Site público está ausente ou mal configurado | Criar o Site público |
| Uma mensagem mostra Falhou | O provedor rejeitou aquela mensagem | Leia o motivo no balão ou nos detalhes; depois consulte Uma mensagem não está sendo enviada |
| WhatsApp entregue, mas nunca lido | O cliente desativou as confirmações de leitura ou não abriu | Não há nada a corrigir: o status Lido não é garantido |
Perguntas frequentes
Não: Entregue significa que chegou ao telefone. Somente Lido (WhatsApp, se permitir confirmações) indica que foi aberta.
Não: Na fila é a primeira etapa normal dentro da Twilio. Normalmente passa para Enviado e Entregue em segundos ou minutos.
No próprio balão da mensagem com falha e no painel Detalhes. O motivo fica salvo no registro, então também pode ser incluído em relatórios; consulte Relatórios e painéis.
Não. As confirmações atualizam o registro quando chegam; o feed mostra o status atual na próxima vez que carrega aquela conversa.
Próximos passos
- Uma mensagem não está sendo enviada: trabalhar com uma mensagem com falha.
- Conectar os webhooks da Twilio: corrigir a barra final.
- Receber e responder: o indicador de mensagens recebidas.