FAQ

Soalan dan jawapan API SMS Bulk

39 jawapan tentang akaun, penghantaran, harga, laporan penghantaran dan API, disemak terhadap had dalam kod. Untuk endpoint dan medan, Rujukan API mempunyai perincian.

Perkhidmatan

Apa itu BulkSMSAPI?

API SMS bulk untuk pembangun: hantar satu teks atau batch sehingga 10,000 nombor setiap permintaan ke 227 negara melalui REST, ikuti setiap mesej dengan webhooks yang ditandatangani, dan bayar setiap mesej dari saldo prabayar. Konsol web menghantar kempen dari senarai yang ditampal atau CSV tanpa kod.

Siapa yang menggunakan API SMS bulk?

Pasukan produk dan kejuruteraan yang menghantar teks dari sistem mereka sendiri: kod log masuk dan pendaftaran, kemas kini pesanan dan penghantaran, peringatan janji temu, amaran pembayaran, notis perkhidmatan dan kempen pemasaran. Sesiapa yang boleh membuat permintaan HTTPS boleh menggunakannya.

Negara mana yang boleh saya hantar?

227 negara dan wilayah, disenaraikan dengan harga mereka pada halaman harga dan halaman negara. Satu permintaan boleh mencampurkan negara: setiap nombor diberi harga mengikut negara ia milik.

Adakah terdapat bayaran bulanan atau kontrak?

Tidak. Anda membayar setiap segmen mesej dari saldo prabayar, dan tiada bayaran bulanan, bayaran penyediaan atau jumlah minimum. Saldo tidak mempunyai tarikh luput.

Adakah terdapat percubaan percuma?

Akaun bermula dengan saldo sifar dan top-up pertama membuka segalanya. Top-up pertama menambah bonus sehingga 40%, jadi mesej pertama lebih murah. Harga adalah awam, dan endpoint anggaran serta konsol menunjukkan kos tepat sebelum apa-apa dihantar.

Akaun dan API key

Bagaimana saya membuat akaun?

Buka Dapatkan API key. Pelayar anda membuat kunci akaun yang bermula dengan acct_; salin atau simpan sebagai fail teks, sahkan bahawa anda telah menyimpannya, dan akaun sudah sedia. Kunci akaun adalah satu-satunya log masuk: tiada email atau kata laluan untuk diuruskan.

Apa yang berlaku jika saya kehilangan kunci akaun?

Kami hanya menyimpan hash berkunci daripadanya, jadi tiada siapa boleh menunjukkannya semula, termasuk pasukan sokongan kami. Simpan dalam pengurus kata laluan. Semasa anda masih log masuk, konsol terus berfungsi, dan anda boleh menghubungi sokongan daripadanya.

Bagaimana cara mendapatkan kunci API?

Di halaman kunci API pada konsol, setelah top-up pertama dikreditkan. Beri nama kunci, buat dan salin sekali, dimulai dengan bsa_live_. Satu akun boleh memiliki 10 kunci aktif, masing-masing dengan nama dan penghitung had kadar sendiri.

Bolehkah saya menggunakan kunci berbeza untuk produksi dan staging?

Ya. Buat satu kunci per app atau persekitaran dan beri nama. Setiap kunci menunjukkan bila terakhir digunakan, dan membatalkan satu tidak menjejaskan yang lain.

Berapa banyak akaun yang boleh saya buat?

Sehingga 3 akaun per alamat rangkaian. Kebanyakan pasukan hanya perlukan satu akaun dengan beberapa kunci API.

Menghantar mesej

Berapa banyak nombor yang boleh diambil oleh satu permintaan?

POST /v1/batches mengambil sehingga 10,000 nombor per permintaan, sama ada satu teks untuk semua atau teks peribadi per nombor. Konsol mengambil 50,000 nombor per kempen. Senarai lebih besar dibahagikan kepada beberapa permintaan.

Seberapa pantas mesej dihantar?

