체코용 SMS API: +420 번호로 대량 SMS 보내기

체코는 프라하를 수도로 둔 중앙유럽 국가로, 강력한 산업 기반과 성장 중인 기술 부문을 가지고 있어요. 은행 앱, 전자상거래 플랫폼, 대중교통 시스템 같은 소프트웨어 제품들이 사용자에게 문자 메시지를 보내요. 이러한 메시지는 거래 확인, 배송 업데이트, 예약 알림 같은 이벤트에 의해 트리거돼요. 개발자들은 SMS를 선택하는데, 모든 휴대폰에 즉시 도달하고 기본 모델에서도 빠르게 읽히기 때문이에요.

API 키 발급 체코 요청

체코

국가 코드 +420

SMS 세그먼트당: $0.01037
$100 상당의 메시지: 9,643
현지 언어: 체코어
인코딩: GSM-7 또는 유니코드

체코 대량 SMS 발송 비용

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

메시지	1 세그먼트	2 세그먼트
1	$0.01037	$0.02074
1,000	$10.37	$20.74
10,000	$103.70	$207.40
100,000	$1,037.00	$2,074.00

체코의 전화번호 형식

체코의 휴대폰 번호는 +420 뒤에 9자리 숫자로 이루어져 있고, 트렁크 프리픽스가 없어요. 따라서 지역 형식인 601 123 456은 to 필드에서 +420 601 123 456이 돼요.

문자 체계와 세그먼트

체코어 문자는 č, ď, ě, ň, ř, š, ť, ů, ž 같은 글자를 사용하지 않으면 세그먼트당 160 GSM-7 문자로 맞춰져요. 하지만 이 글자들은 GSM-7 외부에 있어서 메시지를 유니코드로 바꾸고, 세그먼트당 70자(부분당 67자)로 줄여요. 짧은 알림의 경우 이 글자를 사용하지 않고 작성하면 한 세그먼트로 유지할 수 있어요. 더 긴 텍스트의 경우, 콘솔에서 인코딩을 변경한 각 글자를 표시해줘요.

시간대와 발송 시기

체코는 시계를 조정해요: 프라하는 1월에 UTC+1, 7월에 UTC+2예요. 프라하의 09:00는 1월에 UTC 08:00이고, 서머 타임 동안에는 UTC 기준으로 한 시간 더 일찍이에요. 따라서 send_at에 현지 오프셋(예: 겨울에 +01:00)을 제공하면 API가 변환을 해줘요.

한 번의 요청으로 체코에 발송

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

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

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

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

import json, os, urllib.request

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