Status de entrega
Consulte o estado conhecido de uma mensagem no provedor.
Faça GET /api/v1/messages/{id} usando o providerMessageId retornado no envio.
{
"providerMessageId": "3EB0A1B2C3",
"conversationId": null,
"contentType": "TEXT",
"direction": "OUTBOUND",
"ack": 2,
"ackName": "DELIVERED",
"status": "delivered",
"createdAt": "2026-08-27T18:30:00.000Z"
}| Status | Significado |
|---|---|
sent | Aceita pelo canal ou aguardando confirmação posterior |
delivered | Entregue ao dispositivo do destinatário |
read | Marcada como lida pelo destinatário |
failed | Falha conhecida depois da aceitação |
Os acknowledgements dependem do provedor e nem toda mensagem percorre todos os estados. Trate sent como aceitação do disparo, não como confirmação de leitura.
Polling
Use backoff progressivo — por exemplo, após 2 s, 5 s, 15 s, 30 s e 60 s — e pare quando chegar a read ou failed, ou quando seu prazo de negócio expirar.