瓜地洛普的SMS API：群發短信至+590號碼

瓜德羅普是法國在加勒比海的海外地區，以其旅遊業和農業出口聞名，首府為巴斯特爾。酒店、租車服務和電子商務平台等企業會向客戶發送短訊。這些訊息由預訂確認、租賃更新和訂單發貨等事件觸發。選擇 SMS 是因為它普遍可用，適用於所有流動設備，並且閱讀速度快，因此非常適合居民和訪客。

獲取 API 金鑰瓜地洛普的請求

瓜地洛普

電話區號 +590

每條短信分段: $0.04257
$100的短信: 2,349
當地語言: 法文
編碼: GSM-7 或 Unicode

發送至瓜地洛普的群發簡訊費用

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

訊息	1 分段	2 分段
1	$0.04257	$0.08514
1,000	$42.57	$85.14
10,000	$425.70	$851.40
100,000	$4,257.00	$8,514.00

瓜地洛普的電話號碼格式

瓜德羅普的流動電話號碼在 +590 後有 9 位數字。在當地，號碼以 0 開頭（0690 00 12 34）；在 API 中，該 0 會被省略，因此相同的號碼在 to 欄位中應輸入為 +590 690 00 12 34。

字母與分段

法文短訊每段160個GSM-7字符，但如果用咗â、ê、î、ô、û、ç、ë同ï呢啲字，就會轉成Unicode編碼，每段得70個字符(每部分67個)。短提示可以避開呢啲字保持一段；長啲嘅文，控制台會標出邊啲字令編碼改變。

時區與發送時間

瓜德羅普全年保持UTC-4，唔會更改時間，所以當地09:00永遠係UTC 13:00。send_at接受UTC或任何ISO 8601偏移，而控制台排程器會從你嘅時區轉換。

單一請求發送至瓜地洛普

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

import json, os, urllib.request

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