蘇丹的 SMS API：群發簡訊至 +249 號碼

蘇丹是東北非國家，首都為喀土穆，以農業和不斷發展的數位服務聞名。行動銀行應用程式、電子商務平台和醫療保健提供者等組織會向用戶發送簡訊。訊息由行動貨幣交易、訂單更新或預約提醒等事件觸發。選擇 SMS 是因為它能觸及所有手機，無需網路即可運作，且閱讀速度快，即使在農村地區也是如此。

取得 API 金鑰蘇丹的請求

蘇丹

國碼 +249

每段簡訊: $0.01787
$100 可發送的簡訊數量: 5,595
本地語言: 阿拉伯語和英語
編碼: Unicode (UCS-2)

發送至蘇丹的群發簡訊費用

每則簡訊至蘇丹的價格為每分段$0.01787。超過160個GSM-7字元或70個Unicode字元的內容會被分割，因此兩分段的簡訊費用將加倍。

訊息	1 個分段	2 個分段
1	$0.01787	$0.03574
1,000	$17.87	$35.74
10,000	$178.70	$357.40
100,000	$1,787.00	$3,574.00

蘇丹的號碼格式

蘇丹的手機號碼在 +249 之後有 9 位數字。本地格式會以 0 開頭（091 123 1234）；在 API 中需去掉 0，因此 to 欄位中應輸入為 +249 91 123 1234。

字元集與分段

阿拉伯語的文字始終是 Unicode，因此發送至蘇丹的阿拉伯語訊息每段為 70 個字元，較長訊息的每部分為 67 個字元。以英文或純拉丁字母撰寫的代碼和警示則可容納 160 個字元，這將長通知的成本減半。

時區與發送時間

蘇丹全年保持 UTC+2，無時鐘變更，因此喀土穆的 09:00 始終是 UTC 07:00。send_at 接受 UTC 或任何 ISO 8601 偏移，控制台排程器會從您的時區進行轉換。

單一請求發送至蘇丹

系統將立即回覆包含訊息ID、號碼所屬國家(SD)及價格。後續將透過webhook發送送達或失敗事件，失敗的訊息會自動退款。

發送清單時，可透過POST /v1/batches將相同內容發送至最多10,000組號碼，或在messages中為每組號碼指定個人化內容。

訊息參考批次參考

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+249911231234", "text": "Your Northwind code is 482913. It expires in 10 minutes."}'

const res = await fetch("https://bulksmsapi.cc/v1/messages", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.BULKSMSAPI_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ to: "+249911231234", text: "Your Northwind code is 482913. It expires in 10 minutes." }),
});
console.log(await res.json()); // price: "0.01787", country: "SD"

import json, os, urllib.request

req = urllib.request.Request(
    "https://bulksmsapi.cc/v1/messages",
    data=json.dumps({"to": "+249911231234", "text": "Your Northwind code is 482913. It expires in 10 minutes."}).encode(),
    headers={"Authorization": "Bearer " + os.environ["BULKSMSAPI_KEY"], "Content-Type": "application/json", "User-Agent": "northwind-app/1.0"},
    method="POST",
)
with urllib.request.urlopen(req) as res:
    print(json.load(res)["price"])  # "0.01787"