烏克蘭的 SMS API：群發簡訊至 +380 號碼

烏克蘭是位於東歐的國家，首都為基輔，經濟多元化，包括農業、IT 和製造業。電子商務平台、配送服務和金融機構使用簡訊與客戶溝通。簡訊通常由包裹配送更新、付款確認或預約提醒等事件觸發。簡訊被選中是因為它廣泛可用、適用於所有設備，並且收件人閱讀速度快。

取得 API 金鑰烏克蘭的請求

烏克蘭

國碼 +380

每段簡訊: $0.01467
$100 可發送的簡訊數量: 6,816
本地語言: 烏克蘭語
編碼: Unicode (UCS-2)

發送至烏克蘭的群發簡訊費用

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

訊息	1 個分段	2 個分段
1	$0.01467	$0.02934
1,000	$14.67	$29.34
10,000	$146.70	$293.40
100,000	$1,467.00	$2,934.00

烏克蘭的號碼格式

烏克蘭的手機號碼在 +380 後有 9 位數字。本地格式會以 0 開頭（050 123 4567）；在 API 中需去掉 0，因此同一號碼在 to 欄位中應寫為 +380 50 123 4567。

字元集與分段

西里爾字母的文字始終為 Unicode，因此以烏克蘭語撰寫的簡訊每段可容納 70 個字元，較長文字的每部分則為 67 個字元。以英文或純拉丁字母撰寫的代碼和警報則可容納 160 個字元，這將長通知的成本減半。

時區與發送時間

烏克蘭橫跨多個時區，從基輔的 UTC+2 到辛菲羅波爾的 UTC+3（一月偏移）。send_at 為 07:00 UTC 時，一月在基輔為 09:00；對於全國性提醒，請按地區分割列表，並為每個批次設置自己的 send_at。

單一請求發送至烏克蘭

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

import json, os, urllib.request

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