庫克群島的SMS API：群發短信至+682號碼

庫克群島是南太平洋的一個波利尼西亞國家，拉羅湯加是其最大的島嶼，經濟以旅遊業為主。訊息通知客人預訂確認、航班變更、旅遊行程和特別優惠。選擇短信是因為它能觸及每部手機，包括國際遊客的手機，並且在偏遠地區也能使用。

庫克群島

電話區號 +682

每條短信分段: $0.00907
$100的短信: 11,025
當地語言: 英語和太平洋語言
編碼: GSM-7

發送至庫克群島的群發簡訊費用

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

訊息	1 分段	2 分段
1	$0.00907	$0.01814
1,000	$9.07	$18.14
10,000	$90.70	$181.40
100,000	$907.00	$1,814.00

庫克群島的電話號碼格式

庫克群島的手機號碼在+682後有5位數字，沒有區號，因此本地格式71 234在to欄位中變為+682 71 234。

字母與分段

英語和太平洋語言的文本保持在GSM-7字母表內，因此發往庫克群島的一個短信段可容納160個字符，較長文本的每個部分為153個字符。注意從其他工具複製的彎引號和表情符號：其中一個會將整個文本轉為Unicode，每段70個字符，POST /v1/estimates會在發送前顯示編碼。

時區與發送時間

庫克群島全年保持UTC-10，沒有時鐘變化，因此拉羅湯加的09:00始終是UTC 19:00。send_at接受UTC或任何ISO 8601偏移量，控制台調度程序會從您自己的時區轉換。

單一請求發送至庫克群島

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

import json, os, urllib.request

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