Setiap pesan WhatsApp yang kamu kirim lewat Wazapin bakal ngelewatin beberapa status — dari aplikasi kamu sampai nyampe di HP penerima.
Visualisasi lifecycle
📤Send
→
⏳Queued
→
✅Delivered
→
👁️Read
Diagram di atas ngasih gambaran alur pesan WhatsApp pada umumnya — dari kekirim sampai kebaca.
Kapan ini kepake?
Pantau lifecycle ini pas kamu:
- Mastiin notifikasi penting kayak OTP beneran nyampe di HP user.
- Ngukur read rate buat chat marketing atau CS.
- Troubleshooting pesan yang telat atau gagal kekirim.
- Nanganin webhook yang kekirim dobel.
Status lifecycle
| Status | Artinya |
|---|---|
queued |
Pesan udah diterima Wazapin dan masuk antrean outbox. |
sent |
Wazapin berhasil nerusin pesan ke jaringan WhatsApp/Meta. |
delivered |
Pesan udah nyampe di HP penerima (centang dua di WhatsApp). |
read |
Penerima udah buka pesannya (centang dua biru). |
failed |
Pesan gagal kekirim — misal nomor nggak valid atau session udah ketutup. |
Cara tracking status
Ada dua cara buat mantau update status ini:
- Webhook (paling enak): Subscribe ke event
message.status_update. Wazapin bakal nge-push update status ke server kamu real-time. - GET Polling: Hit endpoint GET /v1/messages/{messageID} buat ngecek status pesan terkini.
Idempotency pengiriman
Webhook Wazapin pakai mekanisme retry biar pengiriman dijamin nyampe — kadang bikin event kekirim dobel. Biar nggak ke-proses dua kali:
- Deduping event webhook yang masuk dengan ngecek header
svix-id(atauwebhook-id). - Detail lengkapnya ada di Message lifecycle dan idempotency.