海地的 SMS API：群發簡訊至 +509 號碼

海地與多明尼加共和國共享伊斯帕尼奧拉島，首都為太子港，也是最大的城市，有大量海外社區匯款回家。銀行、醫療機構和快遞服務等組織使用 SMS 與用戶溝通。訊息通常由付款確認、預約提醒和包裹追蹤更新等事件觸發。選擇 SMS 是因為它能觸及所有人，包括像 Cap-Haïtien 或 Jacmel 這樣網路接入有限的農村地區。

取得 API 金鑰海地的請求

海地

國碼 +509

每段簡訊: $0.01637
$100 可發送的簡訊數量: 6,108
本地語言: 法語
編碼: GSM-7 或 Unicode

發送至海地的群發簡訊費用

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

訊息	1 個分段	2 個分段
1	$0.01637	$0.03274
1,000	$16.37	$32.74
10,000	$163.70	$327.40
100,000	$1,637.00	$3,274.00

海地的號碼格式

海地的手機號碼在 +509 後有 8 位數字，沒有區碼，因此本地格式 34 10 1234 在 to 欄位中會變成 +509 34 10 1234。

字元集與分段

法文簡訊在未使用â、ê、î、ô、û、ç、ë、ï等字元時，每分段可容納160個GSM-7字元；若含這些字元則轉為Unicode編碼，每分段限70字元（每部分67字）。簡短通知應避免特殊字元以維持單一分段；較長內容時，控制台會標示觸發編碼轉換的特定字元。

時區與發送時間

海地會調整時鐘：太子港在 1 月是 UTC-5，7 月是 UTC-4。太子港的 09:00 在 1 月是 UTC 的 14:00，而在夏令時期間會提早一小時，因此請使用本地偏移量（例如冬季的 -05:00）提供 send_at，API 會進行轉換。

單一請求發送至海地

系統將立即回覆包含訊息ID、號碼所屬國家(HT)及價格。後續將透過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": "+50934101234", "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: "+50934101234", text: "Your Northwind code is 482913. It expires in 10 minutes." }),
});
console.log(await res.json()); // price: "0.01637", country: "HT"

import json, os, urllib.request

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