Setelah mengirimkan pesan menggunakan API Chat App Message Service, Anda dapat menerima pembaruan status dan balasan pengguna melalui mode konsumsi Simple Message Queue (SMQ) atau mode dorong batch HTTP.
Catatan penggunaan
Pengecualian jaringan atau timeout respons dapat menyebabkan dorongan tanda terima duplikat atau kegagalan pengambilan.
Mode tanda terima pesan
Anda dapat menerima tanda terima pesan melalui mode konsumsi SMQ atau mode dorong batch HTTP. Pilih mode yang paling sesuai dengan kebutuhan Anda.
Idempotensi tanda terima pesan tidak dapat dijamin. Kami menyarankan agar Anda menerapkan langkah-langkah yang tepat untuk memastikan akurasi dan konsistensi data setelah menerima tanda terima pesan.
SMQ consumption mode
Mode konsumsi SMQ menggunakan antrian di SMQ untuk menerima tanda terima pesan pada Wilayah tertentu. Semua pesan layanan dapat dikirim secara eksternal melalui SMQ. Saat Anda mengaktifkan SMQ dan berlangganan jenis pesan tertentu di Konsol Chat App Message Service, sistem secara otomatis membuat antrian pesan khusus beserta namanya untuk jenis tersebut. Anda kemudian dapat menggunakan SDK untuk mengambil laporan status pesan dari antrian tersebut dengan nama antrian dan jenis pesan yang sesuai.
HTTP batch push mode
Mode dorong batch HTTP mengirimkan data ke URL web tertentu melalui permintaan HTTP POST. Setelah Anda menetapkan URL callback HTTP di Konsol Chat App Message Service, sistem akan mendorong pesan layanan—seperti pesan Mobile Originated (MO) atau tanda terima pengiriman Mobile Terminated (MT)—ke URL yang Anda tentukan.
Jenis tanda terima pesan
Setelah memilih mode tanda terima, berlanggananlah jenis tanda terima spesifik yang ingin Anda terima. Jenis yang tersedia berkaitan dengan event tertentu, seperti pengiriman pesan atau balasan pengguna.
Type | Description | SMQ consumption mode | HTTP batch push mode |
ChatAppInbound (tanda terima pesan MO) | Pesan MO adalah pesan yang dikirim oleh end user ke nomor bisnis Anda. Dengan berlangganan ChatAppInbound, Anda dapat mengambil konten pesan-pesan pengguna tersebut. | ||
ChatAppStatus (tanda terima pesan MT) | Lawan dari pesan MO adalah pesan MT, yaitu pesan yang dikirim ke pengguna. Dengan berlangganan ChatAppStatus, Anda dapat melacak status pengiriman setiap pesan. | ||
ChatAppAudit (status review templat) | Notifikasi ini memberi tahu Anda mengenai status review templat setelah Anda memanggil API |
Konfigurasi mode tanda terima pesan
Tanda terima pesan MT dan MO
Untuk menerima tanda terima pesan, aktifkan terlebih dahulu fitur tanda terima di Konsol Chat App Message Service.
Masuk ke Konsol Chat App Message Service.
Pada panel navigasi di sebelah kiri, pilih Channel Management. Lalu, klik ID channel atau Manage di kolom Actions.
Pada halaman Data Panel channel tersebut, klik fitur di pohon navigasi yang sesuai dengan jenis channel Anda:
Channel WhatsApp: Pilih WABA Management > Configure Webhook.
Channel Viber: Pilih Service Number Management > Webhook Settings.
Channel Messenger: Pilih Facebook Homepage > Configure Webhook.
Channel Instagram: Pilih Professional Account > Configure Webhook.
Konfigurasikan pesan yang ingin Anda berlangganan.
Setelah halaman, akun, atau ID layanan Anda terhubung, klik Configure Webhook dan pilih pesan yang ingin Anda berlangganan.
CatatanStatus Report Callback URL: Untuk ChatAppStatus (tanda terima pesan MT).
MO Message Callback URL: Untuk ChatAppInbound (pesan MO).
Aktifkan HTTP Protocol dan masukkan URL callback. Contohnya:
CatatanKami menyarankan agar Anda menggunakan path URL yang berbeda untuk setiap jenis pesan. Hal ini mempermudah pembedaan pesan. Hindari mengarahkan semua jenis pesan ke satu URL yang sama yang memerlukan penguraian isi pesan.
Pada bidang Status Report Callback URL, masukkan URL callback. Contoh: https://xxxx.com/appstatus.
Pada bidang MO Message Callback URL, masukkan URL callback. Contoh: https://xxxx.com/inbound.
Aktifkan Message Queue Monitoring dan klik OK.
Klik lagi Configure Webhook. Pada kotak dialog yang muncul, Anda dapat menyalin nama Message Receipt Queue dan MO Message Queue.
Status review templat
Hanya channel WhatsApp yang mendukung konfigurasi pesan status review templat.
Masuk ke Konsol Chat App Message Service.
Pada panel navigasi di sebelah kiri, pilih Channel Management. Lalu, klik ID channel atau Manage di kolom Actions.
Pada halaman Data Panel channel tersebut, pilih WABA Management > Channel Webhook Settings.
Aktifkan HTTP Protocol.
Notification Callback URL: Masukkan URL callback. Contoh: https://xxxx.com/appaudit
Aktifkan Message Queue Monitoring dan klik OK.
Klik lagi Channel Webhook Settings. Pada kotak dialog yang muncul, Anda dapat menyalin nama Notification Queue.
Unduh SDK SMQ
Anda dapat mengunduh SMQ Java SDK untuk menarik pesan SMQ.
Tautan Unduh: SMQ Java SDK