Antrian berjalan setiap dua saat dan menghantar sehingga 1,200 mesej per minit per akaun ke rangkaian, mengikut urutan diterima. Satu mesej biasanya keluar dalam beberapa saat selepas permintaan.

Format apa yang sepatutnya untuk nombor telefon?

E.164 antarabangsa: tanda tambah, kod panggilan dan nombor negara, contohnya +14155550123. Ruang, sengkang, kurungan dan awalan 00 dibersihkan secara automatik; duplikat dan nombor yang tidak boleh dibaca diketepikan dan tidak dikenakan bayaran.

Berapa lama mesej boleh dibuat?

Sehingga 10 segmen: 1,530 aksara dalam GSM-7 atau 670 dalam Unicode. Satu segmen memegang 160 aksara GSM-7 atau 70 aksara Unicode; teks lebih panjang dibahagikan kepada bahagian 153 atau 67 aksara dan disambung semula pada telefon.

Mengapa mesej saya menggunakan lebih banyak segmen daripada yang dijangkakan?

Satu aksara di luar abjad GSM-7, seperti tanda petik kerinting, emoji atau huruf seperti á atau ç, menukar keseluruhan teks ke Unicode pada 70 aksara per segmen. Penyusun konsol menamakan aksara tersebut, dan POST /v1/estimates mengembalikan pengekodan sebelum anda menghantar.

Bolehkah saya menjadualkan mesej?

Ya. Tambah send_at pada permintaan API, atau pilih masa dalam konsol, dari 2 minit hingga 45 hari ke hadapan. Kumpulan berjadual boleh dibatalkan sehingga ia bermula, dan kos penuhnya dikembalikan ke saldo.

Bolehkah setiap penerima mendapatkan teks yang berbeza?

Ya. Melalui API, hantar kumpulan dengan mesej, satu {to, text} per penerima. Dalam konsol, tampal atau muat naik senarai dengan lajur tambahan dan gunakan medan gabungan {{1}} hingga {{9}} dalam teks.

Adakah barisan opt-out ditambah pada mesej saya?

Tetapkan perkataan opt-out sekali dalam Tetapan, contohnya pautan atau alamat e-mel, dan konsol akan menambahkannya pada teks kempen apabila anda menandakan kotak. Melalui API anda mengawal teks penuh, jadi tambahkan baris itu sendiri pada mesej pemasaran. Nombor dalam senarai do-not-send dilangkau oleh konsol dan API, dan tidak dikenakan bayaran.

Bolehkah saya menghantar mesej ujian dahulu?

Ya. Konsol mempunyai penghantaran ujian ke satu nombor sebelum kempen, dan melalui API anda boleh menghantar satu mesej ke telefon sendiri dengan POST /v1/messages.

Harga dan pembayaran

Berapa kos satu SMS?

Ia bergantung pada negara nombor: setiap negara mempunyai satu harga per segmen dalam dolar AS, dari $0.00247 (Brazil). Halaman harga dan GET /v1/pricing menyenaraikan setiap negara.

Bagaimana kos kumpulan dikira?

Untuk setiap penerima: harga per segmen negaranya darab segmen teksnya. Jumlah diambil dari saldo apabila permintaan diterima, dan jawapan menunjukkan dalam kos.

Berapa minimum top-up?

$40. Top-up boleh dalam jumlah antara $40 hingga $5,000. Top-up pertama mendapat bonus sehingga 40%, ditunjukkan pada setiap jumlah sebelum bayaran.

Bagaimana cara bayar?

Dalam konsol, Billing membuka checkout dalam tetingkap. Pilih jumlah dan bayar dengan kripto, halaman bayaran tunjukkan jumlah dan alamat tepat. Halaman pembayaran senaraikan setiap langkah.

Adakah mesej gagal dikembalikan?

Ya. Apabila mesej gagal, harganya dikembalikan ke saldo secara automatik sebagai baris refund dalam lejar. Batch berjadual yang dibatalkan dikembalikan sepenuhnya.

Bolehkah saya keluarkan saldo?

