服務
什麼是 BulkSMSAPI？
專為開發者設計的群發簡訊 API：透過 REST 向 227 個國家發送單條訊息或每批次最多 10,000 個號碼，並透過簽名 Webhooks 追蹤每條訊息，從預付餘額中按訊息支付費用。網頁控制台可從貼上的列表或 CSV 發送活動，無需編寫代碼。
誰會使用群發簡訊 API？
從自身系統發送簡訊的產品及工程團隊：登入及註冊碼、訂單及送貨更新、預約提醒、付款通知、服務公告及市場推廣活動。任何能發出 HTTPS 請求的人均可使用。
我可以發送到哪些國家？
227 個國家及地區，其價格列於定價頁面及國家頁面。一個請求可混合多個國家：每個號碼按其所屬國家定價。
是否有月費或合約？
沒有。您按訊息分段從預付餘額中支付費用，且無月費、設置費或最低用量要求。餘額沒有到期日。
是否有免費試用？
帳戶初始餘額為零，首次充值後即可使用所有功能。首次充值可獲得最高 40% 的獎勵，因此首幾條訊息費用更低。價格公開，估算端點及控制台會在發送前顯示確切費用。
帳戶及 API 金鑰
如何創建帳戶？
打開獲取 API 金鑰頁面。您的瀏覽器會生成一個以 acct_ 開頭的帳戶金鑰；複製或將其保存為文字檔案，確認已保存後，帳戶即準備就緒。帳戶金鑰是唯一的登入方式：無需管理電郵或密碼。
如果我遺失了帳戶金鑰會怎樣？
我們僅儲存其加密哈希值，因此包括我們的支援團隊在內，任何人都無法再次顯示它。請將其保存在密碼管理器中。當您仍處於登入狀態時，控制台會繼續運作，您可從中聯繫支援團隊。
如何獲取 API 金鑰？
在控制台的 API 金鑰頁面，首次充值後即可創建。為金鑰命名，創建並複製一次：它以 bsa_live_ 開頭。每個帳戶可持有 10 個有效金鑰，每個金鑰都有自己的名稱和速率限制計數器。
我可以在生產和測試環境中使用不同的金鑰嗎？
可以。為每個應用或環境創建一個金鑰並為其命名。每個金鑰會顯示最後使用時間，撤銷一個金鑰不會影響其他金鑰的正常使用。
我可以創建多少個帳戶？
每個網絡地址最多可創建 3 個帳戶。大多數團隊只需要一個帳戶並使用多個 API 金鑰。
發送訊息
一個請求可以包含多少個號碼？
POST /v1/batches 每個請求最多可包含 10,000 個號碼，可以是所有人接收同一條訊息，或每個號碼接收個人化訊息。控制台每次活動可處理 50,000 個號碼。更大的列表會被拆分為多個請求。
訊息發送速度如何？
隊列每兩秒運行一次，並按接受順序將每個帳戶每分鐘最多 1,200 條訊息傳遞給網絡。單條訊息通常在請求後的幾秒內發出。
電話號碼應採用什麼格式？
國際 E.164 格式：加號、國家代碼和本地號碼，例如 +14155550123。空格、破折號、括號和 00 前綴會自動清理；重複號碼和無法讀取的號碼會被排除且不收取費用。
訊息可以有多長？
最多 10 個分段：GSM-7 編碼下 1,530 個字符，Unicode 編碼下 670 個字符。每個分段可容納 160 個 GSM-7 字符或 70 個 Unicode 字符；較長的文本會被拆分為 153 或 67 個字符的部分，並在手機上重新組合。
為什麼我的訊息使用了比預期更多的分段？
一個超出 GSM-7 字母表的字符，例如花引號、表情符號或 á、ç 等字母，會將整個文本切換為 Unicode 編碼，每分段 70 個字符。控制台編輯器會標示這些字符，POST /v1/estimates 會在發送前返回編碼信息。
我可以預約發送訊息嗎？
可以。在 API 請求中添加 send_at，或在控制台中選擇時間，從 2 分鐘到 45 天內。預約批次在開始前可以取消，其全部費用會返還到餘額。
每個收件人可以收到不同的訊息嗎？
可以。通過 API 發送批次訊息，每個收件人一個 {to, text}。在控制台中，粘貼或上傳帶有額外列的列表，並在文本中使用合併字段 {{1}} 到 {{9}}。
我的訊息中會添加退訂提示嗎？
在設置中設定一次退訂提示，例如連結或電郵地址，勾選後控制台會將其添加到活動文本中。通過 API 你可以控制完整文本，因此請自行在營銷訊息中添加該提示。控制台和 API 會跳過你的不發送列表中的號碼，且不收取費用。
我可以先發送測試訊息嗎？
可以。控制台在活動前提供向一個號碼發送測試訊息的選項，通過 API 你可以使用 POST /v1/messages 向自己的手機發送單條訊息。
價格與付款
一條 SMS 的費用是多少？
這取決於號碼所屬國家：每個國家每個分段有一個美元價格，從 $0.00247（巴西）起。價格頁面和 GET /v1/pricing 列出了每個國家的價格。
如何計算批次的費用？
對於每個收件人：其國家每個分段的價格乘以其文本的分段數。請求被接受時，總和會從餘額中扣除，並在回應中顯示為費用。
最低充值金額係幾多？
$40。充值金額可以係$40至$5,000之間任何數額。首次充值可獲高達40%獎賞，支付前會顯示每項金額嘅獎賞。
點樣付款？
喺控制台，Billing會喺頁面上彈出一個託管結賬窗口。你可以選擇金額並用加密貨幣支付，支付頁面會顯示確切金額同地址。付款頁面會列出每個步驟。
發送失敗嘅訊息會退款嗎？
會。當訊息發送失敗，其費用會自動退回餘額，並喺賬簿中顯示為退款項目。已取消嘅預約批次會全數退款。
可以提取餘額嗎？
餘額用於支付訊息費用，並會永久保留喺賬戶內。失敗或取消訊息嘅退款亦會退回餘額。
價格會變動嗎？
當網絡成本變動時，價格可能會調整。當前價格列表會標示日期，API會隨每個價格返回日期，已接受嘅訊息會維持原有收費。
送達與報告
點知訊息已送達？
每條訊息會由排隊、發送、到送達或失敗。喺控制台添加webhook URL即可獲取每個最終狀態嘅簽名事件，或讀取GET /v1/messages/{id}同GET /v1/batches/{id}。
Webhook點樣簽署？
採用Standard Webhooks格式：標頭包括webhook-id、webhook-timestamp同webhook-signature，簽名係用你嘅whsec_密鑰對id、時間戳同原始正文進行HMAC-SHA256加密。文檔提供Node.js、Python、PHP同Go嘅驗證代碼。
如果webhook端點離線點算？
每個事件會喺約24小時內嘗試10次，每次嘗試連同HTTP狀態都會列喺控制台。你亦可以隨時輪詢訊息端點。
點解訊息會發送失敗？
可能因為手機長時間關機、號碼已停用或網絡拒絕訊息。失敗狀態會帶有錯誤代碼，費用會退還。
訊息記錄保存幾耐？
批次、訊息同餘額賬簿會保留喺你嘅賬戶同API內。請求日誌保存最近500次API調用，webhook日誌保存最近500次交付。
開發者專區
有冇SDK？
API採用HTTPS上嘅純JSON格式，任何語言嘅標準庫已足夠。文檔提供curl、Node.js、Python、PHP同Go完整示例，/openapi.json嘅OpenAPI規範可為多數語言生成類型化客戶端。
速率限制係點？
每個API密鑰每分鐘600次請求。每個回應都有X-RateLimit-Limit、X-RateLimit-Remaining同X-RateLimit-Reset標頭，429回應會包含Retry-After。
超時後點安全重試？
發送帶Idempotency-Key標頭嘅POST請求，並用相同密鑰重試。24小時內相同密鑰同正文會返回首次回應而唔會重複發送。
冇API密鑰可以查價嗎？
可以。GET /v1/pricing同GET /v1/pricing/{country}係公開嘅，結賬頁面或儀表板可顯示實時價格。
我嘅程式碼發送咗啲咩去邊度睇到？
控制台有請求記錄，顯示你最近500次API呼叫嘅方法、路徑、狀態同時間，仲有批次、訊息同webhook記錄。
控制台
我可以唔寫程式碼就發送嗎？
可以。喺控制台，你可以貼上號碼或者上傳最多50,000行嘅CSV檔案，寫入帶有合併欄位嘅文字，檢查每個收件人嘅預覽同每個國家嘅費用，然後立即發送或者設定時間發送。
控制台顯示啲咩？
餘額、最近批次同實時計數、每個批次嘅訊息同狀態、充值同賬簿、API密鑰、webhook設定同交付、請求記錄、價目表、支援票同設定。
我點樣聯絡支援？
喺控制台嘅支援頁面。付款問題可以喺第一日就問；其他主題要等第一次充值到賬後先可以問。