FAQ SMS API

Instal SDK dan kirim ke penerima uji coba resmi +15005550006 dalam sekitar lima menit. Anda bisa menjalankan CI check sebelum menyediakan nomor.

Satu endpoint pengiriman, inbound two-way, penyediaan nomor (long code, short code, toll-free, dan alphanumeric sender ID), kepatuhan A2P 10DLC dan opt-out, routing langsung ke operator, dan analitik pengiriman, semuanya dalam satu API.

Bird menjangkau 150+ negara melalui 240+ koneksi langsung ke operator, dengan pemilihan ulang rute tingkat operator ketika jalur operator menurun.

Untuk mengirim lalu lintas application-to-person ke nomor AS, ya. Registrasi brand dan kampanye ditangani di dashboard, dan statusnya bisa diquery dari API.

Per pesan, dengan tarif yang bergantung pada negara tujuan dan jenis pengirim yang Anda gunakan, jadi long code AS dan alphanumeric sender Inggris dihitung terpisah. Tarif dipublikasikan per negara di halaman harga SMS.

Ya, penagihan dihitung per segmen, bukan per pesan. Satu segmen menampung 160 karakter GSM-7, atau 70 karakter jika satu emoji atau karakter non-Latin memaksa seluruh pesan menggunakan Unicode. Teks yang lebih panjang dipecah dan setiap segmen ditagih, sehingga satu karakter yang tidak tepat bisa menggandakan biaya kampanye besar.

Biaya operator berlaku per pesan dan bervariasi menurut tujuan dan operator. Di AS, 10DLC juga dikenakan biaya pendaftaran brand dan kampanye. Keduanya tercantum di halaman biaya operator SMS.

Log SMS menampilkan jumlah segmen dan biaya pada setiap pesan individual setelah dihitung harganya; metrik SMS mengagregasi volume yang diterima, segmen, dan pengeluaran dari waktu ke waktu.

Pesan GSM-7 memuat 160 karakter per segmen; beralih ke Unicode (UCS-2) untuk emoji atau aksara non-Latin menguranginya menjadi 70. Pesan yang lebih panjang digabungkan lintas segmen, dan SDK melaporkan jumlahnya sebelum Anda mengirim.

Dua belas segmen, yaitu sekitar 1.836 karakter GSM-7 atau 804 karakter Unicode. Bird tidak pernah memotong: isi pesan yang melebihi batas akan dikembalikan sebagai 422. Batas dihitung berdasarkan segmen, bukan karakter, karena kedua encoding menampung jumlah yang berbeda.

Hingga 100 dalam satu batch call, masing-masing dengan penerima dan teks sendiri. Satu pesan dikirim ke tepat satu penerima, jadi batch adalah cara Anda melakukan fan out.

Key tier gratis mendapat 10 pengiriman tunggal dan 5 batch call per menit, dan paket berbayar menaikkan keduanya. Setiap respons membawa header IETF RateLimit yang memberi tahu sisa kuota dan kapan window direset, jadi sesuaikan dengan itu alih-alih angka hard-coded.

Itu ditentukan oleh operator, bukan oleh Bird. Long code 10DLC terdaftar mendapat throughput berdasarkan trust score brand dan jenis kampanye: lebih tinggi dari nomor tidak terdaftar, lebih rendah dari short code. Short code mendapat rate tertinggi dan paling stabil.

Untuk lalu lintas aplikasi AS, long code 10DLC mencakup sebagian besar kasus penggunaan dua arah dan OTP. Program satu-ke-banyak bervolume tinggi beralih ke short code; toll-free adalah opsi untuk AS/Kanada tanpa 10DLC.

Long code atau nomor toll-free tersedia langsung dan mulai mengirim setelah pendaftaran atau verifikasinya selesai. Short code diverifikasi oleh operator dan biasanya memerlukan waktu berminggu-minggu.

Ya. Long code, short code, dan nomor toll-free bersifat dua arah: arahkan lalu lintas masuk nomor ke webhook dan balasan akan tiba sebagai event bertanda tangan. Alphanumeric sender ID hanya satu arah.

