# 계정 정보를 받고 5분 뒤 첫 테스트 SMS를 보내 보세요.

- 표준 URL: https://www.broadnet.me/ko/developers/quickstart
- 언어: ko
- 최종 수정일: 2026-10-21
- 발행처: BroadNet (https://www.broadnet.me)
- 렌더링된 페이지를 기반으로 생성된 위 페이지의 Markdown 버전입니다.

개발자 퀵스타트

테스트 계정을 신청하시면 영업일 기준 1일 이내에 테스트 자격 증명을 보내드립니다. 그 후 토큰을 사용하여 TypeScript SDK를 설치하고 다음을 호출하세요. `smsSendsmsPost`. 테스트 계정을 수령한 후 약 5분 이내에 첫 테스트 메시지가 고객님의 인증된 번호로 전송됩니다. 아래의 모든 샘플은 바로 복사하여 사용할 수 있으며, 5단계에서는 운영 환경 적용 전 확인해야 할 사항을 다룹니다.

[테스트 계정 신청 (영문 양식)](https://www.broadnet.me/ko/contact?intent=test-access) [전체 API 레퍼런스](https://www.broadnet.me/developers/api)

진행

0 / 5 단계 · 5분

0/5

남은 단계

5

1. 액세스 토큰을 받으세요 1단계 · 30 초
2. SDK를 설치하세요 2단계 · 45 초
3. 첫 메시지를 발송하세요 3단계 · 60 초
4. 전송 결과 보고 수신 4단계 · 90 초
5. 운영 환경 적용 전 5단계 · 5분에 포함되지 않음

요청부터 운영까지

## 첫 메시지 발송까지의 단계별 소요 시간입니다.

1. 01 테스트 계정 신청 영업일 기준 1일 이내에 회신드립니다 메시징 엔지니어가 테스트 계정 정보를 전달해 드리며, 대상 국가, 발송량 및 사용 사례에 대해 30분간의 상담을 진행합니다.
2. 02 첫 테스트 메시지 발송 계정 정보 수령 후 약 5분 이내 Quickstart 코드를 사용하여 본인의 인증된 번호로 테스트 문자를 발송하세요. 전송 결과 보고는 웹훅으로 전송됩니다.
3. 03 연동 영업일 기준 2–5일 코드 샘플과 동일한 엔드포인트를 대상으로 테스트 자격 증명을 사용하여 빌드 및 테스트를 진행하세요. REST 또는 SMPP에서 BroadNet 엔지니어가 함께 지원합니다.
4. 04 승인 영업일 기준 3–10일 연동 작업과 병행하여 발신자 신원, 트래픽 목적 및 목적지 규칙을 검토하고 각 규제 기관에 발신자 ID 등록을 진행합니다.
5. 05 운영 전환일 계정에 대한 운영 액세스 및 경로가 활성화되었습니다. 통합 작업이 이미 https://api.broadnet.me을 호출하고 있습니다.

전체 소요 기간: 대부분의 시장에서 신청부터 운영 환경 적용까지 영업일 기준 5–15일이 소요됩니다. 규제 기관의 발신자 ID 승인 기간이 더 긴 경우에는 더 오래 걸릴 수 있습니다.

다이어그램 A2P 메시지가 휴대폰에 도달하는 방식

1. 사용자 애플리케이션 REST API 또는 SMPP을 통해 전송
2. BroadNet 플랫폼 각 메시지를 검증, 경로 지정 및 과금
3. 통신사의 SMSC 통신사 직접 연동
4. 가입자 단말기 메시지 전송 완료

전송 결과 보고(DLR)가 동일한 경로를 통해 웹훅으로 전달됩니다

이 페이지의 내용

1. 01 액세스 토큰을 받으세요
2. 02 SDK를 설치하세요
3. 03 첫 메시지를 발송하세요
4. 04 전송 결과 보고 수신
5. 05 운영 환경 적용 전

자격 증명 수령 후

5분

자격 증명 수령부터 첫 테스트 메시지 수신까지 약 5분이 소요됩니다. 웹훅 단계에는 공개 URL이 필요하며, ngrok를 사용하면 원활하게 작동합니다.

01

1단계 · 30 초

## 액세스 토큰을 받으세요.

테스트 계정을 신청하시면 액세스 토큰이 포함된 인증 정보가 제공됩니다. 영업일 기준 1일 이내에 회신드립니다. 토큰을 BROADNET_TOKEN 환경 변수에 저장하고, 모든 호출 시 Authorization: Bearer 헤더에 포함하여 전송하세요. 이 페이지의 모든 예시는 운영 환경의 베이스 URL인 https://api.broadnet.me을 사용합니다.

BroadNet 계정 · 액세스 토큰

액세스 토큰

quickstart-default

active

84f1a02e3c7d4b91a7e0•••••••••••• copy

헤더

Bearer

환경 변수

BROADNET_TOKEN

기본 URL

api.broadnet.me

$ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" …

200 OK

테스트하기

POST /sms/sendSms을 사용하여 본인의 인증된 번호로 테스트 문자를 발송해 보세요. 응답 본문에 메시지 ID가 포함된 200 OK가 반환되면, 코드를 작성하기 전 토큰이 정상적으로 작동함을 확인할 수 있습니다.

step 1.broadnet.me

02

2단계 · 45 초

## SDK를 설치하세요.

BroadNet은 TypeScript 및 Node.js를 위한 하나의 공식 SDK를 제공합니다: npm install @broadnet/cpaas-sdk axios. 이는 BroadNet OpenAPI 명세에서 생성됩니다. 다른 언어를 사용하는 경우, 평소 사용하는 HTTP 라이브러리로 REST API를 호출하거나 OpenAPI 명세에서 클라이언트를 생성하십시오.

설치

```
npm install @broadnet/cpaas-sdk axios

export BROADNET_TOKEN=your_access_token
```

bash

node >= 18

테스트하기

@broadnet/cpaas-sdk에서 Configuration 및 SMSSMSApi를 임포트합니다. 임포트가 정상적으로 처리되고 타입 체크가 완료되면 발송 준비가 끝납니다.

step 2.broadnet.me

03

3단계 · 60 초

## 첫 메시지를 발송하세요.

기본 URL과 토큰으로 SMSSMSApi를 생성하고, senderId, destinationNumber, message, messageType를 사용하여 smsSendsmsPost를 호출한 뒤 결과를 기록하세요. 응답 본문은 메시지 ID이며, 나중에 전송 결과 보고를 매칭하기 위해 이를 보관해야 합니다.

POST /sms/sendSms

```
// npm install @broadnet/cpaas-sdk axios
import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk";

const sms = new SMSSMSApi(
  new Configuration({
    basePath: "https://api.broadnet.me",
    accessToken: process.env.BROADNET_TOKEN!,
  }),
);

const res = await sms.smsSendsmsPost({
  sMSSmsRequest: {
    senderId: "BroadNet",
    destinationNumber: "447700900123",
    message: "Your verification code is 482913",
    messageType: "TEXT",
  },
});

console.log(res.data); // message ID
```

javascript

200 OK · 메시지 ID

응답 · 200 OK

본문 · 메시지 ID

```
HTTP/1.1 200 OK

2603121407537573731
```

테스트하기

손에 든 휴대폰을 확인하세요. 문자를 받았다면 가장 어려운 단계는 끝난 것입니다. 아래의 과정은 운영을 위한 마무리 단계입니다.

step 3.broadnet.me

04

4단계 · 90 초

## 전송 결과 보고 수신

BroadNet은 계정에 설정된 웹훅 URL로 SUBMITTED, SENT, DELIVERED, (읽음 보고를 지원하는 채널의 경우) READ, 또는 FAILED 및 REJECTED와 같은 전송 상태를 전송합니다. 각 업데이트를 저장하고, 2xx 응답으로 빠르게 회신한 뒤 비동기 방식으로 처리하세요.

POST /webhooks/broadnet

```
import express from "express";

const app = express();

app.post("/webhooks/broadnet", express.json(), async (req, res) => {
  // Store the status update first, then acknowledge with a 2xx.
  // Statuses: SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED.
  await db.statusUpdates.insert({ receivedAt: new Date(), body: req.body });
  res.sendStatus(200);
});
```

javascript

전송 상태 · JSON

DELIVERED

단말기에 수신이 확인되었습니다. SUBMITTED 및 SENT와 같은 이전 상태는 메시지가 네트워크를 통해 이동함에 따라 업데이트됩니다.

전송 완료 후

READ

WhatsApp과 같이 읽음 확인이 가능한 채널에서 수신자가 메시지를 읽었을 때 표시됩니다.

읽음 확인 시

전송 실패 / 거절됨

전송되지 않았습니다. 재전송하기 전에 번호 형식과 발신자 ID를 확인하세요.

최종 상태

테스트하기

휴대전화로 메시지를 보낸 후, 서버 로그에서 DELIVERED 상태 업데이트를 확인하세요.

step 4.broadnet.me

05

5단계 · 5분에 포함되지 않음

## 운영 환경 적용 전.

발신자 신원, 트래픽 목적 및 발신자 ID 승인이 완료되면 운영 환경을 사용할 수 있습니다. 승인까지는 통합 작업과 병행하여 영업일 기준 3~10일이 소요됩니다. 승인 후에는 동일한 코드로 운영 트래픽을 전송할 수 있습니다. 승인 전에는 토큰이 소스 제어 시스템에 노출되지 않도록 주의하고, 전송 결과 보고 웹훅을 설정한 뒤 재시도 정책을 결정하세요.

- 01 보안 정보를 귀하의 환경으로 이동하세요 BROADNET_TOKEN을 환경 변수나 비밀 관리자(secrets manager)에 보관하고, 소스 제어 시스템이나 클라이언트 측 코드에 절대 포함하지 마세요. 유출될 경우 즉시 교체해야 합니다.
- 02 안전한 재시도 및 잔액 확인 네트워크 오류 및 5xx 응답은 지수 백오프(exponential backoff) 방식을 사용하여 재시도하세요. 수락된 모든 발송은 메시지 ID를 반환하므로, 이를 저장하고 무작정 재전송하는 대신 전송 결과 보고를 확인하십시오. 대량 문자 발송 시 모든 응답에는 잔여 크레딧이 포함됩니다.
- 03 SDK 버전 고정 package.json에서 @broadnet/cpaas-sdk를 특정 버전으로 고정하고 신중하게 업그레이드하세요. API 경로는 버전 접두사가 없으므로 변경 로그와 OpenAPI 명세의 변경 사항을 확인하시기 바랍니다.
- 04 상태 코드별 오류 처리 오류 발생 시 HTTP 상태 코드와 status, error, message, errorCode, requestUri를 포함한 ExceptionResponse 본문이 반환됩니다. 400 및 401 오류는 수정하고, 5xx 오류는 지수 백오프(backoff)를 적용하여 재시도하세요.
- 05 재시도 정책 결정 기본 설정: 5xx 및 네트워크 오류 시에는 지수 백오프(exponential backoff)를 적용하며, 4xx 오류에는 적용하지 않습니다. 타임아웃 발생 시 재전송하기 전에 전송 결과 보고를 확인하세요. 첫 번째 요청이 이미 수락되었을 수 있습니다.

테스트하기

아래 체크리스트를 코드에 적용하여 확인하세요. 모든 항목이 체크되면 승인 완료 즉시 운영 환경에 적용할 준비가 된 것입니다.

step 5.broadnet.me

첫날부터 운영 환경에 최적화된 설계

## 동일한 코드 경로가 매일 3억 건 이상의 메시지를 처리합니다.

테스트 트래픽은 가상의 데이터가 아닙니다. 위 단계에서 설정한 모든 요청, 키, 웹훅은 실제 기업용 트래픽이 통과하는 것과 동일한 라우팅, 과금 및 컴플라이언스 스택을 통해 처리되며, 아래 인증 항목에 따라 매년 감사를 받습니다.

ISO 27001

정보 보안

ISO 9001

품질 관리

ISO 22301

비즈니스 연속성

GDPR

EU 데이터 거주성 준수 · 정렬됨

HIPAA

준수 · 요청 시 BAA 제공

SOC 2

Type II · 연간 감사

EU + UAE 데이터 레지던시 99.99% API 가동 시간 SLA 테스트 및 운영을 위한 단일 베이스 URL 전송 상태 웹훅

자주 묻는 질문

## 빠른 시작 질문

Authorization: Bearer 헤더와 senderId, destinationNumber, message, messageType(TEXT 또는 UNICODE)을 포함한 JSON 본문을 담아 POST https://api.broadnet.me/sms/sendSms를 전송하세요. 응답으로 메시지 ID가 반환됩니다. /websmpp 기반의 기존 HTTP API는 SMPP 시대의 통합 환경을 위해 여전히 사용 가능합니다.

/signup에서 테스트 액세스를 신청하세요. BroadNet 엔지니어가 영업일 기준 1일 이내에 테스트 인증 정보(Authorization: Bearer 헤더에 넣어 보내는 액세스 토큰과 테스트 트래픽을 보낼 곳)를 회신해 드립니다. 첫 테스트 메시지는 인증 정보를 받은 후 약 5분 뒤에 보낼 수 있습니다.

공식 SDK는 npm에 공개된 TypeScript 및 Node.js용 @broadnet/cpaas-sdk 하나입니다. 다른 언어에서는 HTTPS로 REST API를 직접 호출하거나 OpenAPI 명세(/developers/openapi.yaml)로 클라이언트를 생성하세요.

찾으시는 질문이 없나요? [엔지니어링 팀에 문의하기](https://www.broadnet.me/ko/contact)

테스트 액세스 · 영업일 기준 1일 이내 답변

## 5단계 아래로. 마지막 단계 하나만 남았습니다

본인의 인증된 번호로 테스트를 진행하고 통합을 완료한 후, 동일한 콘솔에서 운영 트래픽으로 전환하세요. 매일 3억 건 이상의 메시지를 처리하는 것과 동일한 SDK, 동일한 엔드포인트, 동일한 SLA를 제공합니다.

[테스트 계정 신청 (영문 양식)](https://www.broadnet.me/ko/contact?intent=test-access) [전체 API 레퍼런스](https://www.broadnet.me/developers/api)

$ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{ "senderId": "…", "destinationNumber": "…", "message": "…", "messageType": "TEXT" }'