쿠바용 SMS API: +53 번호로 대량 SMS 보내기
쿠바
국가 코드 +53
- SMS 세그먼트당
- $0.01697
- $100 상당의 메시지
- 5,892
- 현지 언어
- 스페인어
- 인코딩
- GSM-7 또는 유니코드
쿠바 대량 SMS 발송 비용
| 메시지 | 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로 입력하면 돼요.
문자 체계와 세그먼트
스페인어 텍스트는 á, í, ó, ú를 사용하기 전까지 GSM-7 기준으로 세그먼트당 160자까지 가능해요. 이 문자들은 GSM-7 범위를 벗어나기 때문에 메시지를 유니코드로 변환하고, 세그먼트당 70자(부분당 67자)로 제한돼요. 짧은 알림 메시지의 경우 이 문자를 제외하면 한 세그먼트로 유지할 수 있어요. 긴 텍스트의 경우 콘솔에서 인코딩을 변경한 문자를 표시해줘요.
시간대와 발송 시기
쿠바는 시계를 조정해요. 하바나는 1월에 UTC-5, 7월에 UTC-4예요. 하바나의 09:00는 1월에 UTC 14:00이고, 서머 타임 동안에는 UTC 기준으로 한 시간 더 빠르죠. 그래서 send_at에 현지 오프셋(예: 겨울에는 -05:00)을 지정하면 API가 변환을 처리해요.
한 번의 요청으로 쿠바에 발송
응답은 메시지 ID, 번호가 매칭된 국가(CU), 그리고 가격과 함께 즉시 돌아와요. 전송 성공 또는 실패 이벤트가 웹훅으로 전달되고, 실패한 메시지는 환불돼요.
리스트를 보낼 때, 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"개발자들이 쿠바에 보내는 메시지
예약 확인
아바나의 병원에서는 환자들이 진료 예약이나 검사 예약을 한 후 SMS 확인 메시지를 보내요.
여행 업데이트
바라데로의 여행사는 비행기나 호텔 예약 변경 사항을 SMS로 방문객들에게 알려줘요.
공공 서비스 알림
산티아고 데 쿠바의 정부 기관에서 날씨 경보나 지역 행사에 대한 SMS 알림을 보내요.
이벤트 알림
트리니다드의 문화 센터에서는 다가오는 콘서트와 전시회에 대해 지역 주민들에게 SMS 알림을 보내요.
쿠바 SMS 발송: 자주 묻는 질문
계정, 결제 및 API에 대한 더 많은 답변은 FAQ에서 확인할 수 있어요.
쿠바에 대량 SMS를 보내는 데 얼마가 들까요?
$100 충전으로 쿠바에 몇 개의 SMS를 보낼 수 있나요?
API용 쿠바 번호를 어떻게 작성하나요?
쿠바에서는 SMS 메시지를 어떤 언어로 보내야 할까요?
쿠바의 관광객에게 SMS가 도달할 수 있나요?
쿠바에 문자 보내기 시작하기
계정을 생성하고 $40부터 충전한 후 콘솔이나 단 한 번의 API 호출로 쿠바에 세그먼트당 $0.01697에 문자를 보낼 수 있어요.