Tergantung jenis pengirim dan negaranya. Lalu lintas aplikasi AS memerlukan A2P 10DLC, toll-free memerlukan verifikasi, dan banyak negara mewajibkan pra-pendaftaran sender ID — semuanya ditangani dari dashboard.

Ini adalah string teks pendek, biasanya nama merek Anda, yang muncul di kolom "dari" penerima sebagai pengganti nomor telepon. Ini adalah label pada pesan, bukan nomor yang Anda miliki.

Buat singkat: biasanya hingga 11 karakter pada jaringan GSM. Batas pastinya tergantung pada negara tujuan dan operator, serta apa yang diterima masing-masing.

Nomor toll-free adalah nomor 8xx (800, 888, 877, dan prefiks toll-free lainnya) yang mengirim dan menerima SMS di seluruh AS dan Kanada. Nomor ini membawa lalu lintas aplikasi tanpa A2P 10DLC, setelah melewati verifikasi toll-free.

Tidak. Nomor toll-free berada di luar sistem A2P 10DLC. Sebagai gantinya, nomor ini melalui verifikasi toll-free, di mana operator meninjau kasus penggunaan dan konten pesan sebelum nomor diizinkan mengirim dengan volume penuh.

Long code 10 digit (10DLC) adalah nomor telepon lokal standar yang diizinkan untuk SMS application-to-person di AS setelah brand dan kampanyenya didaftarkan ke operator.

Long code 10DLC terdaftar mendapat throughput terverifikasi yang bergantung pada trust score brand dan jenis kampanye: lebih tinggi dari nomor tidak terdaftar, lebih rendah dari short code.

Short code adalah nomor 5–6 digit yang disetujui operator untuk SMS volume tinggi satu-ke-banyak: kampanye pemasaran, notifikasi, dan OTP dengan volume tinggi. Ini adalah jenis sender dengan throughput tertinggi, dan melalui proses pemeriksaan operator sebelum bisa mengirim.

Hitunglah dalam minggu, bukan menit. Operator memeriksa setiap program short code sebelum aktif, jadi short code memiliki waktu tunggu yang nyata, tidak seperti long code yang bisa dibeli dan langsung digunakan begitu pendaftaran selesai.

Short code dedicated hanya milik Anda, sehingga reputasi pengirimannya sepenuhnya milik Anda. Short code shared membagi satu nomor ke beberapa pengirim melalui keyword: lebih murah, lebih cepat untuk memulai, tetapi Anda mewarisi reputasi semua pengirim lain di dalamnya.

Anda yang memilih, pada pengiriman free-text: masukkan nomor yang dimiliki workspace Anda, short code, atau sender ID alfanumerik jika negara tujuan mengizinkannya. Jika tidak diisi, pengiriman akan ditolak alih-alih ditebak. Pengiriman template adalah pengecualian, karena template memilih sender-nya sendiri.

Kategori memberi tahu Bird dan operator mengapa Anda mengirim, dan aturan kepatuhan per negara seperti kebijakan opt-out dan jam tenang bergantung padanya. Kategori wajib pada pengiriman free-text; pengiriman template mewarisi klasifikasi template itu sendiri.

Masukkan idempotency key dan permintaan ulang akan mengembalikan hasil asli alih-alih mengirim dua kali. Tanpa idempotency key, pengulangan diperlakukan sebagai pesan baru.

Setiap perubahan status memicu webhook bertanda tangan HMAC (queued, sent, delivered, atau failed), yang membawa tanda terima pengiriman dari operator dan jumlah segmen.

Setiap pesan yang dikirim ke nomor Anda yang telah disediakan masuk sebagai webhook sms.received bertanda tangan HMAC. Anda memverifikasi satu tanda tangan, membaca from, to, dan text, lalu meneruskannya ke logika Anda sendiri — envelope yang sama yang sudah Anda tangani untuk tanda terima pengiriman.

Ya. Balas dengan mengirim dari nomor yang sama tempat pesan masuk. Atur from ke nomor Anda dan to ke pengirim asli, dan thread tetap pada satu nomor dari ujung ke ujung.

Bird adds the sender to your suppression list and fires sms_suppression.created, and blocks later sends from that sender to that number automatically. HELP returns a help reply and START opts them back in, all handled before they reach your code, so you stay compliant without writing the keyword logic yourself.

