索馬里的SMS API：群發短信至+252號碼

索馬里位於非洲之角，首都為摩加迪沙，經濟以畜牧業、農業和匯款為主。發送 SMS 的軟件產品包括移動支付平台、物流公司和人道主義組織。訊息由交易、送貨更新和緊急警報觸發。選擇 SMS 是因為它能觸及所有手機用戶，包括使用基本手機的農村地區用戶，並且閱讀速度快。

獲取 API 金鑰索馬里的請求

索馬里

電話區號 +252

每條短信分段: $0.01277
$100的短信: 7,830
當地語言: 索馬里語和阿拉伯語
編碼: GSM-7

發送至索馬里的群發簡訊費用

每條發往索馬里的訊息按$0.01277每分段收費。超過160個GSM-7字符或70個Unicode字符的內容會分割成多段，因此兩段內容的費用將翻倍。

訊息	1 分段	2 分段
1	$0.01277	$0.02554
1,000	$12.77	$25.54
10,000	$127.70	$255.40
100,000	$1,277.00	$2,554.00

索馬里的電話號碼格式

索馬里的手機號碼在 +252 後有 8 位數字，沒有區號，因此本地格式 7 1123456 在 to 欄位中變為 +252 7 1123456。

字母與分段

索馬里語和阿拉伯語文本保持在 GSM-7 字母表內，因此發往索馬里的一個分段可容納 160 個字符，較長文本的每個部分則為 153 個字符。請注意從其他工具複製的彎引號和表情符號：其中一個會將整個文本轉為 Unicode，每個分段 70 個字符，而 POST /v1/estimates 會在發送前顯示編碼。

時區與發送時間

索馬里全年保持 UTC+3，沒有時鐘變化，因此摩加迪沙的 09:00 始終是 UTC 06:00。send_at 接受 UTC 或任何 ISO 8601 偏移量，而控制台排程器會從您的時區進行轉換。

單一請求發送至索馬里

系統將立即返回包含訊息ID、號碼所屬國家(SO)及價格的回應。送達或失敗事件將通過您的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": "+25271123456", "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: "+25271123456", text: "Your Northwind code is 482913. It expires in 10 minutes." }),
});
console.log(await res.json()); // price: "0.01277", country: "SO"

import json, os, urllib.request

req = urllib.request.Request(
    "https://bulksmsapi.cc/v1/messages",
    data=json.dumps({"to": "+25271123456", "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.01277"