FAQ

Pertanyaan dan jawaban tentang Bulk SMS API

39 jawaban tentang akun, pengiriman, harga, laporan pengiriman, dan API, diperiksa terhadap batasan dalam kode. Untuk endpoint dan field, Referensi API memiliki detailnya.

Layanan

Apa itu BulkSMSAPI?

API SMS massal untuk pengembang: kirim satu teks atau batch hingga 10.000 nomor per permintaan ke 227 negara melalui REST, lacak setiap pesan dengan webhook yang ditandatangani, dan bayar per pesan dari saldo prabayar. Konsol web mengirim kampanye dari daftar tempel atau CSV tanpa kode.

Siapa yang menggunakan API SMS massal?

Tim produk dan teknik yang mengirim teks dari sistem mereka sendiri: kode login dan pendaftaran, pembaruan pesanan dan pengiriman, pengingat janji, peringatan pembayaran, pemberitahuan layanan, dan kampanye pemasaran. Siapa pun yang dapat membuat permintaan HTTPS dapat menggunakannya.

Ke negara mana saya bisa mengirim?

227 negara dan wilayah, tercantum dengan harganya di halaman harga dan halaman negara. Satu permintaan dapat mencakup berbagai negara: setiap nomor diharga berdasarkan negara asalnya.

Apakah ada biaya bulanan atau kontrak?

Tidak. Anda membayar per segmen pesan dari saldo prabayar, dan tidak ada biaya bulanan, biaya setup, atau volume minimum. Saldo tidak memiliki tanggal kedaluwarsa.

Apakah ada uji coba gratis?

Akun dimulai dengan saldo nol dan top-up pertama membuka semuanya. Top-up pertama menambahkan bonus hingga 40%, sehingga pesan pertama lebih murah. Harga bersifat publik, dan endpoint estimasi serta konsol menampilkan biaya pasti sebelum dikirim.

Akun dan kunci API

Bagaimana cara membuat akun?

Buka Get API key. Browser Anda akan membuat kunci akun yang dimulai dengan acct_; salin atau simpan sebagai file teks, konfirmasi bahwa Anda telah menyimpannya, dan akun siap digunakan. Kunci akun adalah satu-satunya login: tidak ada email atau sandi yang perlu dikelola.

Apa yang terjadi jika saya kehilangan kunci akun?

Kami hanya menyimpan hash-nya, sehingga tidak ada yang bisa menampilkannya lagi, termasuk tim dukungan kami. Simpan di pengelola sandi. Selama Anda masih masuk, konsol tetap berfungsi, dan Anda dapat menghubungi dukungan darinya.

Bagaimana cara mendapatkan API key?

Di halaman API keys pada konsol, setelah top-up pertama dikreditkan. Beri nama key, buat, dan salin sekali saja: dimulai dengan bsa_live_. Satu akun dapat memiliki 10 key aktif, masing-masing dengan nama dan penghitung rate limit sendiri.

Bisakah saya menggunakan key berbeda untuk production dan staging?

Ya. Buat satu key per app atau environment dan beri nama. Setiap key menampilkan waktu terakhir digunakan, dan mencabut satu key tidak mempengaruhi key lainnya.

Berapa banyak akun yang bisa saya buat?

Maksimal 3 akun per alamat jaringan. Kebanyakan tim hanya membutuhkan satu akun dengan beberapa API key.

Mengirim pesan

Berapa banyak nomor yang bisa ditangani satu request?

POST /v1/batches menerima hingga 10.000 nomor per request, baik satu teks untuk semua atau teks personal per nomor. Konsol menerima 50.000 nomor per kampanye. Daftar lebih besar akan dibagi menjadi beberapa request.

Seberapa cepat pesan dikirim?

Antrian berjalan setiap dua detik dan mengirimkan hingga 1.200 pesan per menit per akun ke jaringan, sesuai urutan penerimaan. Satu pesan biasanya terkirim dalam beberapa detik setelah request.

Format apa yang harus digunakan untuk nomor telepon?

