Konfirmasi pesanan dapat menggunakan kembali kata-katanya sambil mengubah nomor pesanan untuk setiap penerima. Ini menjaga alur kerja tetap konsisten sementara datanya berubah.
Apa isi sebuah template?
Template berisi teks tetap, definisi variabel, dan kategori pesan, yang mengklasifikasikan alasan Anda mengirim pesan. Tujuan dapat menerapkan klasifikasi konten tersebut pada aturan registrasinya.
Setiap variabel menamai nilai yang berubah antar-pengiriman, misalnya nomor pesanan. Template mendefinisikan tipe yang diterima, apakah variabel itu wajib, dan batasan pada nilainya.
Konten dan template kampanye menggabungkan teks yang dapat digunakan kembali dengan nilai khusus penerima. Katalog template Bird mencakup template sistem untuk pesan autentikasi dan transaksional. Template workspace memungkinkan Anda mempublikasikan teks sendiri dalam beberapa bahasa. Pembuatannya tersedia melalui API pengelolaan template.
Baca variabelnya sebelum memilih template. Pratinjau yang tampak sesuai tidak menjamin bahwa nilai wajibnya cocok dengan data yang dimiliki aplikasi Anda.
Apakah template SMS perlu persetujuan?
Template bawaan siap dikirim. Publikasi template workspace memvalidasi teks dan variabelnya. Versi yang dipublikasikan langsung tersedia tanpa persetujuan Meta. Aturan tujuan masih dapat mewajibkan registrasi konten.
Ini adalah proses yang terpisah. Isi pesan yang dapat digunakan kembali dari penyedia tidak dengan sendirinya menjamin kepatuhan terhadap aturan tujuan.
Misalnya, panduan TRAI untuk pengirim mewajibkan registrasi template konten untuk komunikasi melalui identitas pengirim terdaftar di India. Persyaratan tersebut menyangkut struktur pesan, termasuk bagian tetap dan variabel.
Periksa tujuan sebelum memilih alur pengiriman. Registrasi pengirim menyangkut identitas pengirim dan dapat berdampingan dengan persyaratan konten.
Bagaimana Bird memilih kategori dan pengirim?
Template menyediakan kategori, yaitu klasifikasi konten berdasarkan alasan Anda mengirim pesan. Template bawaan memilih pengirim untuk tujuan; template workspace menggunakan pengirim yang Anda berikan.
Pengiriman berbasis template menolak text, category, dan media_urls bersama template. Hilangkan from untuk template bawaan dan berikan untuk template workspace. Kontrak pengiriman template mendokumentasikan persyaratan ini.
Gunakan template workspace atau teks bebas saat aplikasi harus memilih pengirim tertentu.
Periksa from dan category dalam respons. Field tersebut memberi tahu Anda pengirim dan klasifikasi konten mana yang dipilih Bird untuk pesan itu.
Bagaimana cara mengirim template di Bird?
Tentukan template yang sudah dipublikasikan dan berikan nilai variabelnya dalam objek template pada pengiriman.
Gunakan slug atau id untuk mengidentifikasinya. Ambil GET /v1/sms/templates/{template_ref} untuk mengetahui live_version_id, lalu ambil GET /v1/sms/templates/{template_ref}/versions/{version_id} untuk konten dan definisi variabelnya.
Masukkan nilai dalam parameters, dikunci berdasarkan nama variabel. Nilai wajib yang hilang, kunci yang tidak dideklarasikan, atau format yang tidak valid mengembalikan 422, jadi validasi nilainya sebelum melepas pengiriman.
Objek parameter yang diserialisasi harus muat dalam 16 KB. Bird menolak permintaan yang melebihi batas tersebut, jadi batasi isinya pada nilai yang dideklarasikan template.
Pilih language jika diperlukan. Pengaturan bahasa template menentukan default dan fallback-nya, jadi periksa pengaturan tersebut alih-alih berasumsi bahwa setiap bahasa yang diminta tersedia.
Apakah template mengubah cara penagihan SMS?
Teks yang dirender dihitung seperti isi SMS lainnya.
Masukkan nilai sebenarnya sebelum memperkirakan segmen. Referensi pesanan yang panjang atau nama di luar alfabet ringkas dapat menambah jumlahnya.
Referensi template bukan harga tetap untuk setiap penerima. segments.count dalam respons melaporkan bagian yang ditagihkan untuk pesan yang dirender tersebut.
Kapan sebaiknya memilih template?
Pilih template katalog jika isi, variabel, dan perilaku pemilihan pengirimnya sesuai dengan alur kerja Anda.
- Gunakan template jika isi yang disediakan sesuai dengan pesan dan Anda memiliki nilai wajibnya.
- Publikasikan template workspace untuk teks yang dapat digunakan kembali dengan pengirim Anda sendiri, atau gunakan teks bebas untuk satu pesan.
- Terapkan persyaratan registrasi tujuan pada pilihan mana pun.
Singkatnya
Template berisi teks yang dapat digunakan kembali dan definisi variabel.
Pilih template bawaan atau gunakan template workspace yang sudah dipublikasikan, lalu berikan nilai yang diwajibkan.
Pemilihan pengirim bergantung pada cakupan template.
Template bawaan menggunakan pengirim yang dipilih oleh Bird. Template workspace memerlukan pengirim milik Anda. Template menyediakan kategori.
Publikasi di workspace tidak memerlukan peninjauan Meta.
Mempublikasikan template workspace memvalidasi drafnya. Versi yang dipublikasikan langsung tersedia untuk pengiriman. Aturan registrasi konten di tujuan tetap terpisah.
Nilai yang disubstitusi tetap memengaruhi jumlah segmen.
Periksa pesan yang dirender karena nilai yang lebih panjang dapat menambah segmen yang ditagihkan.