古巴的 SMS API：群發簡訊至 +53 號碼

古巴是加勒比海的一個島國，哈瓦那是其首都，以其醫療系統和旅遊業而聞名。旅遊、醫療和政府服務的軟體系統使用簡訊進行通知。訊息由預約確認、旅行更新和公共服務公告觸發。簡訊之所以有效，是因為它能觸及所有行動用戶，包括網路有限的農村地區用戶。

古巴

國碼 +53

每段簡訊: $0.01697
$100 可發送的簡訊數量: 5,892
本地語言: 西班牙文
編碼: GSM-7 或 Unicode

發送至古巴的群發簡訊費用

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

訊息	1 個分段	2 個分段
1	$0.01697	$0.03394
1,000	$16.97	$33.94
10,000	$169.70	$339.40
100,000	$1,697.00	$3,394.00

古巴的號碼格式

古巴的手機號碼在 +53 後有 8 位數字。本地格式以 0 開頭 (05 1234567)；在 API 中該 0 被省略，因此相同的號碼在 to 欄位中變為 +53 5 1234567。

字元集與分段

西班牙文的文字每段可容納 160 個 GSM-7 字元，直到使用 á、í、ó 和 ú 為止：這些字母不在 GSM-7 範圍內，會將訊息轉為 Unicode，每段 70 個字元（每部分 67 個字元）。對於簡短的提醒，請避免使用這些字母以保持單一段落；對於較長的文字，控制台會標示出改變編碼的每個字母。

時區與發送時間

古巴會變更時鐘：哈瓦那在一月份是 UTC-5，七月份是 UTC-4。哈瓦那的 09:00 在一月份是 UTC 14:00，在夏令時期間 UTC 會提前一小時，因此請使用本地偏移量提供 send_at（例如冬季 -05:00），API 會進行轉換。

單一請求發送至古巴

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

import json, os, urllib.request

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