Format internasional E.164: tanda plus, kode panggilan, dan nomor nasional, contoh +14155550123. Spasi, tanda hubung, kurung, dan awalan 00 dibersihkan otomatis; duplikat dan nomor yang tidak terbaca akan disisihkan dan tidak dikenakan biaya.

Berapa panjang maksimal pesan?

Hingga 10 segmen: 1.530 karakter GSM-7 atau 670 Unicode. Satu segmen berisi 160 karakter GSM-7 atau 70 Unicode; teks lebih panjang dibagi menjadi bagian 153 atau 67 karakter dan disatukan kembali di ponsel.

Mengapa pesan saya menggunakan lebih banyak segmen dari yang diharapkan?

Satu karakter di luar alfabet GSM-7, seperti tanda kutip keriting, emoji, atau huruf seperti á atau ç, mengubah seluruh teks ke Unicode dengan 70 karakter per segmen. Editor konsol akan menandai karakter tersebut, dan POST /v1/estimates mengembalikan encoding sebelum dikirim.

Bisakah saya menjadwalkan pesan?

Ya. Tambahkan send_at pada request API, atau pilih waktu di konsol, mulai 2 menit hingga 45 hari ke depan. Batch terjadwal dapat dibatalkan sebelum mulai, dan biaya penuhnya dikembalikan ke saldo.

Bisakah setiap penerima mendapatkan teks berbeda?

Ya. Melalui API, kirim batch dengan messages, satu {to, text} per penerima. Di konsol, tempel atau unggah daftar dengan kolom tambahan dan gunakan merge fields {{1}} hingga {{9}} dalam teks.

Apakah baris opt-out ditambahkan ke pesan saya?

Atur teks opt-out sekali di Pengaturan, misalnya tautan atau alamat email, dan konsol akan menambahkannya ke teks kampanye saat kotak dicentang. Melalui API Anda mengontrol teks penuh, jadi tambahkan sendiri baris tersebut ke pesan pemasaran. Nomor dalam do-not-send list akan dilewati oleh konsol dan API, dan tidak dikenakan biaya.

Bisakah saya mengirim pesan uji terlebih dahulu?

Ya. Konsol memiliki fitur test send ke satu nomor sebelum kampanye, dan melalui API Anda bisa mengirim satu pesan ke nomor sendiri dengan POST /v1/messages.

Harga dan pembayaran

Berapa biaya satu SMS?

Tergantung pada negara nomor tersebut: setiap negara memiliki satu harga per segmen dalam dolar AS, mulai dari $0.00247 (Brasil). Halaman harga dan GET /v1/pricing mencantumkan setiap negara.

Bagaimana biaya batch dihitung?

Untuk setiap penerima: harga per segmen di negara tersebut dikalikan jumlah segmen teksnya. Jumlahnya dipotong dari saldo saat request diterima, dan jawaban menampilkannya di cost.

Berapa top-up minimum?

$40. Top-up bisa dalam jumlah berapa pun dari $40 hingga $5,000. Top-up pertama memberikan bonus hingga 40%, ditampilkan pada setiap jumlah sebelum Anda membayar.

Bagaimana cara membayar?

Di konsol, Billing membuka checkout yang di-host dalam jendela di atas halaman. Anda memilih jumlah dan membayar dengan cryptocurrency, dan halaman pembayaran menampilkan jumlah dan alamat yang tepat. Halaman pembayaran mencantumkan setiap langkah.

Apakah pesan yang gagal dikirim dikembalikan?

Ya. Ketika pesan gagal, harganya dikembalikan ke saldo secara otomatis dalam proses yang sama, sebagai entri pengembalian dana di buku besar. Batch terjadwal yang dibatalkan akan dikembalikan sepenuhnya.

Bisakah saya menarik saldo?

Saldo digunakan untuk membayar pesan dan tetap ada di akun Anda tanpa tanggal kedaluwarsa. Pengembalian dana untuk pesan yang gagal atau dibatalkan juga akan kembali ke saldo.

Apakah harga berubah?

Harga dapat berubah ketika biaya jaringan berubah. Daftar harga saat ini memiliki tanggal, API mengembalikan tanggal dengan setiap harga, dan pesan yang sudah diterima mempertahankan harga saat dikirim.