Saldo digunakan untuk bayar mesej dan kekal dalam akaun tanpa tarikh luput. Bayaran balik untuk mesej gagal atau dibatalkan juga kembali ke saldo.

Adakah harga berubah?

Harga boleh berubah apabila kos rangkaian berubah. Senarai semasa bertarikh, API kembalikan tarikh dengan setiap harga, dan mesej yang telah diterima kekal dengan harga asal.

Penghantaran dan laporan

Bagaimana saya tahu mesej telah dihantar?

Setiap mesej bergerak dari beratur ke dihantar ke berjaya atau gagal. Tambah URL webhook dalam konsol untuk dapatkan peristiwa bertanda 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 tandatangan adalah HMAC-SHA256 bagi id, timestamp dan badan mentah dengan rahsia whsec_ anda. Dokumen ada kod pengesahan untuk Node.js, Python, PHP dan Go.

Apa berlaku jika endpoint webhook saya down?

Setiap peristiwa dapat 10 percubaan dalam 24 jam, dan setiap percubaan disenaraikan dalam konsol dengan status HTTP. Anda juga boleh poll endpoint mesej bila-bila masa.

Mengapa mesej boleh gagal?

Telefon mungkin dimatikan terlalu lama, nombor mungkin tidak berfungsi lagi, atau rangkaian mungkin tolak mesej. Status gagal bawa kod ralat, dan harga dikembalikan.

Berapa lama rekod mesej disimpan?

Batch, mesej dan lejar saldo kekal dalam akaun dan API anda. Log permintaan simpan 500 panggilan API terakhir dan log webhook simpan 500 penghantaran terakhir.

Untuk pembangun

Adakah SDK?

API adalah JSON biasa melalui HTTPS, jadi pustaka standard mana-mana bahasa sudah mencukupi. Dokumen ada sampel lengkap dalam curl, Node.js, Python, PHP dan Go, dan spesifikasi OpenAPI di /openapi.json hasilkan pelanggan bertip dalam kebanyakan bahasa.

Apakah had kadar?

600 permintaan seminit setiap kunci API. Setiap jawapan ada header X-RateLimit-Limit, X-RateLimit-Remaining dan X-RateLimit-Reset, dan jawapan 429 ada Retry-After.

Bagaimana cuba semula dengan selamat selepas masa tamat?

Hantar permintaan POST dengan header Idempotency-Key dan cuba semula dengan kunci sama. Untuk 24 jam, kunci dan badan sama kembalikan jawapan pertama tanpa hantar semula.

Bolehkah saya semak harga tanpa kunci API?

Ya. GET /v1/pricing dan GET /v1/pricing/{country} adalah awam, jadi halaman checkout atau dashboard boleh tunjukkan harga semasa.

Di mana saya boleh melihat apa yang dihantar oleh kod saya?

Konsol mempunyai log permintaan dengan kaedah, laluan, status dan masa untuk 500 panggilan API terakhir anda, bersebelahan dengan batch, mesej dan log webhook.

Konsol

Bolehkah saya menghantar tanpa menulis kod?

Ya. Dalam konsol, tampalkan nombor atau muat naik fail CSV sehingga 50,000 baris, tulis teks dengan medan gabungan, semak pratonton untuk setiap penerima dan kos setiap negara, dan hantar sekarang atau pada masa yang ditetapkan.

Apa yang ditunjukkan oleh konsol?

Saldo, batch terkini dengan kiraan langsung, setiap batch dengan mesej dan statusnya, top-up dan lejar, kunci API, tetapan webhook dan penghantaran, log permintaan, senarai harga, tiket sokongan dan tetapan.

Bagaimana saya menghubungi sokongan?

Dari halaman Sokongan dalam konsol. Soalan pembayaran boleh ditanya dari hari pertama; topik lain dibuka selepas top-up pertama dikreditkan.

Masih ada soalan?

Akaun yang telah log masuk boleh membuka tiket sokongan dari konsol. Soalan pembayaran boleh ditanya dari hari pertama.

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