Anda memerlukan nomor yang mendukung komunikasi dua arah. Long code, short code, dan nomor bebas pulsa mendukung pesan masuk; sender ID alfanumerik hanya bisa mengirim dan tidak bisa menerima balasan.

Pesan Anda diteruskan langsung ke operator seluler melalui salah satu dari 240 koneksi langsung kami, bukan melalui rantai reseller. Lebih sedikit lompatan berarti lebih sedikit titik di mana pesan bisa macet atau tanda terima pengiriman hilang.

Bird memilih ulang rute secara real time. Jika suatu jalur mulai kehilangan tanda terima atau melambat, pesan berikutnya mengambil koneksi yang lebih sehat ke operator yang sama, dan pengiriman yang Anda tulis tidak perlu diubah.

Setiap pesan mengembalikan tanda terima pengiriman dari operator sebagai webhook sms.delivered atau sms.failed, yang memuat mcc_mnc, country, dan latency_ms. Itu adalah konfirmasi langsung dari operator, bukan inferensi dari pihak kami.

Ya. Kami menjalankan pencarian MNP pada setiap pengiriman untuk menentukan operator penerima saat ini, sehingga nomor yang di-porting diarahkan ke operator yang benar-benar memilikinya. Untuk layanan inteligensi nomor mandiri, lihat Lookup.

Routing menyeimbangkan biaya dan kualitas pengiriman per tujuan. Lalu lintas transaksional seperti kode sandi sekali pakai mengutamakan jalur kualitas tertinggi; lalu lintas massal bisa condong ke biaya terendah. Pemilihan dilakukan per pesan, di balik panggilan API yang sama.

Dari tanda terima pengiriman operator (DLR) untuk setiap pengiriman. Bird mencatat tanda terima terhadap pesan, lalu mengumpulkan tanda terima tersebut menjadi angka pengiriman, kegagalan, dan latensi. Jumlah terkirim adalah konfirmasi penerimaan dari operator, bukan tebakan Bird.

Yes, from its own endpoint. The stats API has one breakdown per dimension (carrier, country, originator, category, status, error code, tag) plus daily and hourly series, and each row carries the one dimension you asked for. Crossing two of them, such as a carrier inside a country, means two calls and joining the rows yourself. A failure rate that looks fine nationally often turns out to be one carrier rejecting one sender ID.

Keduanya bisa. Setiap status pengiriman sudah dikirim sebagai webhook, jadi Anda bisa membangun penyimpanan sendiri dari event stream. Stats API tersedia ketika Anda ingin Bird yang melakukan agregasi alih-alih mengelola counter sendiri.

Kirim message ID ke endpoint events dan Anda akan mendapatkan timeline lengkapnya: queued, sent, delivered atau failed, masing-masing dengan timestamp dan, jika gagal, kode alasan dari operator. Itulah laporan yang benar-benar Anda butuhkan ketika pelanggan mengatakan pesan tidak pernah sampai.

Ya. Opt-out bersifat reversibel. Penerima yang mengirim pesan START akan dihapus dari daftar supresi dan dapat menerima pesan kembali. Pilihan tetap ada di tangan penerima.

Daftar supresi adalah sumber daya API yang dapat di-query. Periksa nomor sebelum membangun audiens agar penerima yang sudah opt-out tidak masuk kembali ke pengiriman.

Tergantung ke mana dan apa yang Anda kirim. Lalu lintas aplikasi di AS memerlukan registrasi brand dan kampanye A2P 10DLC. Banyak negara mewajibkan pra-registrasi sender ID untuk pengirim alfanumerik. Penanganan opt-out berlaku di mana saja dan tidak memerlukan pengaturan.

Bird mengajukan setiap registrasi ke operator atau registri dan melaporkan statusnya melalui API. Kode Anda bisa melakukan polling status registrasi dan menunggu persetujuan alih-alih mengirim ke kampanye yang belum aktif.

Tidak. Kepatuhan menggunakan client dan key yang sama dengan pengiriman, nomor, dan two-way. Status registrasi dan daftar suppression adalah resource API bersama panggilan kirim, jadi satu integrasi mencakup pengiriman dan aturannya.

