海地的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"