대량 SMS API

개발자가 오후 한나절이면 연동하는 대량 SMS API

BulkSMSAPI는 개발자를 위한 대량 SMS API예요. REST로 문자 하나를 보내거나 한 번의 요청으로 최대 10,000개 번호에 배치를 보내 227개 국가에 발송하고, 모든 메시지를 서명된 웹훅으로 추적하며, 미리 충전한 잔액에서 메시지당 비용을 지불해요.

  • 메시지당 과금
  • 월별 요금 없음
  • 서명된 웹훅

미국 발송 SMS는 세그먼트당 $0.00507

BulkSMSAPI 개요

서비스 소개
대량 SMS 발송을 위한 REST API 및 웹 콘솔: 단일 메시지, 수천 건의 배치 처리, 또는 붙여넣기 목록으로 캠페인 발송
지원 국가
227개 국가 및 지역 지원, 각각 별도의 세그먼트 단위 가격 적용
가격
세그먼트당 $0.00247 (브라질)부터 미국 기준 $0.00507까지. 월별 요금 없음, 설정 비용 없음.
요청
HTTPS 기반 JSON, Bearer API 키 사용, 배치 요청당 최대 10,000명 수신자 처리 가능, 키당 분당 600회 요청 제한
전송 리포트
모든 전송 성공/실패 메시지에 대한 서명된 웹훅 제공, 이벤트당 10회 재시도, 폴링용 GET 엔드포인트 포함
예약 발송
2분 후부터 45일 전까지 send_at 설정 가능, 예약된 배치 취소 시 전액 환불
문자 내용
GSM-7 및 유니코드(UCS-2) 지원, 최대 10세그먼트 장문 메시지, 수신자별 병합 필드 및 개인화 텍스트 적용 가능
결제
$40부터 시작하는 선불 잔액이에요, 호스팅된 결제를 통해 충전할 수 있어요. 실패한 메시지는 잔액으로 돌아가요.

기능 구성 요소

대량 SMS 연동에 필요한 모든 것

하나의 API로 구성된 6가지 기능, 모두 메시지 단위 과금 및 동일한 콘솔에서 관리. 개별 사용 또는 조합하여 완전한 알림 파이프라인 구축 가능

단일 메시지

POST /v1/messages는 하나의 번호로 하나의 문자를 보내고 즉시 메시지 ID로 응답해요. 로그인 코드, 비밀번호 재설정, 결제 알림은 코드가 호출하는 순간 전송돼요.

메시지 보내기

배치

POST /v1/batches는 하나의 요청으로 최대 10,000개의 번호를 처리할 수 있어요. 모두에게 동일한 문자를 보내거나 번호별로 개별 문자를 보낼 수 있어요. 중복 및 잘못된 번호는 제외되고 응답에 나열돼요.

배치 보내기

서명된 웹훅

전송 성공 또는 실패한 모든 메시지는 서명된 JSON 이벤트로 엔드포인트를 호출해요. 각 이벤트는 약 24시간 동안 10번 재시도되므로 배포로 인해 상태를 잃는 일은 없어요.

웹훅 설정하기

가격 API

GET /v1/pricing는 키 없이도 모든 국가의 세그먼트당 가격을 반환해요. 자체 제품에 비용을 표시하거나 대량 발송 전 경로를 확인할 수 있어요.

API로 가격 읽기

예약 발송

send_at을 요청에 추가하면 배치가 해당 시간까지 대기해요. 2분부터 최대 45일까지 예약할 수 있어요. 시작 전에 취소하면 전체 비용이 잔액으로 돌아가요.

배치 예약하기

전체 팀을 위한 콘솔

목록을 붙여넣거나 업로드하고, 문자를 작성하고, 수신자별로 미리보고 코드 없이 보낼 수 있어요. API의 모든 배치는 실시간 카운트와 함께 동일한 콘솔에 표시돼요.

콘솔 보기

코드, 알림, 캠페인을 위한 하나의 대량 SMS API

거래 문자와 마케팅 캠페인은 동일한 엔드포인트, 동일한 가격 목록, 동일한 전송 이벤트를 사용해요. 차이점은 하나의 요청에 몇 개의 번호를 넣는지 뿐이에요.

