Ringkasan SMS
Bird SMS mengirim pesan teks melalui platform dan kunci API yang sama dengan Bird Email. Panggil Bird dengan kunci bk_{region}_… ke host regional Anda (https://us1.platform.bird.com atau https://eu1.platform.bird.com). Bird memilih rute ke operator penerima, membagi teks Anda menjadi segmen yang dapat ditagih, dan melaporkan setiap pesan melalui tanda terima pengirimannya. Endpoint SMS dimulai dengan /v1/sms/.
Anda dapat mengirim teks bebas dengan pengirim dan kategori pilihan Anda, atau menggunakan salah satu template bawaan Bird, yang menyediakan isi pesan, kategori, dan pengirim. Bird juga menerima balasan ke nomor Anda. Setiap pesan masuk disimpan bersama pesan terkirim Anda dan menghasilkan sms.received. Ketika balasan cocok dengan kata kunci opt-out yang didukung seperti STOP, Bird juga mencatat supresi pengirim-dan-pelanggan. Lihat Opt-out dan kata kunci untuk cakupan dan konfigurasi.
Cara kerja pengiriman
Kirim SMS dengan POST /v1/sms/messages: satu penerima dan satu pesan, berisi text Anda sendiri dengan pengirim dan kategori, atau referensi template beserta nilai variabelnya. Bird memvalidasi permintaan dan tujuan, menentukan pengirim, dan mengembalikan 202 Accepted dengan ID pesan. Pengiriman kemudian terjadi secara asinkron. Pantau hasilnya melalui event dan webhook atau endpoint pembacaan pesan. Untuk mengirim banyak pesan independen dalam satu panggilan, gunakan endpoint batch.
Tiga konsep membentuk keseluruhan API:
- Mengirim pesan dan sampainya pesan ke penerima adalah dua tahap berbeda. 202 berarti Bird menerima pesan. Operator memproses pesan setelah penerimaan dan dapat mengembalikan tanda terima pengiriman kemudian. Tanda terima gagal juga merupakan hasil akhir; periksa status yang dilaporkan sebelum menganggap pengiriman berhasil.
- Teks ditagih per segmen. Pesan yang lebih panjang dari satu segmen dipecah dan ditagih per segmen, dan kapasitas per segmen bergantung pada karakter yang Anda gunakan. Batas karakter berisi aturan encoding, set karakter lengkap, dan cara menjaga pesan tetap satu segmen.
- Tujuan pengiriman Anda penting. Setiap pesan membawa kategori: transactional, marketing, authentication, atau service. Bird dan operator menggunakannya untuk memahami tujuan pesan. Pada pengiriman template, kategori berasal dari template.
Sebelum pengiriman pertama, aktifkan negara tujuan yang Anda layani di SMS > Destinations. Allowlist default-deny dimulai dengan hanya negara asal organisasi Anda yang diaktifkan. Bird menolak pengiriman ke negara lain. Mengirim SMS membahas prasyarat ini.
Untuk kode verifikasi sekali pakai, pertimbangkan Bird Verify alih-alih menyusun pesan sendiri. Verify menghasilkan dan mengirimkan kode melalui SMS atau email, memeriksa jawaban, serta menerapkan kedaluwarsa, batas percobaan, dan jeda pengiriman ulang.
Aplikasi SMS di dashboard
Di dashboard, SMS adalah salah satu produk di sidebar. Halaman-halamannya, dan lokasi panduan masing-masing:
| Halaman | Kegunaan |
|---|---|
| Messages | Setiap pesan terkirim, dengan linimasa event per pesan dan detail pengiriman. Panduan: Log SMS |
| Templates | Template bawaan yang dapat Anda kirim: nama, kategori, bahasa, dan variabel. Panduan: Template SMS |
| Metrics | Tingkat pengiriman, tingkat kegagalan, dan volume yang diterima dari waktu ke waktu. Panduan: Metrik SMS |
| Senders | Sender ID dan nomor yang dapat Anda gunakan untuk mengirim, serta tempat masing-masing terdaftar. Panduan: Sender ID SMS |
| Destinations | Negara yang dapat dituju workspace Anda; aktifkan tujuan sebelum mengirim ke sana. Panduan: Mengirim SMS |
Visibilitas
Gunakan catatan pesan dan linimasa event yang tersedia untuk menyelidiki penerimaan, penyerahan ke operator, dan hasil pengiriman. Detail pesan mencakup segmen dan komponen biaya yang telah ditentukan harganya. Pembacaan pesan publik mencakup jendela retensi yang dijelaskan di log SMS.
- Log SMS: tampilan per pesan di dashboard. Setiap pengiriman, linimasa event, segmen, biaya, dan detail operator.
- Metrik SMS: tingkat pengiriman agregat, tingkat kegagalan, volume yang diterima, dan latensi pengiriman di seluruh pesan yang Anda kirim.
- Events: kosakata event SMS, siklus hidup pesan, dan pengiriman webhook ke endpoint Anda.
Langkah selanjutnya
Jelajahi platform SMS untuk kampanye, pesan aplikasi, dan balasan, atau gunakan pustaka sumber daya SMS untuk memilih alur kerja.
| Halaman | Cakupan |
|---|---|
| Mengirim SMS | API pengiriman: tujuan, pengirim, isi, segmen, kategori, tag |
| Batas karakter | Encoding GSM-7 dan UCS-2, batas per segmen, dan batas maksimum 12 segmen |
| Template SMS | Katalog template bawaan dan pengiriman berdasarkan referensi template |
| Sender ID SMS | Memilih jenis pengirim dan mendaftarkannya per negara tujuan |
| Registrasi 10DLC | Mendaftarkan merek, kampanye, dan nomor untuk pengiriman A2P di AS |
| Log SMS | Setiap pesan, linimasa event, segmen, dan biaya |
| Metrik SMS | Tingkat pengiriman, tingkat kegagalan, dan latensi |
| Events | Jenis event SMS dan pengiriman webhook |
| Webhook & event | Pengaturan endpoint, verifikasi tanda tangan, percobaan ulang, dan pemutaran ulang |
| Ringkasan Verify | Kode verifikasi sekali pakai melalui SMS dan email, dikirim dan diperiksa oleh Bird |
| Kontrol ke mana akun Anda dapat mengirim | Video: Menunjukkan hasil pengiriman ke tujuan yang dinonaktifkan |
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.
Tonton panduannyaSMS pumping explainedPahami konsepnyaWhat is SMS pumping, and how do I stop it?Jelajahi kemampuannyaSMS destinationsIkuti jalur pembelajaranBuild your first integration
Dapatkan ringkasan implementasi