Message Status
Understand the message lifecycle from queued to delivered or read.
Status lifecycle
queued→
sent→
delivered→
read
| Status | Label | Description |
|---|---|---|
| queued | Menunggu | Message received by the system, waiting to be sent |
| sent | Terkirim | Successfully sent to WhatsApp server |
| delivered | Terkirim ke penerima | Delivered to recipient's phone |
| read | Dibaca | Recipient opened the chat (depends on privacy settings) |
| failed | Gagal | Failed to send (network/ban/rate-limit) |
Read receipt privacy
Note: The
read status is not always available. If the recipient has disabled read receipts in WhatsApp, the status will stop at delivered. This is a platform limitation, not a bug.Get message status
GET /api/v1/messages/:id
// Response
{
"message": {
"id": "msg_9f8ec2a1",
"status": "read",
"to": "628123456789",
"content": "Kode OTP Anda: 482913",
"sent_at": 1723273457892,
"delivered_at": 1723273458421,
"read_at": 1723273461108
}
}