Dengan mengonfigurasi antrian Simple Message Queue (SMQ) atau URL HTTP, Anda dapat menerima tanda terima pengiriman setelah mengirim pesan. Hal ini memungkinkan Anda memantau status pengiriman pesan dan menyesuaikan layanan sesuai kebutuhan, sehingga memastikan kinerja optimal dan pengalaman pengguna yang baik.
Jika terjadi error jaringan atau respons melebihi batas waktu selama pengiriman pesan, tanda terima pengiriman mungkin dikirim berulang kali atau gagal diterima.
Perlu beberapa waktu hingga konfigurasi pengiriman pesan berlaku. Kami menyarankan Anda menunggu selama 3 menit, lalu memeriksa apakah tanda terima pengiriman telah didorong.
Idempotensi tanda terima pengiriman tidak dapat dijamin. Kami menyarankan Anda menerapkan langkah-langkah yang tepat untuk memastikan kebenaran dan konsistensi data setelah menerima tanda terima pengiriman.
Titik akhir tanda terima pengiriman
Layanan Pesan Singkat menyediakan dua mode untuk menerima tanda terima pengiriman: mode konsumsi Simple Message Queue (sebelumnya MNS) dan mode dorong Batch HTTP. Pilih mode yang paling sesuai dengan kebutuhan Anda.
SMQ queue
Anda dapat mengonfigurasi antrian SMQ untuk menerima tanda terima pengiriman dari wilayah tertentu. Antrian SMQ mendukung semua jenis pesan Alibaba Cloud SMS. Setelah Anda mengaktifkan SMQ untuk berlangganan jenis pesan tertentu di Konsol SMS, SMQ akan secara otomatis membuat antrian tersebut. Anda dapat memanggil SDK SMS untuk menarik tanda terima pengiriman berdasarkan jenis pesan dan nama antrian.
HTTP URL
Anda dapat menyiapkan URL HTTP untuk menerima tanda terima pengiriman atau pesan MO untuk SMS. Untuk mencapai hal ini, SMS menggunakan metode HTTP POST untuk mendorong tanda terima pengiriman atau pesan MO ke URL HTTP yang ditentukan. Anda dapat mengonfigurasi URL callback HTTP di Konsol SMS. Saat pesan layanan dihasilkan, sistem akan mengirim permintaan HTTP POST yang berisi tanda terima pengiriman ke URL callback yang ditentukan, sehingga Anda dapat langsung menerima pesan tersebut.
Jenis tanda terima pengiriman
Anda perlu memilih jenis tanda terima pengiriman yang ingin diterima. Jenis tanda terima pengiriman yang berbeda digunakan dalam skenario yang berbeda. Tabel berikut mencantumkan jenis-jenis tanda terima pengiriman.
Type | Description | SMQ queue | HTTP URL |
MT delivery report (SmsReport) | Laporan pengiriman mobile terminated (MT) adalah pesan (seperti notifikasi atau pesan bisnis) yang dikirim oleh penyedia layanan SMS kepada pelanggan. Laporan pengiriman MT menunjukkan status dan detail pengiriman setiap pesan. |
Konfigurasikan tanda terima pengiriman
Untuk menerima tanda terima pengiriman pesan SMS Anda, Anda perlu mengonfigurasi pengaturan tanda terima pengiriman di Konsol SMS. Lakukan langkah-langkah berikut untuk mengonfigurasi pengaturan tersebut:
Login ke Konsol SMS.
Pada panel navigasi kiri, pilih .
Klik tab API.
Pada bagian SMS Delivery Report Setting, konfigurasikan satu atau beberapa titik akhir untuk tanda terima pengiriman.
Message queue
Aktifkan opsi antrian SMQ.
HTTP URL
Aktifkan opsi URL HTTP.
Masukkan URL HTTP. Contoh: http://push.example.com/contextpath/receive.do.
Klik Save.
Parameter permintaan antrian SMQ
Parameter | Type | Required | Example | Description |
MessageType | String | Yes | SmsReport | Jenis pesan. Tetapkan nilainya ke SmsReport. |
QueueName | String | Yes | Alicom-Queue-*****-SmsReport | Nama antrian. Untuk melihat nama antrian, login ke Konsol SMS, lalu pilih . |