梵蒂岡的SMS API：群發短信至+39號碼

梵蒂岡城是世界上最小的獨立國家，位於羅馬市內，是天主教會的精神中心。活動管理系統、朝聖應用程式和行政服務等軟件產品向遊客和工作人員發送短訊。這些訊息由旅遊確認、時間表變更和安全警報等事件觸發。選擇短訊是因為它能立即觸及所有流動電話，包括國際遊客的電話。

獲取 API 金鑰梵蒂岡的請求

梵蒂岡

電話區號 +39

每條短信分段: $0.00987
$100的短信: 10,131
當地語言: 意大利文
編碼: GSM-7

發送至梵蒂岡的群發簡訊費用

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

訊息	1 分段	2 分段
1	$0.00987	$0.01974
1,000	$9.87	$19.74
10,000	$98.70	$197.40
100,000	$987.00	$1,974.00

梵蒂岡的電話號碼格式

梵蒂岡城的電話號碼使用意大利的編號計劃，因此它們以 +39 06 698 開頭，並按意大利的費率計費。請以 +39 後跟完整號碼的方式發送，就像您以國際格式寫任何意大利號碼一樣。

字母與分段

意大利語文本保持在 GSM-7 字母表內，因此發往梵蒂岡城的一段短訊包含 160 個字符，較長文本的每部分包含 153 個字符。注意從其他工具複製的彎引號和表情符號：其中一個會將整個文本轉換為每段 70 個字符的 Unicode，POST /v1/estimates 會在發送前顯示編碼。

時區與發送時間

梵蒂岡城會調整時鐘：梵蒂岡在一月份為 UTC+1，七月份為 UTC+2。梵蒂岡的 09:00 在一月份是 UTC 08:00，而在夏令時期間則比 UTC 早一小時，因此請使用本地偏移量（例如冬季的 +01:00）提供 send_at，API 會進行轉換。

單一請求發送至梵蒂岡

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

import json, os, urllib.request

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