거래 메시지

시스템의 하나의 이벤트, 한 사람에게 하나의 문자를 몇 초 내에 보내요.

  • POST /v1/messages는 메시지 ID, 가격, 상태와 함께 202로 응답해요. 이는 문자가 큐를 떠나기 전에 이루어져요.
  • 자신의 주문 또는 사용자 ID를 reference에 넣으면 해당 메시지의 모든 웹훅에서 돌아와요.
  • 안전하게 재시도: 동일한 Idempotency-Key를 사용하면 24시간 동안 첫 번째 응답을 반환하므로 두 번 보내지 않아도 돼요.
메시지 보내기

대량 캠페인

하나의 문자, 또는 한 사람당 하나의 문자를 하나의 요청으로 수천 명에게 보내요.

  • POST /v1/batches는 요청당 10,000개의 번호를 처리해요; 콘솔은 붙여넣기 또는 CSV 파일에서 캠페인당 50,000개의 번호를 처리해요.
  • 번호는 자동으로 정리돼요: 공백, 대시, 00 접두사가 수정되고, 중복 및 잘못된 번호는 나열되고 건너뛰어져요.
  • POST /v1/estimates로 먼저 예상해보세요: 총 비용, 세그먼트, 국가별 분할을 아무것도 보내지 않고 확인할 수 있어요.
배치 보내기

팀이 SMS API로 보내는 것

실제 시스템의 실제 메시지: 각각은 단일 API 호출 또는 예약된 배치이며, 번호의 국가에 따라 세그먼트당 가격이 책정돼요.

로그인 및 가입 코드

POST /v1/messages로 인증 서비스에서 일회용 코드를 보내고, 사용자가 새 코드를 요청하기 전에 전송 이벤트를 확인하세요.

주문 및 배송 업데이트

택배가 창고를 떠날 때 주문 시스템이 API를 호출해 배송 시간대와 추적 코드를 한 줄의 짧은 문자로 보내세요.

예약 알림

야간 작업으로 내일 예정된 환자/고객 명단을 만들고, 전날 저녁에 개인별 맞춤 문자를 한 번에 발송하세요.

결제 및 계정 알림

카드 결제, 계좌 이체, 새 기기 로그인 시 바로 문자를 보내요. 세그먼트 단위로 요금이 부과되고, 상태가 기록돼요.

판매 및 출시 캠페인

콘솔에서 50,000명에게 또는 CRM에서 10,000명 단위로 발송하며, 모든 문자에 수신 거부 안내를 추가하세요.

서비스 및 장애 공지

서비스, 항공편, 배송 경로 변경 시 해당 고객에게 즉시 알리고, 복구 시 다시 안내하세요.

한 번의 요청으로 배치 발송

콘솔에서 API 키를 생성하고, BULKSMSAPI_KEY로 내보낸 후 이 중 하나를 실행해 보세요. 각 샘플은 표준 라이브러리만 사용하는 완전한 프로그램이에요. 실행 결과로 배치 ID, 비용, 실시간 카운트를 확인할 수 있어요.
배치 생성
curl https://bulksmsapi.cc/v1/batches \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: spring-sale-0412" \
  -d '{
    "name": "Spring sale",
    "text": "Spring sale at Northwind: 20% off until Sunday. Opt out: northwind.example/sms",
    "to": [
      "+14155550123",
      "+447400123456",
      "+4915123456789"
    ]
  }'

가격

국가별 대량 SMS 가격

각 국가는 메시지 세그먼트당 하나의 가격을 가지고 있어요. 이 가격은 미국 달러로 표시되며, API와 콘솔 모두 동일해요. 일반 텍스트는 최대 160자까지 하나의 세그먼트로 계산되고, 더 길거나 유니코드 텍스트는 더 많은 세그먼트를 사용해요. 가격 목록은 전송 전에 비용을 확인할 수 있게 해줘요.
국가
세그먼트당
$0.00507
10,000건의 메시지
$50.70
미국 SMS API