Pengiriman dan laporan

Bagaimana cara mengetahui pesan telah terkirim?

Setiap pesan berpindah dari antrian, dikirim, hingga terkirim atau gagal. Tambahkan URL webhook di konsol untuk mendapatkan event yang ditandatangani untuk setiap status akhir, atau baca GET /v1/messages/{id} dan GET /v1/batches/{id}.

Bagaimana webhook ditandatangani?

Dalam format Standard Webhooks: header webhook-id, webhook-timestamp dan webhook-signature, di mana tanda tangan adalah HMAC-SHA256 dari id, timestamp dan body mentah dengan rahasia whsec_ Anda. Dokumen memiliki kode verifikasi untuk Node.js, Python, PHP dan Go.

Bagaimana jika endpoint webhook saya down?

Setiap event mendapatkan 10 percobaan dalam sekitar 24 jam, dan setiap percobaan tercantum di konsol dengan status HTTP-nya. Anda juga bisa memeriksa endpoint pesan kapan saja.

Mengapa pesan bisa gagal?

Ponsel mungkin mati terlalu lama, nomor mungkin tidak aktif lagi, atau jaringan mungkin menolak pesan. Status gagal membawa kode error, dan harga dikembalikan.

Berapa lama catatan pesan disimpan?

Batch, pesan, dan buku besar saldo tetap ada di akun Anda dan di API. Log permintaan menyimpan 500 panggilan API terakhir dan log webhook menyimpan 500 pengiriman terakhir.

Untuk pengembang

Apakah ada SDK?

API menggunakan JSON biasa melalui HTTPS, jadi pustaka standar bahasa apa pun sudah cukup. Dokumen memiliki contoh lengkap dalam curl, Node.js, Python, PHP dan Go, dan spesifikasi OpenAPI di /openapi.json menghasilkan klien bertipe di sebagian besar bahasa.

Apa batas kecepatannya?

600 permintaan per menit per kunci API. Setiap jawaban memiliki header X-RateLimit-Limit, X-RateLimit-Remaining dan X-RateLimit-Reset, dan jawaban 429 memiliki Retry-After.

Bagaimana cara mencoba lagi dengan aman setelah timeout?

Kirim permintaan POST dengan header Idempotency-Key dan coba lagi dengan kunci yang sama. Selama 24 jam, kunci dan body yang sama akan mengembalikan jawaban pertama alih-alih mengirim lagi.

Bisakah saya memeriksa harga tanpa kunci API?

Ya. GET /v1/pricing dan GET /v1/pricing/{country} bersifat publik, jadi halaman checkout atau dashboard dapat menampilkan harga langsung.

Di mana saya bisa melihat apa yang dikirimkan oleh kode saya?

Konsol memiliki log permintaan yang mencatat metode, path, status, dan waktu dari 500 panggilan API terakhir Anda, di samping batch, pesan, dan log webhook.

Konsol

Bisakah saya mengirim tanpa menulis kode?

Ya. Di konsol, tempel nomor atau unggah file CSV hingga 50.000 baris, tulis teks dengan merge fields, periksa pratinjau untuk setiap penerima dan biaya per negara, lalu kirim sekarang atau pada waktu yang ditentukan.

Apa yang ditampilkan oleh konsol?

Saldo, batch terbaru dengan hitungan langsung, setiap batch dengan pesan dan statusnya, top-up dan ledger, kunci API, pengaturan dan pengiriman webhook, log permintaan, daftar harga, tiket dukungan, dan pengaturan.

Bagaimana cara menghubungi dukungan?

Dari halaman Dukungan di konsol. Pertanyaan pembayaran dapat diajukan sejak hari pertama; topik lainnya terbuka setelah top-up pertama dikreditkan.

Masih ada pertanyaan?

Akun yang masuk dapat membuka tiket dukungan dari konsol. Pertanyaan pembayaran dapat diajukan sejak hari pertama.

FAQ Bulk SMS API: Kunci, Pengiriman, Harga, Webhooks | BulkSMSAPI