巴拉圭的 SMS API：群發簡訊至 +595 號碼

巴拉圭是南美洲的內陸國家，首都為亞松森，擁有強大的農業和水力發電經濟。像是行動銀行應用程式、送貨服務和農業合作社等軟體產品會發送簡訊給用戶。這些訊息通常由付款確認、送貨更新和農民的天氣警報等事件觸發。選擇簡訊是因為它能觸及所有手機，包括鄉村地區使用的基礎型號，並且能快速被閱讀。

取得 API 金鑰巴拉圭的請求

巴拉圭

國碼 +595

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

發送至巴拉圭的群發簡訊費用

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

訊息	1 個分段	2 個分段
1	$0.00417	$0.00834
1,000	$4.17	$8.34
10,000	$41.70	$83.40
100,000	$417.00	$834.00

巴拉圭的號碼格式

巴拉圭的手機號碼在 +595 後有 9 位數字。當地寫法會在前面加上 0（例如 0961 456789）；在 API 中則省略這個 0，因此相同的號碼在 to 欄位中應輸入為 +595 961 456789。

字元集與分段

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

時區與發送時間

巴拉圭全年保持 UTC-3 且不進行時鐘調整，因此亞松森的 09:00 永遠是 UTC 的 12:00。send_at 接受 UTC 或任何 ISO 8601 偏移量，而控制台排程器會從您的時區進行轉換。

單一請求發送至巴拉圭

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

import json, os, urllib.request

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