古巴短信API：向+53号码群发短信

古巴是加勒比海的一个岛国，哈瓦那是其首都，以其医疗系统和旅游业而闻名。旅游、医疗和政府服务的软件系统使用短信进行通知。消息由预约确认、旅行更新和公共服务公告触发。短信之所以有效，是因为它可以覆盖所有移动用户，包括互联网有限的农村地区的用户。

获取API密钥古巴专属需求

古巴

国际区号 +53

每条短信分段: $0.01697
$100可发送短信数: 5,892
本地语言: 西班牙语
编码: GSM-7或Unicode

向古巴发送群发短信的费用

每条短信按$0.01697每分段向古巴收费。超过160个GSM-7字符或70个Unicode字符的文本会被分段，因此两段文本的费用是两倍。

消息	1个分段	2个分段
1	$0.01697	$0.03394
1,000	$16.97	$33.94
10,000	$169.70	$339.40
100,000	$1,697.00	$3,394.00

古巴的号码格式

古巴的手机号码在+53后有8位数字。本地格式以0开头（05 1234567）；在API中，该0被删除，因此相同的号码在to字段中为+53 5 1234567。

字母和分段

西班牙语文本在每段160个GSM-7字符内适用，直到使用á、í、ó和ú：这些字母不在GSM-7范围内，会将消息转换为Unicode编码，每段70个字符（每部分67个字符）。对于简短提醒，避免使用这些字母以保持单段；对于较长文本，控制台会列出导致编码改变的每个字母。

时区和时间

古巴会调整时钟：哈瓦那在1月为UTC-5，7月为UTC-4。哈瓦那的09:00在1月为UTC 14:00，在夏令时期间UTC时间提前一小时，因此使用本地偏移量（例如冬季-05:00）提供send_at，API会进行转换。

通过一个请求向古巴发送

响应会立即返回消息ID、号码匹配的国家（CU）和价格。送达或失败事件会通过您的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": "+5351234567", "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: "+5351234567", text: "Your Northwind code is 482913. It expires in 10 minutes." }),
});
console.log(await res.json()); // price: "0.01697", country: "CU"

import json, os, urllib.request

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