Layanan notifikasi memerlukan cara mengirim teks sekaligus rute menuju ponsel penerima. Memilih antarmuka hanya menjawab bagian pertama dari masalah itu.
Apa fungsi masing-masing bagian?
API menerima permintaan secara programatis. Gateway menjembatani aplikasi Anda dan jaringan seluler.
Aplikasi Anda mengirimkan penerima, pengirim, dan pesan melalui antarmuka. Gateway meneruskan pesan ke layanan jaringan yang mengirimkannya. Penyedia dapat menyediakan kedua bagian dalam satu layanan.
Referensi SMPP gateway menjelaskan gateway yang menghubungkan aplikasi dengan pusat pesan seluler. Dokumen tersebut juga menjelaskan gateway yang menawarkan beberapa antarmuka, termasuk HTTP dan SMPP.
Antarmuka tidak menentukan semua kemampuan pengiriman. Format permintaan yang praktis tidak dapat membuat pengirim yang tidak didukung menjadi valid di suatu tujuan.
Antarmuka mana yang harus saya pilih?
Pilih HTTP untuk aplikasi baru kecuali integrasi SMPP yang sudah ada atau persyaratan koneksi tertentu membenarkan pengelolaan SMPP.
Dengan HTTP, aplikasi Anda membuat permintaan dan memproses respons. Aplikasi tetap memerlukan coba lagi, perlindungan pengiriman ganda, dan penanganan event pengiriman.
SMPP menggunakan koneksi yang tetap terbuka. Klien Anda mengautentikasi sesi dan menangani kehilangan koneksi, acknowledgment, serta operasi masuk. SMPP menjelaskan pekerjaan tersebut.
Sistem SMPP yang sudah ada dapat menjadikan antarmuka itu pilihan praktis. Uji operasi dan batas yang didukung penyedia sebelum mengasumsikan koneksi SMPP lain berperilaku identik.
Kemampuan pengiriman apa yang harus saya bandingkan?
Bandingkan cakupan tujuan, pengirim yang diizinkan, throughput, dan laporan kegagalan yang berguna dengan kebutuhan aplikasi Anda.
- Tujuan: pastikan dukungan untuk setiap negara yang Anda layani, karena satu rute yang berfungsi tidak menjamin rute lain.
- Pengirim: periksa ketersediaan dan registrasi sebelum memilih identitas yang akan dilihat penerima.
- Throughput: bedakan batas permintaan dari kecepatan jalur pengiriman dalam membawa lalu lintas.
- Event: verifikasi bagaimana pesan masuk dan kegagalan pengiriman sampai ke aplikasi Anda.
Halaman tujuan Bird menerbitkan persyaratan khusus negara. Jenis pengirim menjelaskan pilihan identitas.
Mengapa pengiriman tiba terpisah dari penerimaan?
Jaringan dapat menyelesaikan pengiriman setelah permintaan pengiriman Anda selesai.
Pusat pesan dapat menyimpan teks selama ponsel tidak dapat dijangkau. Pusat pesan menjelaskan tahap penantian tersebut.
Simpan pengiriman dan penerimaan sebagai hasil terpisah di aplikasi Anda. Jika tidak, permintaan yang diterima dapat tampak berhasil meskipun laporan pengiriman berikutnya mencatat kegagalan.
Bagaimana cara mengirim melalui HTTP API Bird?
Anda mengirim pesan, menyimpan identifier-nya, dan memproses event pengiriman yang mengikuti.
Gunakan POST /v1/sms/messages dengan to, from, text, dan category untuk pengiriman teks bebas. Atur category ke salah satu dari marketing, transactional, authentication, atau service. Panduan pengiriman mendokumentasikan field yang didukung.
Respons 202 mengonfirmasi penerimaan. Respons ini tidak mengonfirmasi pengiriman ke ponsel. Lacak id yang dikembalikan melalui event SMS agar hasil akhir memperbarui permintaan yang benar.
Jalur mana yang cocok untuk aplikasi saya?
Pilih antarmuka yang dapat dioperasikan aplikasi Anda dengan andal, lalu verifikasi kemampuan pengiriman secara terpisah.
- Gunakan HTTP untuk integrasi baru yang tidak memiliki persyaratan SMPP tertentu.
- Gunakan SMPP jika sistem yang sudah ada atau perilaku koneksi yang diperlukan membenarkan pengelolaan sesinya.
- Uji tujuan, pengirim, dan event pengiriman sebelum mengalirkan lalu lintas ke salah satu jalur.
Singkatnya
API dan gateway menjalankan tugas yang berbeda.
API menerima permintaan Anda, sedangkan gateway menyediakan jalur menuju jaringan seluler.
HTTP menghindari pengelolaan sesi SMPP.
SMPP memerlukan pemulihan koneksi dan penanganan sesi selain alur kerja pesan Anda.
Penerimaan dan pengiriman tetap terpisah.
Permintaan kirim yang berhasil tidak membuktikan bahwa penerima sudah menerima pesan.
Bandingkan jalur pengiriman beserta antarmukanya.
Periksa dukungan tujuan, persyaratan pengirim, throughput, dan pelaporan kegagalan sebelum memilih integrasi.