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. Long code AS memerlukan merek dan kampanye terdaftar sebelum dapat membawa traffic 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.
Periksa capabilities nomor tertentu sebelum mengandalkan SMS atau voice. Jenis pengirim dan registrasi keluar tidak menjamin bahwa nomor tersebut dapat menerima balasan. Jenis nomor menjelaskan bagaimana kemampuan bervariasi menurut negara dan operator.
Pengirim juga melaporkan source_kind, yang menunjukkan apa yang mendukungnya: alpha untuk string pengirim yang Anda klaim, number untuk nomor khusus yang Anda miliki, dan shared_number untuk nomor yang dikelola Bird yang digunakan workspace Anda untuk mengirim. Dasbor melabeli ini sebagai Alphanumeric, Dedicated number, dan Shared number. Beli dan lepas 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:
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:
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_modebernilainone,optional, ataurequired.nonetidak memerlukan registrasi negara. Jika dipasangkan dengan sender IDoverwritten, registrasi tidak tersedia. Registrasi eksplisit yang lebih lama masih dapat dicatat untuk kebijakannonedengan perilakuunknownataupreserved, tetapi tidak pernah menghalangi pengiriman.optionalmemungkinkan sender tetap mengirim selama Anda mendaftarkannya.requiredmemblokir pengiriman sampai disetujui.programmengidentifikasi alur registrasi ketika negara menamakannya, sepertialphaataunumeric. Nilainya bisanulljika tidak ada program bernama yang berlaku.sender_id_behaviorbernilaiunknown,preserved, atauoverwritten. Field ini independen dariregistration_mode: registrasi yang diwajibkan tetap dapat membuat sender ID ditimpa setelah disetujui. Registrasi opsional melaporkanoverwrittensebelum persetujuan danpreservedsetelah persetujuan untuk kategori pesan yang disetujui.statusmenunjukkan posisi sender dalam program registrasi negara tersebut. Untuk moderequired, pengiriman menungguapproved. Untuk modeoptional, status melacak proses registrasi tetapi tidak memblokir pengiriman. Status registrasi mencantumkan setiap nilainya.destination_enabledmenunjukkan 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.nextmencantumkan 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:
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 bergantung pada negara. Jika negara meninjau pendaftaran, catatan dikembalikan dengan status pending dan belum ada biaya yang dikenakan. Jika negara tidak meninjau apa pun, pendaftaran langsung disetujui pada panggilan ini. Sender berbayar, baik alfanumerik maupun nomor, memiliki biaya setup dan biaya bulanan berulang. Pendaftaran yang ditinjau dibuat tanpa tagihan: biaya setup-nya ditagihkan saat dokumennya diajukan, atau saat disetujui jika tidak memerlukan dokumen, dan biaya berulang dimulai saat persetujuan. 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 dari panggilan ini, yang hanya terjadi pada persetujuan langsung atau pengaktifan kembali. Isi ulang, lalu coba lagi. Untuk pendaftaran yang ditinjau, 402 muncul dari pengajuan dokumen, yang hanya menagih biaya setup tetapi memerlukan saldo untuk biaya setup tersebut sekaligus biaya bulanan pertama. |
409 | Pendaftaran 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 pendaftaran 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 10DLC AS, verifikasi toll-free, atau short code. Lihat Program dengan jalur 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. Sampai Bird menyetujui formulir, Anda dapat membukanya lagi dari Complete dan mengubah jawaban apa pun; jawaban yang diubah akan ditinjau ulang. |
under_review | Semua yang diwajibkan negara tersebut sudah dikirimkan dan Bird sedang meninjaunya. Tidak ada tindakan yang diminta dari 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. Untuk verifikasi toll-free, operator juga dapat meminta perubahan dalam status ini: program_ref pada baris tersebut mengarah ke verifikasi, yang statusnya sendiri menampilkan info_requested saat menunggu tindakan Anda. |
approved | Registrasi disetujui. |
rejected | Registrasi ditolak. Baca rejection_reason, lalu pilih Resubmit. Jika Bird menutup formulir tetapi menerima detail yang sudah diperbaiki, Complete kemudian membukanya beserta jawaban Anda: perbaiki jawaban tersebut dan kirim ulang. Jika tidak, hubungi tim dukungan. |
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 milik sender sendiri mencakup apa yang dimiliki sender, dan ini pertanyaan yang berbeda dari apakah negara tertentu menerima pesan:
active: setidaknya satu tujuan aktif.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: belum ada tujuan yang aktif, baik karena sender belum mendaftar di negara yang mewajibkan pendaftaran, pendaftarannya sedang ditinjau, maupun pendaftarannya ditolak. Ikutinextke pembacaan persyaratan untuk melihat penyebabnya per negara. Long code baru dapat memiliki status ini dengan ketiga kelompok kosong.
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.
Negara yang mewajibkan pendaftaran 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 merek dan kampanye, lalu tautkan nomor: Registrasi 10DLC |
tfn | nomor toll-free AS | Verifikasi toll-free, dari baris AS di halaman detail sender pada SMS > Senders |
short_code | short code | Bird mengelola pengajuannya; tidak ada tindakan yang diminta dari Anda kecuali jika pengajuan ditolak, dan saat itu next pada baris tersebut mengarahkan Anda ke tim 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 Anda 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; verifikasi 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 milik Bird dapat membuat draf dan memperbaiki verifikasi, sedangkan 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.