東帝汶的SMS API：群發短信至+670號碼

東南亞國家東帝汶以帝力為首都，經濟依賴石油出口同農業。發送SMS嘅軟件包括手機銀行應用、政府服務同本地非政府組織。信息觸發場景包括付款確認、預約提醒同社區警報。選擇SMS因其可覆蓋所有手機（包括基本型號），且偏遠地區亦能快速閱讀。

東帝汶

電話區號 +670

每條短信分段: $0.01217
$100的短信: 8,216
當地語言: 德頓語同葡萄牙語
編碼: GSM-7 或 Unicode

發送至東帝汶的群發簡訊費用

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

訊息	1 分段	2 分段
1	$0.01217	$0.02434
1,000	$12.17	$24.34
10,000	$121.70	$243.40
100,000	$1,217.00	$2,434.00

東帝汶的電話號碼格式

東帝汶手機號碼為+670後接8位數字（無區號），本地格式7721 2345在to字段應寫作+670 7721 2345。

字母與分段

Tetum 同葡萄牙文嘅文字喺使用 á, â, ã, ç, ê, í, ó, ô, õ 同 ú 之前，每個分段可以容納 160 個 GSM-7 字符：呢啲字母唔喺 GSM-7 範圍內，會將訊息轉為 Unicode，每個分段得 70 個字符（每個部分 67 個）。為咗保持一個分段，短提示可以唔用呢啲字母；較長嘅文字，控制台會標示出改變編碼嘅每個字母。

時區與發送時間

東帝汶全年保持 UTC+9，冇時鐘變更，所以帝力嘅 09:00 永遠係 00:00 UTC。send_at 接受 UTC 或任何 ISO 8601 偏移，控制台排程器會從你嘅時區轉換。

單一請求發送至東帝汶

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

import json, os, urllib.request

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