FAQ
Mga tanong at sagot tungkol sa Bulk SMS API
39 sagot tungkol sa accounts, pagpapadala, presyo, delivery reports at API, sinuri laban sa mga limitasyon sa code. Para sa endpoints at fields, ang Sanggunian ng API ay may detalye.
Ang serbisyo
Ano ang BulkSMSAPI?
Isang bulk SMS API para sa mga developer: magpadala ng isang text o batch na hanggang 10,000 numero bawat kahilingan sa 227 bansa sa pamamagitan ng REST, sundan ang bawat mensahe gamit ang signed webhooks, at magbayad bawat mensahe mula sa prepaid balance. Ang web console ay nagpapadala ng mga campaign mula sa nakapaste na listahan o CSV nang walang code.
Sino ang gumagamit ng bulk SMS API?
Mga product at engineering team na nagpapadala ng mga text mula sa kanilang sariling sistema: login at sign-up codes, order at delivery updates, appointment reminders, payment alerts, service notices at marketing campaigns. Kahit sino na kayang gumawa ng HTTPS request ay maaaring gamitin ito.
Saang mga bansa ako maaaring magpadala?
227 bansa at teritoryo, nakalista kasama ang kanilang mga presyo sa pricing page at countries pages. Ang isang kahilingan ay maaaring maghalo ng mga bansa: ang bawat numero ay may presyo ayon sa bansa kung saan ito kabilang.
Mayroon bang monthly fee o kontrata?
Hindi. Magbabayad ka bawat message segment mula sa prepaid balance, at walang monthly fee, setup fee o minimum volume. Ang balance ay walang expiry date.
Mayroon bang libreng pagsubok?
Ang mga account ay nagsisimula sa zero balance at ang unang top-up ay nagbubukas ng lahat. Ang unang top-up ay nagdaragdag ng bonus na hanggang 40%, kaya mas mura ang mga unang mensahe. Ang mga presyo ay pampubliko, at ang estimate endpoint at console ay nagpapakita ng eksaktong halaga bago maipadala ang anuman.
Account at API keys
Paano ako gumawa ng account?
Buksan ang Get API key. Ang iyong browser ay gagawa ng account key na nagsisimula sa acct_; kopyahin ito o i-save bilang text file, kumpirmahin na na-save mo ito, at handa na ang account. Ang account key ay ang tanging login: walang email o password na kailangang pamahalaan.
Ano ang mangyayari kung mawala ang aking account key?
Nag-iimbak lamang kami ng keyed hash nito, kaya walang makakapagpakita nito muli, kasama ang aming support team. Panatilihin ito sa isang password manager. Habang naka-sign in ka pa rin, patuloy na gagana ang console, at maaari kang makipag-ugnayan sa suporta mula rito.
Paano ako makakakuha ng API key?
Sa API keys page ng console, pagkatapos ma-credit ang unang top-up. Pangalanan ang key, gawin ito at kopyahin ito minsan: nagsisimula ito sa bsa_live_. Maaaring magkaroon ng 10 aktibong key ang isang account, bawat isa ay may sariling pangalan at rate limit counter.
Maaari ba akong gumamit ng iba't ibang key para sa production at staging?
Oo. Gumawa ng isang key bawat app o environment at bigyan ito ng pangalan. Ipinapakita ng bawat key kung kailan ito huling ginamit, at ang pag-revoke ng isa ay iiwan ang iba na gumagana.
Ilang account ang maaari kong gawin?
Hanggang 3 account bawat network address. Karamihan ng mga team ay nangangailangan ng isang account na may ilang API key.
Pagpapadala ng mensahe
Ilang numero ang maaaring kunin ng isang request?
Ang POST /v1/batches ay tumatanggap ng hanggang 10,000 numero bawat request, maaaring isang text para sa lahat o personal na text bawat numero. Ang console ay tumatanggap ng 50,000 numero bawat campaign. Ang mas malalaking listahan ay hinahati sa ilang request.
Gaano kabilis ang pagpapadala ng mensahe?
Ang queue ay tumatakbo tuwing dalawang segundo at naghahatid ng hanggang 1,200 mensahe bawat minuto bawat account sa network, ayon sa pagkakasunod-sunod na tinanggap ang mga ito. Karaniwang umaalis ang isang mensahe sa loob ng ilang segundo mula sa request.
Anong format dapat ang mga numero ng telepono?
International E.164: isang plus sign, ang calling code at ang national number, tulad ng +14155550123. Ang mga space, dash, bracket at 00 prefix ay awtomatikong nililinis; ang mga duplicate at numero na hindi mabasa ay itinatabi at hindi sisingilin.
Gaano kahaba ang isang mensahe?
Hanggang 10 segment: 1,530 character sa GSM-7 o 670 sa Unicode. Ang isang segment ay naglalaman ng 160 GSM-7 o 70 Unicode character; ang mas mahabang text ay hinati sa mga bahagi ng 153 o 67 character at pinagsama muli sa telepono.
Bakit gumamit ng mas maraming segment ang mensahe ko kaysa sa inaasahan ko?
Ang isang character na wala sa GSM-7 alphabet, tulad ng curly quote, emoji o letra tulad ng á o ç, ay nagpapalit ng buong text sa Unicode na may 70 character bawat segment. Pinapangalanan ng console composer ang mga character na iyon, at ibinabalik ng POST /v1/estimates ang encoding bago mo ipadala.
Maaari ba akong mag-schedule ng mensahe?
Oo. Idagdag ang send_at sa isang API request, o pumili ng oras sa console, mula 2 minuto hanggang 45 araw sa hinaharap. Ang isang scheduled batch ay maaaring kanselahin hanggang sa ito magsimula, at ang buong halaga nito ay ibabalik sa balance.
Maaari bang makatanggap ng iba't ibang text ang bawat recipient?
Oo. Sa pamamagitan ng API, magpadala ng batch na may mga mensahe, isang {to, text} bawat recipient. Sa console, i-paste o i-upload ang isang listahan na may karagdagang column at gumamit ng merge fields {{1}} hanggang {{9}} sa text.
Idinadagdag ba ang opt-out line sa mga mensahe ko?
Itakda ang iyong opt-out wording minsan sa Settings, halimbawa isang link o email address, at idinadagdag ito ng console sa campaign texts kapag tineck mo ang box. Sa pamamagitan ng API, kontrolado mo ang buong text, kaya idagdag mo mismo ang linya sa mga marketing message. Ang mga numero sa iyong do-not-send list ay nilalampasan ng console at API, at hindi sisingilin.
Maaari ba akong magpadala muna ng test message?
Oo. Ang console ay may test send sa isang numero bago ang isang campaign, at sa pamamagitan ng API maaari kang magpadala ng isang mensahe sa iyong sariling telepono gamit ang POST /v1/messages.
Mga presyo at bayad
Magkano ang isang SMS?
Depende ito sa bansa ng numero: bawat bansa ay may isang presyo bawat segment sa US dollars, mula $0.00247 (Brazil). Ang pricing page at GET /v1/pricing ay naglilista ng bawat bansa.
Paano kinakalkula ang halaga ng isang batch?
Para sa bawat recipient: ang presyo bawat segment ng bansa nito ay pinaparami sa mga segment ng text nito. Ang kabuuan ay kinukuha mula sa balance kapag tinanggap ang request, at ipinapakita ito ng sagot sa cost.
Ano ang pinakamababang top-up?
$40. Ang top-up ay maaaring anumang halaga mula $40 hanggang $5,000. Ang unang top-up ay nagdaragdag ng bonus na hanggang 40%, ipinapakita sa bawat halaga bago ka magbayad.
Paano ako magbabayad?
Sa console, binubuksan ng Billing ang isang hosted checkout sa isang window sa ibabaw ng pahina. Pipiliin mo ang halaga at magbabayad gamit ang cryptocurrency, at ipapakita ng payment page ang eksaktong halaga at address. Inililista ng payments page ang bawat hakbang.
Nababawi ba ang mga mensaheng hindi naipadala?
Oo. Kapag nabigo ang isang mensahe, ang halaga nito ay awtomatikong ibinabalik sa balance sa parehong pagkakataon, bilang isang refund line sa ledger. Ang isang nakanselang naka-schedule na batch ay buong ibinabalik.
Maaari ko bang i-withdraw ang aking balance?
Ang balance ay ginagamit para bayaran ang mga mensahe at nananatili sa iyong account na walang expiration date. Ang mga refund para sa mga nabigo o nakanselang mensahe ay ibinabalik din sa balance.
Nagbabago ba ang mga presyo?
Maaaring magbago ang mga presyo kapag nagbago ang mga gastos sa network. Ang kasalukuyang listahan ay may petsa, ibinabalik ng API ang petsa kasama ng bawat presyo, at ang mga mensaheng tinanggap na ay nananatili sa presyong siningil sa kanila.
Paghahatid at mga ulat
Paano ko malalaman kung naipadala ang isang mensahe?
Ang bawat mensahe ay gumagalaw mula sa queued papunta sa sent hanggang sa delivered o failed. Magdagdag ng webhook URL sa console para makakuha ng signed event para sa bawat final status, o basahin ang GET /v1/messages/{id} at GET /v1/batches/{id}.
Paano naka-sign ang mga webhook?
Sa Standard Webhooks format: headers webhook-id, webhook-timestamp at webhook-signature, kung saan ang signature ay HMAC-SHA256 ng id, timestamp at raw body gamit ang iyong whsec_ secret. Ang docs ay may verification code para sa Node.js, Python, PHP at Go.
Paano kung down ang aking webhook endpoint?
Ang bawat event ay nakakakuha ng 10 attempts sa loob ng humigit-kumulang 24 na oras, at ang bawat attempt ay nakalista sa console kasama ang HTTP status nito. Maaari mo ring i-poll ang message endpoints sa anumang oras.
Bakit nabibigo ang isang mensahe?
Maaaring matagal nang naka-off ang handset, hindi na aktibo ang numero, o maaaring tanggihan ng network ang mensahe. Ang failed status ay may kasamang error code, at ibabalik ang bayad.
Gaano katagal itinatago ang mga rekord ng mensahe?
Ang mga batch, mensahe at balance ledger ay nananatili sa iyong account at sa API. Ang request log ay nagtatago ng iyong huling 500 API calls at ang webhook log ng iyong huling 500 deliveries.
Para sa mga developer
Mayroon bang SDK?
Ang API ay plain JSON over HTTPS, kaya sapat na ang standard library ng anumang wika. Ang docs ay may kumpletong mga sample sa curl, Node.js, Python, PHP at Go, at ang OpenAPI spec sa /openapi.json ay bumubuo ng typed client sa karamihan ng mga wika.
Ano ang mga rate limits?
600 requests kada minuto kada API key. Ang bawat sagot ay may X-RateLimit-Limit, X-RateLimit-Remaining at X-RateLimit-Reset headers, at ang 429 na sagot ay may Retry-After.
Paano ako ligtas na mag-retry pagkatapos ng timeout?
Magpadala ng POST requests gamit ang Idempotency-Key header at mag-retry gamit ang parehong key. Sa loob ng 24 na oras, ang parehong key at body ay ibinabalik ang unang sagot sa halip na magpadala muli.
Maaari ko bang tingnan ang mga presyo nang walang API key?
Oo. Ang GET /v1/pricing at GET /v1/pricing/{country} ay pampubliko, kaya maaaring ipakita ng checkout page o dashboard ang live na mga presyo.
Saan ko makikita ang ipinadala ng aking code?
Ang console ay may request log na naglalaman ng method, path, status at oras ng iyong huling 500 API calls, kasama ang batches, messages at webhook log.
Ang console
Pwede bang magpadala nang hindi nagsusulat ng code?
Oo. Sa console, i-paste ang mga numero o mag-upload ng CSV file na may hanggang 50,000 rows, isulat ang text gamit ang merge fields, tingnan ang preview para sa bawat recipient at ang gastos bawat bansa, at magpadala ngayon o sa itinakdang oras.
Ano ang ipinapakita ng console?
Balance, mga kamakailang batches na may live counts, bawat batch kasama ang mga mensahe at status nito, top-ups at ledger, API keys, webhook settings at deliveries, request log, price list, support tickets at settings.
Paano ako makikipag-ugnayan sa suporta?
Mula sa Support page ng console. Maaaring magtanong tungkol sa pagbabayad mula sa unang araw; ang ibang mga paksa ay magbubukas pagkatapos ma-credit ang unang top-up.
May tanong pa ba?
Ang mga naka-sign in na account ay maaaring magbukas ng support ticket mula sa console. Maaaring magtanong tungkol sa pagbabayad mula sa unang araw.