Sender ID SMS
Sender adalah from yang dilihat penerima pada SMS Anda. Workspace Anda menyimpan satu sender per identitas yang dapat digunakan untuk mengirim, dan setiap negara tujuan menentukan jenis sender yang diterima serta apa yang harus didaftarkan terlebih dahulu. Memiliki sender tidak sama dengan diizinkan mengirim dari sender tersebut: keduanya adalah langkah terpisah, dan panduan ini membahas keduanya.
Sender tercantum di halaman Senders, satu baris per sender, beserta statusnya dan jumlah tujuan yang aktif, tertunda, atau memerlukan perhatian Anda. Panggilan pengiriman, termasuk cara nilai from divalidasi, ada di Mengirim SMS.
Jenis sender
sender_type sender adalah jenis identitas yang digunakannya, dan menentukan apa yang diminta setiap negara:
- Sender ID alfanumerik: string merek pendek seperti BIRD, 3 hingga 11 huruf ASCII, angka, spasi, tanda hubung, garis bawah, atau titik, dengan minimal satu huruf. Spasi, tanda hubung, garis bawah, dan titik tidak boleh menjadi karakter pertama atau terakhir. Penerima melihat nama Anda alih-alih nomor dan tidak dapat membalasnya. Banyak negara mengharuskan pendaftaran sebelum bisa digunakan, dan beberapa, termasuk Amerika Serikat, tidak menerimanya sama sekali. Anda mengklaim jenis ini sendiri.
- Long code: nomor biasa yang Anda miliki, yang dapat mengirim dan menerima. Long code AS memerlukan merek dan kampanye terdaftar sebelum membawa lalu lintas application-to-person; lihat Registrasi 10DLC.
- Nomor toll-free: nomor yang biayanya ditanggung pihak yang dipanggil, yang di Amerika Utara juga dapat digunakan untuk pesan. Mengirim dari nomor ini di sana berarti harus menyelesaikan verifikasi toll-free terlebih dahulu.
- Short code: nomor nasional pendek untuk program pesan yang disetujui, dengan panjang dan throughput ditentukan oleh pasar dan program operator. Bird mengalokasikan short code alih-alih menjualnya, sehingga jenis ini tidak bisa dilayani sendiri.
Sender juga melaporkan source_kind, yang menunjukkan apa yang mendukungnya: alpha untuk string sender yang Anda klaim, number untuk nomor dedikasi yang Anda miliki, dan shared_number untuk nomor yang dikelola Bird yang digunakan workspace Anda untuk mengirim. Dashboard melabelinya Alphanumeric, Dedicated number, dan Shared number. Jenis nomor membahas cara jenis nomor dipilih, dan Membeli dan melepas nomor membahas cara mengalokasikannya.
Jenis sender yang diterima suatu negara, dan apakah negara tersebut meninjaunya, berubah seiring operator dan regulator merevisi aturan mereka. Tujuan SMS menerbitkan posisi terkini per negara; baca di sana alih-alih berasumsi suatu negara berperilaku seperti tetangganya.
Klaim sender ID alfanumerik
Mengklaim string sender tidak dikenakan biaya dan langsung berlaku. Di halaman Senders, buka Add sender dan pilih Add sender ID, lalu masukkan string-nya. Melalui API:
Contoh kode
bird sms senders create --type alpha --sender BIRDRespons membawa id sender baru, dengan prefiks snd_, dan setiap operasi lain dalam panduan ini menggunakan id tersebut. Klaim yang berhasil dapat langsung mengirim ke negara yang tidak memerlukan registrasi atau menyediakan registrasi opsional, setelah tujuan tersebut diaktifkan. Registrasi yang diwajibkan harus disetujui terlebih dahulu.
Dua penolakan dapat muncul di sini. 412 berarti organisasi Anda belum menyelesaikan verifikasi identitas yang diperlukan operasi ini: selesaikan di Identity Center, lalu coba lagi. 409 berarti string sender sudah diklaim.
alpha adalah satu-satunya jenis yang dibuat panggilan ini. Nomor dedikasi menjadi sender saat Anda mengalokasikannya dari inventaris, sehingga membeli nomor otomatis membawa sender-nya. Short code dan nomor bersama masuk ke workspace melalui alokasi dari Bird, bukan melalui pembelian.
Periksa persyaratan suatu negara
Satu pembacaan menjawab apa yang diminta setiap negara dari sender. Hasilnya mengembalikan satu baris per negara yang dapat dijangkau sender, dan setiap baris lengkap dengan sendirinya:
Contoh kode
bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg
bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NLHilangkan --country-code untuk setiap negara yang relevan bagi sender. Hasil filter yang kosong berarti sender tidak memiliki rute ke negara tersebut.
Baca enam field pada satu baris sebelum Anda mengirim:
- registration_mode bernilai none, optional, atau required. none tidak memerlukan registrasi negara. Jika dipasangkan dengan sender ID overwritten, registrasi tidak tersedia. Registrasi eksplisit yang lebih lama masih dapat dicatat untuk kebijakan none dengan perilaku unknown atau preserved, tetapi tidak pernah menghalangi pengiriman. optional memungkinkan sender tetap mengirim selama Anda mendaftarkannya. required memblokir pengiriman sampai disetujui.
- program mengidentifikasi alur registrasi ketika negara menamakannya, seperti alpha atau numeric. Nilainya bisa null jika tidak ada program bernama yang berlaku.
- sender_id_behavior bernilai unknown, preserved, atau overwritten. Field ini independen dari registration_mode: registrasi yang diwajibkan tetap dapat membuat sender ID ditimpa setelah disetujui. Registrasi opsional melaporkan overwritten sebelum persetujuan dan preserved setelah persetujuan untuk kategori pesan yang disetujui.
- status menunjukkan posisi sender dalam program registrasi negara tersebut. Untuk mode required, pengiriman menunggu approved. Untuk mode optional, status melacak proses registrasi tetapi tidak memblokir pengiriman. Status registrasi mencantumkan setiap nilainya.
- destination_enabled menunjukkan apakah workspace Anda mengaktifkan negara tersebut. Ini adalah pengaturan workspace, bukan sesuatu tentang sender, dan diperiksa lebih dulu, sehingga registrasi yang sudah disetujui sepenuhnya tetap menolak pesan selama tujuan dinonaktifkan. Aktifkan negara di Destinations; Mengirim SMS membahas allowlist.
- next mencantumkan langkah yang memajukan negara tersebut, secara berurutan. Daftar kosong berarti tidak ada yang perlu ditindaklanjuti. Setiap entri menyebutkan satu tindakan dan alasan pentingnya, sehingga negara yang sedang ditinjau operator menyebutkan resource yang perlu dibaca alih-alih mengulang keputusan yang dimiliki resource tersebut.
Baris juga memuat timeline_min_days dan timeline_max_days, durasi terpendek dan terpanjang yang biasanya diperlukan persetujuan suatu negara dalam hari kerja, serta null jika negara tidak menerbitkan estimasi. Jika pendaftaran ditolak, rejection_reason menyatakan alasannya.
Informasi yang sama ada di halaman detail setiap sender di dashboard, berupa tabel Destinations dengan kolom Status, Country, dan Category. Negara yang belum Anda aktifkan dan belum Anda daftarkan tidak muncul di tabel itu, karena tidak ada hal yang perlu ditindaklanjuti di sana.
Daftarkan sender untuk suatu negara
Pendaftaran dilakukan per negara, dan panggilan ini menerima sender dan negara secara bersamaan:
Contoh kode
bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL
bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL --category marketing--category membatasi pendaftaran ke salah satu dari transactional, marketing, authentication, atau service. Hilangkan untuk mendaftar pada semua kategori. Dashboard menjalankan panggilan yang sama dari tombol Register pada baris negara sender.
Apa yang terjadi selanjutnya tergantung pada negara. Jika negara meninjau pendaftaran, catatan kembali dengan status pending dan belum ada biaya yang dikenakan. Jika negara tidak meninjau, pendaftaran langsung disetujui pada panggilan ini. Mendaftarkan nomor gratis; sender alfanumerik berbayar memiliki biaya setup dan biaya bulanan berulang, yang ditagihkan saat pendaftaran disetujui, sehingga pendaftaran yang ditinjau dibuat tanpa tagihan. Baik panggilan ini maupun pembacaan persyaratan tidak menampilkan harga, jadi tanyakan kepada pemilik akun berapa biaya pendaftaran sebelum Anda membuatnya.
Jika program mengumpulkan jawaban Anda dalam formulir, pendaftaran berada di pending sampai Anda mengisinya. Baris negara sender kemudian menampilkan Complete, yang membuka pertanyaan yang diminta program tentang bisnis dan pesan Anda.
Empat penolakan yang perlu ditangani:
| Respons | Artinya |
|---|---|
| 402 | Saldo wallet tidak cukup untuk menutupi tagihan saat penagihan berjalan. Isi ulang, lalu coba lagi. |
| 409 | Registrasi untuk negara ini sudah ada dalam status selain ditolak atau ditangguhkan, termasuk yang masih dalam peninjauan pending. Status saja tidak menentukan apakah sender dapat mengirim: periksa registration_mode, destination_enabled, dan apakah registrasi mencakup kategori pesan. |
| 412 | Organisasi Anda memiliki persyaratan verifikasi identitas yang belum dipenuhi. Selesaikan di Identity Center, lalu coba lagi. |
| 422 | Sender ini dicakup oleh program dengan jalurnya sendiri, seperti US 10DLC, verifikasi bebas pulsa, atau short code. Lihat Program dengan jalurnya sendiri. |
Pendaftaran yang ditolak dikirim ulang, dan yang ditangguhkan diaktifkan kembali, dengan memanggil operasi yang sama ini, bukan melalui operasi terpisah.
Status pendaftaran
Pendaftaran negara bergerak melalui status-status berikut. Dashboard menampilkan masing-masing sebagai label huruf besar di awal kalimat pada baris sender:
| Status | Artinya dan tindakan yang perlu dilakukan |
|---|---|
| registration_required | registration_mode negara tersebut adalah required dan belum ada registrasi yang dimulai. Daftarkan sender untuk negara tersebut. |
| pending | Proses registrasi sudah dimulai. Jika program meminta formulir, selesaikan dari Complete pada baris negara tersebut. |
| under_review | Informasi yang dikirimkan sedang ditinjau, atau memerlukan perubahan. program_ref pada baris tersebut mengarah ke resource milik program, satu-satunya tempat untuk membedakan peninjauan yang masih berjalan dari yang menunggu tindakan Anda. |
| bird_approved | Peninjauan Bird lolos dan persetujuan operator masih tertunda. Tidak ada tindakan yang diminta dari Anda. |
| carrier_pending | Diajukan ke operator atau registry yang menyetujui. Tidak ada tindakan yang diminta dari Anda. |
| approved | Registrasi disetujui. |
| rejected | Registrasi ditolak. Baca rejection_reason, perbaiki, lalu daftarkan kembali dari Resubmit. |
| suspended | Registrasi yang sebelumnya aktif ditangguhkan. Daftarkan kembali dari Register again untuk mengaktifkannya lagi. |
| not_required | Tidak ada registrasi aktif yang menghalangi pengiriman. Periksa registration_mode dan sender_id_behavior: none tidak memerlukan registrasi negara dan membuatnya tidak tersedia saat sender ID ditimpa; optional menawarkan registrasi tanpa memblokir lalu lintas. |
Status baru ditambahkan seiring perubahan program pendaftaran, jadi perlakukan nilai yang tidak dikenal sebagai nilai yang belum ditangani kode Anda, bukan sebagai kesalahan, dan baca next pada baris tersebut untuk mengetahui langkah selanjutnya terkait negara itu.
Beberapa program membuka beberapa negara dengan satu pendaftaran, sehingga satu verifikasi toll-free atau pendaftaran kampanye dapat menjadi syarat untuk beberapa tujuan sekaligus.
Status sender dan tindakan selanjutnya
status sender sendiri mencakup apa yang dimiliki sender, yang merupakan pertanyaan berbeda dari apakah negara tertentu akan menerima pesan:
- active: tidak ada hal yang dimiliki sender ini yang perlu ditindaklanjuti. Sender yang belum mendaftar di mana pun tetap bernilai active, meskipun setiap negara yang bisa dijangkaunya memerlukan pendaftaran.
- pending_number_ownership: dokumen yang membuktikan kepemilikan Anda atas nomor sender ini belum tersedia, baik karena belum diserahkan maupun karena negara yang menerbitkan nomor belum menerimanya. Setiap pengiriman dari sender ini ditolak sampai hal tersebut diselesaikan. Ikhtisar nomor membahas siklus tersebut.
- pending_registrations: sender memiliki pendaftaran negara dan belum ada yang disetujui. Ini mencakup pendaftaran yang sedang ditinjau dan yang ditolak, jadi baca next untuk mengetahui statusnya.
Di sampingnya, destinations mengelompokkan negara tempat sender terdaftar berdasarkan siapa yang harus bertindak selanjutnya, dan daftar Senders menampilkan tiga kelompok ini sebagai kolom:
- "Active": negara yang dapat Anda kirimi hari ini, yang diaktifkan di pengaturan tujuan Anda dan tidak mewajibkan registrasi atau sudah memiliki registrasi yang disetujui. Registrasi opsional masih bisa berstatus pending sementara pengiriman tetap tersedia dengan sender ID yang ditimpa.
- "Pending": negara-negara yang pendaftarannya sedang berlangsung dan menunggu Bird atau operator. Tidak ada tindakan yang diminta dari Anda; status ini berpindah ke "Active" setelah disetujui.
- "Needs attention": negara-negara yang sudah Anda daftarkan tetapi tidak berfungsi dan menunggu tindakan Anda, karena pendaftaran ditolak atau dicabut, atau karena pendaftaran disetujui sementara tujuan dimatikan.
Tiga kelompok ini hanya mencakup negara yang pendaftarannya Anda miliki, sehingga negara yang bisa Anda daftarkan tetapi belum Anda daftarkan tidak muncul di kelompok mana pun. Untuk semua negara yang dapat dijangkau sender dan apa yang diminta setiap negara, baca persyaratan suatu negara.
Pembacaan sender yang menghitung tindakan selanjutnya mengembalikannya di next, field routing yang sama dengan yang dibawa baris persyaratan. Sender hanya mengetahui dirinya sendiri, jadi jika pekerjaan spesifik per negara, sender menyebutkan pembacaan persyaratan alih-alih menebak negara mana yang Anda maksud.
Program dengan jalur sendiri
program suatu negara menyebutkan skema pendaftaran yang dijalankannya untuk jenis sender. Dua di antaranya dijawab oleh panggilan pendaftaran dalam panduan ini, dan tiga memiliki jalurnya sendiri:
| Program | Berlaku untuk | Tempat prosesnya berlangsung |
|---|---|---|
| alpha | sender ID alfanumerik | Daftarkan sender untuk suatu negara, ditambah formulir yang diminta negara tersebut |
| numeric | long code | Daftarkan sender untuk suatu negara, ditambah formulir yang diminta negara tersebut |
| 10dlc | long code AS | Daftarkan brand dan campaign, lalu tautkan nomor: Registrasi 10DLC |
| tfn | nomor toll-free AS | Verifikasi toll-free, di halaman Toll-free verifications |
| short_code | sebuah short code | Bird mengelola aplikasi; tidak ada yang diminta dari Anda kecuali jika ditolak, dan next pada baris tersebut mengarahkan Anda ke dukungan |
Memanggil operasi pendaftaran untuk sender yang dicakup oleh 10dlc, tfn, atau short_code menghasilkan 422. Gunakan program tersebut.
Verifikasi toll-free dimulai sebagai draf yang Anda isi melalui satu atau beberapa pembaruan, lalu kirimkan agar operator meninjaunya. Statusnya bergerak melalui draft, submitted, under_review, info_requested, approved, dan rejected. Verifikasi pada info_requested dapat diedit dan dikirim ulang; yang ditolak dapat dikirim ulang selama jendela pengiriman ulangnya masih terbuka. Pengiriman menyerahkan berkas ke operator untuk ditinjau, sehingga langkah ini diotorisasi oleh seseorang: CLI dan server MCP Bird dapat membuat draf dan memperbaiki verifikasi, dan pengiriman itu sendiri dilakukan di dashboard.
Berhenti mengirim dari sender
Tiga tindakan pembongkaran berbeda dalam hal apa yang dipertahankan, dan ketiganya adalah tindakan dashboard di halaman detail sender. Biaya setup yang sudah ditagihkan tidak dikembalikan oleh tindakan mana pun:
| Tindakan | Fungsinya |
|---|---|
| Deregister suatu negara | Membatalkan biaya berulang dan mempertahankan pendaftaran. Mendaftarkan negara itu kembali melanjutkan pendaftaran yang sama tanpa membayar biaya setup dua kali. Jika negara mewajibkan pendaftaran, pengiriman ke sana berhenti; jika pendaftaran opsional, pengiriman tetap berlanjut, karena pendaftaran tidak pernah menjadi syarat. |
| Remove pendaftaran | Menghapus pendaftaran negara sepenuhnya, membatalkan biaya berulang, dan menghentikan pencantuman tujuan untuk sender. Mendaftarkan negara itu kembali adalah pendaftaran baru dan membayar biaya setup lagi. |
| Hapus sender | Melepas sender alfanumerik. Semua pendaftaran negara pada sender dihapus, biaya berulangnya dibatalkan, dan sender tidak lagi dapat digunakan. Mengklaim string yang sama di kemudian hari membuat sender baru dengan pendaftaran baru, dan membayar biaya setup untuk kedua kalinya. |
Sender yang didukung nomor tidak dihapus di sini: lepas nomor dedikasi tersebut, yang otomatis membongkar sender-nya. Sender pada nomor bersama yang dikelola Bird tidak dapat dihapus.
Baris 10DLC atau toll-free dibatalkan melalui programnya sendiri, dengan melepaskan tautan kampanye atau membatalkan verifikasi, bukan dengan membatalkan pendaftaran.
Langkah selanjutnya
Bandingkan nomor dan sender ID SMS, atau tinjau pendaftaran sender untuk peluncuran Anda.
| Halaman | Yang dibahas |
|---|---|
| Mengirim SMS | Panggilan pengiriman, format from yang diterima, dan allowlist tujuan |
| Registrasi 10DLC | Model merek, kampanye, dan nomor di balik pengiriman A2P AS |
| Jenis nomor | Memilih antara nomor mobile, lokal, nasional, toll-free, dan short code |
| Tujuan SMS | Jenis sender yang diterima setiap negara dan mana yang memerlukan pendaftaran |
| Opt-out dan kata kunci | Balasan kata kunci yang harus dihormati sender dan supresi yang dibuatnya |
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.
Tonton panduannyaRegistering your SMS sender IDPahami konsepnyaWhat is sender ID registration, and why do some countries require it?Jelajahi kemampuannyaSMS sender IDsIkuti jalur pembelajaranBuild your first integration
Dapatkan ringkasan implementasi