馬丁尼克的 SMS API：群發簡訊至 +596 號碼

馬提尼克是法國在加勒比海的海外地區，首府為法蘭西堡，以旅遊和農業聞名。旅行社、電子商務平台和公用事業服務等軟體產品會向用戶發送簡訊。消息由預訂確認、訂單更新或服務通知等事件觸發。選擇簡訊是因為它能觸及所有手機用戶，包括使用漫遊手機的遊客，並且能及時閱讀。

取得 API 金鑰馬丁尼克的請求

馬丁尼克

國碼 +596

每段簡訊: $0.02517
$100 可發送的簡訊數量: 3,972
本地語言: 法語
編碼: GSM-7 或 Unicode

發送至馬丁尼克的群發簡訊費用

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

訊息	1 個分段	2 個分段
1	$0.02517	$0.05034
1,000	$25.17	$50.34
10,000	$251.70	$503.40
100,000	$2,517.00	$5,034.00

馬丁尼克的號碼格式

馬提尼克的手機號碼在 +596 後有 9 位數字。本地格式以 0 開頭（0696 20 12 34）；在 API 中，該 0 被省略，因此相同的號碼在 to 欄位中為 +596 696 20 12 34。

字元集與分段

法文簡訊在未使用â、ê、î、ô、û、ç、ë、ï等字元時，每分段可容納160個GSM-7字元；若含這些字元則轉為Unicode編碼，每分段限70字元（每部分67字）。簡短通知應避免特殊字元以維持單一分段；較長內容時，控制台會標示觸發編碼轉換的特定字元。

時區與發送時間

馬提尼克全年保持 UTC-4，不調整時鐘，因此馬提尼克的 09:00 始終是 UTC 的 13:00。send_at 接受 UTC 或任何 ISO 8601 偏移量，控制台調度程序會從您的時區進行轉換。

單一請求發送至馬丁尼克

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

import json, os, urllib.request

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