Webhook Status Pesan WhatsApp: Terkirim, Dibaca, sampai Gagal

Kamu kirim pesan lewat API Jalinara, dapat respons sukses, terus bagaimana caranya tahu pesan itu beneran sampai atau dibaca pelanggan? Di sinilah gunanya webhook status pesan - cara sistemmu tahu perkembangan pesan yang kamu kirim tanpa harus cek manual satu-satu di dashboard.

Beda webhook status pesan dengan webhook pesan masuk

Ini yang sering bikin bingung, jadi perlu ditegaskan di awal. Webhook pesan masuk melaporkan chat baru yang datang dari pelanggan ke nomormu - itu soal pesan yang masuk. Webhook status pesan yang dibahas di artikel ini soal arah sebaliknya: melaporkan status pesan yang kamu kirim, apakah sudah terkirim, sampai ke perangkat penerima, dibaca, atau malah gagal.

Dua webhook ini beda event, beda kegunaan, dan biasanya didaftarkan sebagai endpoint yang terpisah di sistemmu. Kalau kamu cuma pasang salah satu, kamu cuma dapat separuh gambaran dari percakapan yang sedang berjalan.

Empat status yang perlu kamu tahu

Webhook status pesan Jalinara melaporkan empat kondisi utama:

• sent - pesan sudah berhasil dikirim dari sisi Jalinara.
• delivered - pesan sudah sampai di perangkat penerima.
• read - penerima sudah membuka dan membaca pesannya.
• failed - pesan gagal terkirim.

Urutan status ini biasanya berjalan bertahap: sent dulu, baru delivered, baru read. Tapi tidak semua pesan pasti sampai ke status read - tergantung apakah penerima membuka pesannya atau tidak.

Kenapa harus realtime lewat webhook

Bayangkan kamu kirim ratusan notifikasi transaksi dalam sehari. Kalau harus cek manual satu-satu di dashboard mana yang sudah terkirim dan mana yang gagal, itu kerjaan yang tidak masuk akal buat dilakukan terus-menerus. Webhook status pesan menghilangkan kebutuhan itu - begitu ada perubahan status, sistemmu langsung dapat kabarnya, didorong otomatis oleh proses pengiriman Jalinara tanpa kamu harus polling atau cek ulang secara berkala.

Sistem eksternal seperti aplikasi invoice atau notifikasi transaksi otomatis bisa memanfaatkan ini buat update status secara otomatis begitu tahu pesan sudah terkirim atau dibaca, tanpa campur tangan manual dari tim kamu.

Alur kerja konkretnya

Supaya lebih jelas, begini alur umum dari kirim pesan sampai sistemmu update record terkait:

1. Kamu kirim pesan lewat API Jalinara.
2. Respons API memberi kamu ID unik untuk pesan tersebut (messageId).
3. Sistemmu menyimpan messageId itu, dikaitkan dengan record terkait - misalnya nomor invoice.
4. Begitu status pesan berubah, webhook masuk ke endpoint yang sudah kamu daftarkan, membawa messageId yang sama plus status terbaru.
5. Sistemmu mencocokkan messageId itu dan mengupdate record terkait - misalnya menandai invoice sebagai "sudah dinotifikasi".

Semua ini jalan tanpa perlu ada orang yang buka dashboard dan cek manual satu per satu.

Contoh payload webhook

Sebagai ilustrasi konsep, payload yang dikirim webhook status kurang lebih membawa informasi seperti ini:

{
  "messageId": "msg_8a2f91",
  "status": "delivered",
  "timestamp": "2026-07-27T10:15:00Z",
  "target": "628123456789"
}

Ini cuma ilustrasi untuk menggambarkan konsepnya, bukan skema resmi persis. Struktur payload yang detail dan lengkap ada di dokumentasi API Jalinara.

Kalau status "failed", bukan berarti ada error di Jalinara

Status gagal itu wajar terjadi dan penyebabnya biasanya di luar kendali sistem pengiriman. Beberapa penyebab umum:

• Nomor tujuan tidak valid atau salah format.
• Nomor tujuan tidak terdaftar di WhatsApp.
• Kontak sudah memblokir nomor pengirim.

Kalau kamu lihat banyak status failed, cek dulu kualitas daftar nomor yang kamu kirimi, bukan buru-buru menyimpulkan ada masalah di sisi infrastruktur pengiriman Jalinara.

Webhook status pesan mengubah "semoga sampai" jadi kepastian yang bisa dicatat sistemmu sendiri, tanpa harus menebak-nebak.

Simpan riwayat status ini di sistemmu sendiri, terutama kalau statusnya dipakai untuk keperluan seperti audit trail atau bukti notifikasi transaksi. Jangan cuma mengandalkan tampilan dashboard sebagai satu-satunya sumber riwayat, karena sistemmu sendiri yang paling tahu konteks bisnis di balik tiap pesan yang dikirim.