# 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**](https://bird.com/dashboard/w/sms/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](/docs/guides/sms/sending-sms#sender). ## 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](/docs/guides/sms/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](/docs/guides/numbers/number-types) membahas cara jenis nomor dipilih, dan [Membeli dan melepas nomor](/docs/guides/numbers/buying-numbers) membahas cara mengalokasikannya. Jenis sender yang diterima suatu negara, dan apakah negara tersebut meninjaunya, berubah seiring operator dan regulator merevisi aturan mereka. [Tujuan SMS](/products/sms/destinations) 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**](https://bird.com/dashboard/w/sms/senders), buka **Add sender** dan pilih **Add sender ID**, lalu masukkan string-nya. Melalui API: ```cli bird sms senders create --type alpha --sender BIRD ``` Respons 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**](https://bird.com/dashboard/w/trust), 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: ```cli bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL ``` Hilangkan `--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](#status-pendaftaran) 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**](https://bird.com/dashboard/w/sms/destinations); [Mengirim SMS](/docs/guides/sms/sending-sms#before-you-send-enable-the-destination-country) 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: ```cli 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**](https://bird.com/dashboard/w/trust), 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](#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. | | `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](/docs/guides/numbers/overview#the-status-of-an-allocated-number) 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**](https://bird.com/dashboard/w/sms/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](#periksa-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](#daftarkan-sender-untuk-suatu-negara), ditambah formulir yang diminta negara tersebut | | `numeric` | long code | [Daftarkan sender untuk suatu negara](#daftarkan-sender-untuk-suatu-negara), ditambah formulir yang diminta negara tersebut | | `10dlc` | long code AS | Daftarkan brand dan campaign, lalu tautkan nomor: [Registrasi 10DLC](/docs/guides/sms/10dlc) | | `tfn` | nomor toll-free AS | Verifikasi toll-free, di halaman [**Toll-free verifications**](https://bird.com/dashboard/w/sms/tfn-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](/products/sms/numbers), atau tinjau [pendaftaran sender](/products/sms/compliance/sender-id-registration) untuk peluncuran Anda. | Halaman | Yang dibahas | | ---------------------------------------------------------------- | ----------------------------------------------------------------------------- | | [Mengirim SMS](/docs/guides/sms/sending-sms) | Panggilan pengiriman, format `from` yang diterima, dan allowlist tujuan | | [Registrasi 10DLC](/docs/guides/sms/10dlc) | Model merek, kampanye, dan nomor di balik pengiriman A2P AS | | [Jenis nomor](/docs/guides/numbers/number-types) | Memilih antara nomor mobile, lokal, nasional, toll-free, dan short code | | [Tujuan SMS](/products/sms/destinations) | Jenis sender yang diterima setiap negara dan mana yang memerlukan pendaftaran | | [Opt-out dan kata kunci](/docs/guides/sms/opt-outs-and-keywords) | Balasan kata kunci yang harus dihormati sender dan supresi yang dibuatnya | ## Related resources - [Registering your SMS sender ID](/learn/sms/registering-your-sms-sender-id) (video) - [What is sender ID registration, and why do some countries require it?](/explained/sms/what-is-sender-id-registration) (answer) - [SMS sender IDs](/sms-api/features/compliance/sender-id-registration) (product) - [Build your first integration](/learn/paths/integration) (course) [Get an implementation brief](/learn/workspace?topic=sms-senders)