바하마용 SMS API: +1 번호로 대량 SMS 보내기

바하마는 대서양에 위치한 군도예요. 수도는 나소이고, 관광과 금융 서비스 산업으로 유명해요. 리조트, 항공사, 은행 등이 고객과 소통하기 위해 SMS를 사용해요. 예약 확인, 항공편 업데이트, 계정 알림 같은 이벤트가 발생하면 메시지가 전송돼요. SMS는 로밍이 활성화된 관광객을 포함해 모든 휴대폰 사용자에게 도달할 수 있어서 선호돼요.

API 키 발급 바하마 요청

바하마

국가 코드 +1

SMS 세그먼트당: $0.01017
$100 상당의 메시지: 9,832
현지 언어: 영어
인코딩: GSM-7

바하마 대량 SMS 발송 비용

바하마에 보내는 모든 메시지는 세그먼트당 $0.01017예요. GSM-7 160자 또는 Unicode 70자를 넘는 문자는 여러 세그먼트로 나뉘므로, 두 세그먼트 문자는 비용이 두 배예요.

메시지	1 세그먼트	2 세그먼트
1	$0.01017	$0.02034
1,000	$10.17	$20.34
10,000	$101.70	$203.40
100,000	$1,017.00	$2,034.00

바하마의 전화번호 형식

바하마는 북미 번호 체계를 사용해요: +1, 세 자리 지역 코드와 일곱 자리 번호로 구성되며, 예를 들어 +1 242 359 1234와 같아요. API는 지역 코드(여기서는 242)를 읽어 해당 번호를 미국이 아닌 바하마로 가격을 책정하므로, 목록에 전체 11자리 숫자를 유지해야 해요.

문자 체계와 세그먼트

영어 텍스트는 GSM-7 알파벳 안에 있어요. 그래서 바하마로 보내는 한 세그먼트는 160자이고, 더 긴 텍스트의 각 부분은 153자예요. 다른 도구에서 복사한 곱슬 따옴표나 이모지를 조심하세요. 그 중 하나가 전체 텍스트를 유니코드로 바꿔서 세그먼트당 70자로 만들 수 있어요. 그리고 POST /v1/estimates를 사용하면 보내기 전에 인코딩을 확인할 수 있어요.

시간대와 발송 시기

바하마는 시계를 조정해요: 나소는 1월에 UTC-5, 7월에 UTC-4예요. 나소의 09:00는 1월에 UTC로 14:00이고, 서머 타임 동안에는 UTC 기준으로 한 시간 더 일찍이에요. 그래서 send_at에 현지 오프셋(예: 겨울에 -05:00)을 지정하면 API가 변환을 처리해요.

한 번의 요청으로 바하마에 발송

응답은 메시지 ID, 번호가 매칭된 국가(BS), 그리고 가격과 함께 즉시 돌아와요. 전송 성공 또는 실패 이벤트가 웹훅으로 전달되고, 실패한 메시지는 환불돼요.

리스트를 보낼 때, POST /v1/batches로 동일한 문자를 최대 10,000개의 번호로 보내거나, 각 번호마다 개인화된 문자를 messages에 담아 보낼 수 있어요.

메시지 레퍼런스 배치 레퍼런스

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+12423591234", "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: "+12423591234", text: "Your Northwind code is 482913. It expires in 10 minutes." }),
});
console.log(await res.json()); // price: "0.01017", country: "BS"

import json, os, urllib.request

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