Untuk mencegah spoofing, banyak negara hanya mengirimkan sender ID alfanumerik yang telah didaftarkan sebelumnya ke operator lokal atau regulator. Jika aturan tersebut berlaku, sender bermerek yang tidak terdaftar akan ditolak atau ditulis ulang.

Bird yang melakukannya. Anda mengirimkan sender ID dan tujuan dari dashboard, Bird meneruskannya ke registri lokal, dan API melaporkan statusnya sehingga Anda tahu kapan sender sudah aktif.

Persetujuan melalui operator dan registri eksternal dan bervariasi menurut negara, biasanya beberapa hari hingga minggu. Pantau status pendaftaran melalui API dan tunggu hingga disetujui sebelum mengirim dari sender ID tersebut.

A2P 10DLC adalah kerangka kerja operator AS untuk SMS application-to-person yang dikirim melalui long code 10 digit standar. Bisnis mendaftarkan merek di balik lalu lintas dan kampanye yang menjelaskan pesan, dan operator memeriksa keduanya sebelum memberikan throughput.

Brand adalah entitas hukum yang mengirim lalu lintas. Campaign menjelaskan kasus penggunaan pesan tertentu di bawah brand tersebut. Satu brand dapat memiliki beberapa campaign, dan Anda mengaitkan nomor dengan campaign, bukan dengan brand.

Pemeriksaan brand dan campaign dilakukan melalui operator dan registri dan biasanya memakan waktu beberapa hari hingga minggu. Query status campaign melalui API agar kode Anda menunggu persetujuan sebelum mengirim.

Tidak. 10DLC adalah kerangka kerja AS. Negara lain memiliki aturannya sendiri, banyak yang mewajibkan pra-pendaftaran sender ID, dan penanganan keyword opt-out berlaku di mana pun Anda mengirim.

Panggilan Anda ke Bird dienkripsi melalui HTTPS, begitu juga webhook masuk yang kami kirimkan kepada Anda. Lompatan terakhir bukan wewenang kami untuk dienkripsi: SMS adalah protokol operator tanpa enkripsi ujung-ke-ujung, dan pesan dapat dibaca di perangkat maupun oleh operator. Itulah alasan untuk tidak menyertakan informasi rahasia di isi pesan dan lebih memilih WhatsApp atau email untuk hal-hal sensitif.

Setiap event ditandatangani dengan HMAC. Verifikasi tanda tangan dengan secret endpoint Anda sebelum memproses payload, dan rotasi secret tersebut dari dashboard kapan pun diperlukan.

Di region tempat organisasi Anda di-hosting, baik us1 maupun eu1. API key Anda membawanya di prefiks (bk_us1_…, bk_eu1_…), itulah cara SDK dan CLI memilih endpoint yang tepat tanpa Anda perlu mengonfigurasinya.

Hanya apa yang Anda batasi cakupannya. Sebuah key membawa daftar scope, masing-masing pada level read atau write, sehingga key yang mengirim SMS tidak bisa mengelola nomor Anda atau membaca channel lain. Tindakan control-plane seperti mengelola anggota dan menerbitkan key hanya tersedia di dashboard dan tidak bisa diakses oleh key mana pun.

Keduanya bisa. Sebuah key menerima allowlist rentang CIDR dan menolak permintaan dari tempat lain, dan merotasinya membuat key lama tetap berfungsi selama masa tenggang (24 jam secara default, atau nol untuk langsung memutusnya) sehingga pergantian tidak memerlukan downtime.

Ya. Audit log adalah catatan read-only di seluruh organisasi dari setiap tindakan manajemen, lengkap dengan aktor, workspace, waktu, dan hasilnya, serta dapat diekspor ke OCSF untuk SIEM Anda sendiri.

Sertifikasi dan dokumentasi keamanan tersedia di Trust Center di trust.bird.com. Perjanjian pemrosesan data, pernyataan privasi, dan kebijakan penggunaan yang dapat diterima dipublikasikan di bird.com/legal. Untuk kuesioner vendor, tim akun Bird Anda yang menanganinya.