발송 비용 계산 방식

  • 수신자 국가의 세그먼트 단가 × 메시지 세그먼트 수 × 수신자 수. 추가 비용 없음.
  • 요청이 수락되면 비용이 잔액에서 차감되므로, 배치가 중간에 자금 부족으로 중단되는 일은 없어요.
  • 전송에 실패한 메시지는 자동으로 잔액으로 환불돼요. 그리고 예약된 배치를 취소하면 전액 환불받을 수 있어요.
  • 가격은 GET /v1/pricing에서 실시간으로 읽어오므로, 여러분의 제품에서도 동일한 숫자를 표시할 수 있어요.
전체 가격표

227개 국가 중 227개

국가SMS당
가나$0.01357
가봉$0.01187
가이아나$0.00957
감비아$0.00907
건지$0.01417
과들루프$0.04257
과테말라$0.00847
괌$0.00617
그레나다$0.02207
그리스$0.00987
그린란드$0.00587
기니$0.01357

선불 잔액으로 사용한 만큼 지불

$40부터 $5,000까지 원하는 금액을 충전하고 어떤 국가든 원하는 속도로 사용할 수 있어요. 잔액은 만료일이 없고 월별 요금도 없으며, 첫 충전 시 보너스가 제공돼요.
$40첫 충전 시 +10%

첫 충전 시 잔액 $44

미국에 보내는 1세그먼트 메시지 약 8,678건

$100첫 충전 시 +20%

첫 충전 시 잔액 $120

미국에 보내는 1세그먼트 메시지 약 23,668건

$200첫 충전 시 +25%

첫 충전 시 잔액 $250

미국에 보내는 1세그먼트 메시지 약 49,309건

$300첫 충전 시 +30%

첫 충전 시 잔액 $390

미국에 보내는 1세그먼트 메시지 약 76,923건

$500첫 충전 시 +35%

첫 충전 시 잔액 $675

미국에 보내는 1세그먼트 메시지 약 133,136건

$1,000첫 충전 시 +40%

첫 충전 시 잔액 $1,400

미국에 보내는 1세그먼트 메시지 약 276,134건

계정 만들기

메시지 수는 미국 기준으로 세그먼트당 $0.00507에요. 결제 방식

대용량을 위한 한도

아래 숫자들은 API를 실행하는 코드에 설정된 제한 사항들이에요. 문서에서는 각 제한 사항을 해당 헤더나 오류와 함께 설명하고 있어요.

10,000

배치 요청당 번호 수

한 번의 호출로 목록을 보내요. 국가별로 나누고 수신자별로 가격이 책정돼요.

600

키당 분당 요청 수

모든 응답에 포함된 Rate limit 헤더는 현재 윈도우에 남은 요청 한도를 보여줘요.

1,200

계정당 분당 메시지 수

큐는 메시지를 순서대로 경로에 전달해요, 2초마다 한 번씩.

계정에서 전송 결과까지 네 단계

영업 전화도 없고 계약도 없어요. 계정은 브라우저에서 생성된 키고, 첫 충전 후에 API가 열려요.
  1. 단계 1

    계정 만들기

    브라우저에서 계정 키를 생성해요. 한 번 저장하면 이 키가 유일한 로그인 수단이에요. 이메일이나 비밀번호는 필요하지 않아요.

  2. 단계 2

    잔액 충전

    $40부터 호스팅된 결제로 충전할 수 있어요. 잔액은 콘솔과 GET /v1/balance 엔드포인트에서 확인할 수 있어요.

  3. 단계 3

    API 키 만들기

    앱이나 환경별로 키를 지정하고, 한 번 복사한 뒤 언제든지 다른 키에 영향을 주지 않고 해지할 수 있어요.

  4. 단계 4

    전송 및 수신

    /v1/messages나 /v1/batches를 호출하고 웹훅 URL을 추가해요: 전송 성공과 실패 이벤트가 서명된 상태로 도착해요.

오늘 첫 배치를 보내보세요

몇 초 만에 계정을 만들고, $40부터 충전해서 HTTPS를 지원하는 어떤 언어로든 API를 호출할 수 있어요. 메시지당 가격은 $0.00247부터 시작해요.

개발자를 위한 대량 SMS API: REST, 웹훅, 227개 국가 | BulkSMSAPI