委內瑞拉的SMS API：群發短信至+58號碼

委內瑞拉位於南美洲的加勒比海岸，首都為卡拉卡斯，主要出口產品為石油。流動銀行、電子商務平台和政府服務等軟件產品會向用戶發送短訊。這些訊息由付款確認、送貨更新和公共服務公告等事件觸發。選擇 SMS 是因為它能即時到達所有流動電話，即使在網絡覆蓋有限的地區。

獲取 API 金鑰委內瑞拉的請求

委內瑞拉

電話區號 +58

每條短信分段: $0.01187
$100的短信: 8,424
當地語言: 西班牙語
編碼: GSM-7 或 Unicode

發送至委內瑞拉的群發簡訊費用

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

訊息	1 分段	2 分段
1	$0.01187	$0.02374
1,000	$11.87	$23.74
10,000	$118.70	$237.40
100,000	$1,187.00	$2,374.00

委內瑞拉的電話號碼格式

委內瑞拉的流動電話號碼在 +58 後有 10 位數字。當地寫法會在前面加 0 (0412-1234567)；在 API 中會去掉這個 0，因此相同的號碼在 to 欄位中應寫為 +58 412 1234567。

字母與分段

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

時區與發送時間

委內瑞拉全年保持 UTC-4，沒有時鐘變更，因此卡拉卡斯的 09:00 始終是 UTC 13:00。send_at 接受 UTC 或任何 ISO 8601 偏移，控制台排程器會從您的時區進行轉換。

單一請求發送至委內瑞拉

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

import json, os, urllib.request

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