瓜地馬拉的 SMS API：群發簡訊至 +502 號碼

瓜地馬拉位於中美洲，首府為瓜地馬拉市，經濟以農業、紡織和旅遊業為主。銀行、物流服務和醫療機構等企業會發送簡訊給客戶，觸發時機包含付款確認、貨運更新或預約提醒。選擇SMS是因為它能觸及所有行動裝置(包含基本型手機)，且在鄉村地區也能快速被讀取。

取得 API 金鑰瓜地馬拉的請求

瓜地馬拉

國碼 +502

每段簡訊: $0.00847
$100 可發送的簡訊數量: 11,806
本地語言: 西班牙文
編碼: GSM-7 或 Unicode

發送至瓜地馬拉的群發簡訊費用

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

訊息	1 個分段	2 個分段
1	$0.00847	$0.01694
1,000	$8.47	$16.94
10,000	$84.70	$169.40
100,000	$847.00	$1,694.00

瓜地馬拉的號碼格式

瓜地馬拉行動電話號碼為+502後接8位數字且無長途冠碼，因此本地格式5123 4567在to欄位應輸入為+502 5123 4567。

字元集與分段

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

時區與發送時間

瓜地馬拉全年使用UTC-6無日光節約時間，當地09:00即為UTC 15:00。send_at接受UTC或任何ISO 8601時區偏移值，控制台排程器會自動轉換您所在的時區。

單一請求發送至瓜地馬拉

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

import json, os, urllib.request

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