保加利亞的 SMS API：群發簡訊至 +359 號碼

保加利亞是巴爾幹半島國家，首都索菲亞以IT產業和旅遊業聞名。發送簡訊的軟體系統包括電商平台、銀行和旅行社。訊息通常由訂單確認、付款通知或航班更新等事件觸發。選擇簡訊是因為它能觸及所有手機用戶（包括遊客）且閱讀速度快。

保加利亞

國碼 +359

每段簡訊: $0.02547
$100 可發送的簡訊數量: 3,926
本地語言: 保加利亞語
編碼: Unicode (UCS-2)

發送至保加利亞的群發簡訊費用

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

訊息	1 個分段	2 個分段
1	$0.02547	$0.05094
1,000	$25.47	$50.94
10,000	$254.70	$509.40
100,000	$2,547.00	$5,094.00

保加利亞的號碼格式

保加利亞手機號碼在+359後有8位數字。當地格式會以0開頭（如043 012 345）；在API中需省略這個0，因此相同號碼在to欄位應輸入為+359 43 012 345。

字元集與分段

西里爾字母文本始終使用Unicode編碼，因此發往保加利亞的保加利亞語訊息每段可容納70個字元（長訊息後續分段為67字元）。若以英文或拉丁字母撰寫代碼和通知，則每段可達160字元，能降低長訊息的成本。

時區與發送時間

保加利亞會調整時鐘：索菲亞在 1 月是 UTC+2，7 月是 UTC+3。索菲亞的 09:00 在 1 月是 07:00 UTC，而在夏令時間運行時會比 UTC 早一小時，因此請在 send_at 中提供當地偏移量（例如冬季的 +02:00），API 會進行轉換。

單一請求發送至保加利亞

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

import json, os, urllib.request

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