Sebuah toko dapat memberi tahu banyak pelanggan tentang acara yang sama sambil mempersonalisasi setiap teks. Setiap penerima tetap memerlukan izin dan jalur pengiriman yang valid.
Apa yang berubah saat saya mengirim ke banyak penerima?
Anda mengoordinasikan banyak pengiriman independen, bukan memperlakukan satu permintaan sebagai keseluruhan kampanye.
Setiap penerima bisa memiliki tujuan, persyaratan pengirim, atau status persetujuan yang berbeda. Pengiriman berhasil ke satu orang tidak menunjukkan apa pun tentang ponsel orang lain.
Personalisasi juga mengubah teks yang sebenarnya. Nama yang lebih panjang atau emoji dapat mengubah encoding dan jumlah segmen. Hitung isi pesan yang sudah lengkap saat memperkirakan volume yang ditagihkan.
Haruskah saya menggunakan broadcast atau batch API?
Gunakan broadcast untuk mengoordinasikan kampanye berdasarkan audiens, konten bersama, dan jadwal pengiriman. Gunakan batch untuk mengirimkan pesan independen dari aplikasi Anda.
Alur kerja kampanye SMS menghubungkan persiapan audiens, personalisasi, peninjauan peluncuran, dan hasil penerima. Endpoint batch menyediakan operasi yang lebih sempit: menerima permintaan individual secara bersamaan.
Identifier batch tidak menggantikan kepemilikan kampanye, catatan persetujuan, atau jadwal.
Bagaimana Bird menerima batch?
Anda mengirimkan antara 1 dan 100 pesan independen melalui POST /v1/sms/batches.
Masukkan setiap objek pesan ke dalam array messages. Kampanye dengan 250 penerima memerlukan minimal tiga permintaan karena setiap batch menampung maksimal 100 item.
Bird memvalidasi setiap item sebelum mengantrekan apa pun. Satu pesan tidak valid membuat seluruh permintaan gagal dengan 422. Perbaiki item yang tidak valid sebelum mengirim ulang batch.
Jika berhasil, data berisi pesan yang diterima sesuai urutan pengiriman. summary.accepted_count melaporkan jumlah yang diterima. Referensi batch mendokumentasikan respons tersebut.
Simpan setiap identifier pesan yang dikembalikan bersama penerimanya. Event pengiriman selanjutnya terkait dengan pesan-pesan individual tersebut, bukan satu hasil batch bersama.
Apakah batch yang berhasil berarti semua orang menerima teksnya?
Respons 202 berarti Bird menerima pesan untuk diproses.
Penagihan, pengiriman ke operator, dan pengiriman terjadi setelahnya. Satu pesan yang diterima bisa gagal sementara yang lain sampai ke penerimanya. Perbarui kampanye dari event pengiriman setiap pesan.
Jangan mengirim ulang seluruh batch yang sudah diterima karena satu penerima gagal. Selidiki kesalahan pesan tersebut. Tentukan apakah percobaan terpisah diperlukan.
Bagaimana cara memperkirakan waktu pengiriman?
Perkirakan setiap tujuan secara terpisah menggunakan batas dan kapasitas yang berlaku untuk jalur pengirimannya.
Batas permintaan API mengontrol seberapa cepat Anda mengirimkan pekerjaan. Throughput pengiriman mengontrol tahap selanjutnya. Menaikkan konkurensi pengiriman tidak dapat menghilangkan batas operator.
Periksa satuan sebelum menghitung kapasitas. Batas berbasis segmen menghitung teks multipart lebih dari sekali. Batas berbasis permintaan menghitung panggilan batch saja.
Bird menetapkan permintaan batch ke sms_batch, terpisah dari pengiriman tunggal di bawah sms_send. Panduan pembatasan laju permintaan menjelaskan kebijakan permintaan tersebut. Throughput SMS menjelaskan pertanyaan pengiriman yang terpisah.
Apa yang harus saya periksa sebelum merilis kampanye?
Periksa persetujuan, kelayakan pengirim, dan pesan yang sudah lengkap untuk setiap penerima.
Gunakan status opt-out terbaru saat merilis pekerjaan yang diantrekan. Daftar yang diekspor sebelumnya bisa mencakup seseorang yang sudah mencabut izinnya.
Periksa persyaratan pengirim tujuan sebelum memasukkan penerimanya ke batch. Satu item tidak valid bisa menolak batch yang berisi banyak pesan valid.
Mulai dengan grup terbatas. Periksa hasil yang dikembalikan sebelum memperluas pengiriman. Hal ini membuat kesalahan pengirim atau pesan lebih mudah ditangkap sebelum mencapai seluruh daftar.
- Terapkan aturan tujuan dan izin setiap penerima.
- Validasi isi pesan yang sudah lengkap.
- Hitung segmennya.
- Kirim batch sesuai batas permintaan.
- Lacak hasil pengiriman per pesan. Selidiki setiap kegagalan secara terpisah.
Singkatnya
Setiap penerima tetap memiliki pesan independen.
Penerimaan batch tidak membuat semua penerima berbagi satu hasil pengiriman.
Satu batch Bird berisi maksimal 100 pesan.
Gunakan batch untuk pengiriman API independen. Broadcast audiens menangani alur kerja kampanye terkoordinasi.
Validasi berlaku untuk seluruh batch.
Satu item tidak valid menyebabkan Bird menolak permintaan sebelum item mana pun diantrekan.
Persetujuan dan kelayakan pengirim tetap diperiksa secara individual.
Periksa ulang izin dan persyaratan tujuan saat merilis setiap bagian kampanye.