Dokumen ini menjelaskan cara platform RCS untuk Bisnis menangani pengiriman pesan dan interaksi API lainnya, dengan membedakan antara operasi sinkron dan asinkron.
Interaksi RBM API umumnya mengikuti pola permintaan-respons sinkron di tingkat HTTP. Namun, hasil dari banyak panggilan API, terutama pengiriman pesan, ditangani secara asinkron melalui webhook. Lihat bagian berikut untuk mengetahui detailnya.
Pengiriman pesan: Permintaan sinkron, pengiriman asinkron
Permintaan API phones.agentMessages.create diproses secara sinkron dari perspektif API. Saat Anda membuat permintaan HTTP ke platform RCS untuk Bisnis, server akan merespons hampir seketika dengan kode status HTTP standar (seperti 200 OK atau error) untuk menunjukkan apakah permintaan diterima dan valid.
Namun, pengiriman pesan yang sebenarnya kepada pengguna akhir diproses secara asinkron. Faktor berikut dapat memengaruhi proses ini:
- Status penerima: Pengguna mungkin sedang offline, baterai habis, atau tidak mengaktifkan RCS.
- Kondisi jaringan: Masalah jaringan operator dapat menunda atau mencegah pengiriman pesan.
Platform RCS untuk Bisnis memberikan update status pengiriman pesan (seperti tanda terima pengiriman dan tanda terima pesan) secara asinkron melalui webhook.
Oleh karena itu, meskipun permintaan API awal bersifat sinkron, Anda harus mengandalkan
peristiwa webhook asinkron
untuk melacak pengiriman pesan. Jangan mengharapkan konfirmasi langsung status pengiriman dari respons
phones.agentMessages.create.
Interaksi RBM API lainnya
Sebagian besar RBM API berbasis HTTP lainnya juga beroperasi dengan model permintaan-respons sinkron. API ini memberikan respons HTTP langsung yang menunjukkan status permintaan (berhasil atau error). Namun, meskipun permintaan bersifat sinkron, tindakan yang dihasilkan dari permintaan tersebut mungkin melibatkan proses asinkron. Misalnya, respons yang berhasil terhadap panggilan API untuk memperbarui informasi agen tidak berarti pembaruan tersebut langsung ditampilkan di mana pun; mungkin ada penundaan singkat dalam penyebaran.
Endpoint webhook: Peristiwa asinkron
Peristiwa berikut dikirim secara asinkron ke endpoint webhook Anda:
- Pesan pengguna masuk: Platform RCS for Business mengirimkan pesan pengguna masuk ke endpoint webhook Anda. Pastikan untuk memverifikasi pesan masuk.
- Tanda terima pengiriman dan tanda terima telah dibaca: Notifikasi pengiriman dan status telah dibaca pesan dikirim melalui webhook.
- Peristiwa percakapan: Beberapa peristiwa terkait percakapan, seperti indikator pengetikan, dikirim melalui webhook.
- Peristiwa habis masa berlaku dan pencabutan pesan: Platform RCS untuk Bisnis mengirimkan peristiwa untuk mengonfirmasi apakah pesan yang habis masa berlakunya berhasil dicabut.