# BroadNet 메시징 API: REST, SMPP 및 TypeScript SDK

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

개발자 허브 · v2026.05

엔지니어를 위해 설계되었습니다. 먼저 테스트하고, 바로 배포하세요.

BroadNet의 메시징 API는 Bearer-token REST API 및 SMPP 3.4를 지원하며, 공식 TypeScript SDK, OpenAPI 3.1 사양 및 AI 에이전트를 위한 MCP 서버를 제공합니다. 매일 3억 개 이상의 메시지를 처리하는 바로 그 플랫폼이 귀사의 `npm install` 시스템과 연결됩니다.

[테스트 계정 신청 (영문 양식)](https://www.broadnet.me/ko/contact?intent=test-access) [퀵스타트 가이드 읽기](https://www.broadnet.me/ko/developers/quickstart) [API 레퍼런스](https://www.broadnet.me/developers/api)

요청 시 테스트 계정 제공 영업일 기준 1일 이내에 회신드립니다 SOC 2, ISO 27001

![BroadNet 개발자 메시징 API의 시네마틱 시각화](https://www.broadnet.me/marketing/generated/viz-sms-api.png)

BroadNet · 개발자 API

api.broadnet.me

REST + SMPP

프로토콜

8

채널

일일 3억 건 이상

메시지

대화형

## API 체험하기

가입 없이 바로 요청을 입력하고 전송을 눌러 시뮬레이션된 응답 및 전송 흐름을 확인하세요 —

POST api.broadnet.me/sms/sendSms

요청

`Authorization: Bearer $BROADNET_TOKEN`

request.sh

```
curl -X POST https://api.broadnet.me/sms/sendSms \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
      "senderId": "BroadNet",
      "destinationNumber": "447700900123",
      "message": "Your verification code is 482913",
      "messageType": "TEXT"
    }'
```

응답

응답 예시 — 메시지가 전송되지 않음

요청 사항을 입력하고 테스트 계정 신청을 클릭하여 응답 예시를 확인하세요.

브라우저에서 완전히 실행됩니다. 이 페이지를 벗어나는 요청은 없으며 문자가 발송되지도 않습니다.

[Request test access](https://www.broadnet.me/ko/contact?intent=test-access) [전체 API 레퍼런스](https://www.broadnet.me/developers/api)

단 하나의 API로 모든 채널을

8

문자 · WhatsApp · RCS · Telegram · Email · Push · Messenger · Instagram

API 가동 시간 SLA

99.99%

운영 API 엔드포인트 기준 계약 보장

p99 API 지연 시간

<350ms

사용자 지역에서 /sms/sendSms까지

OpenAPI 명세

3.1

329개 경로 · 376개 작업 · 다운로드 가능

공식 SDK

## TypeScript SDK 또는 모든 언어.

TypeScript 및 Node.js를 위한 단일 공식 SDK를 제공합니다. 그 외 모든 환경에서는 표준 HTTPS를 사용합니다. REST API를 직접 호출하거나 명세를 통해 클라이언트를 생성하세요.

[TypeScript / Node.js BroadNet OpenAPI 명세에서 생성되어 전체 타입 정의가 포함된 공식 SDK, @broadnet/cpaas-sdk입니다. `npm install @broadnet/cpaas-sdk axios` npm에서 보기](https://www.npmjs.com/package/@broadnet/cpaas-sdk)

[OpenAPI를 통한 모든 언어 지원 어떤 언어로든 REST API를 호출하거나, openapi-generator를 사용하여 OpenAPI 3.1 명세 기반의 타입 정의된 클라이언트를 생성할 수 있습니다. openapi.yaml 다운로드](https://www.broadnet.me/developers/openapi.yaml)

[MCP 서버 사용자의 BroadNet 토큰을 사용하여 Model Context Protocol을 통해 AI 에이전트를 BroadNet에 연결하세요. MCP 설정](https://www.broadnet.me/ko/developers/mcp)

문서

## 불필요한 기능 없이 필요한 모든 것을 제공합니다.

사용 사례별로 최적화된 6개의 진입점을 제공합니다. 각 진입점은 200개의 탭이 나열된 복잡한 구조가 아닌 집중된 페이지로 연결됩니다.

[빠른 시작 토큰을 발급받고 TypeScript SDK를 설치하거나 curl을 사용하여 첫 문자를 발송하세요. 열기](https://www.broadnet.me/ko/developers/quickstart)

[API 레퍼런스 Bearer 인증, 발송, 대량 발송, 번호 조회, 오류 및 모든 채널의 발송 엔드포인트. 열기](https://www.broadnet.me/developers/api)

[OpenAPI 명세 OpenAPI 3.1: 8개 채널에 걸쳐 329개의 경로와 376개의 오퍼레이션을 지원합니다. 다운로드하거나 클라이언트를 생성하세요. 열기](https://www.broadnet.me/developers/openapi)

[MCP 서버 Model Context Protocol을 통해 AI 에이전트를 BroadNet에 연결하세요. 열기](https://www.broadnet.me/ko/developers/mcp)

[SMPP 3.4 지속적인 대량 워크로드를 위한 직접 SMPP 바인딩. 테스트 계정 신청 시 호스트와 포트 정보가 제공됩니다. 열기](https://www.broadnet.me/developers/smpp)

[웹훅 전송 상태가 계정의 웹훅 URL로 푸시되며, 상태 확인을 위한 엔드포인트도 제공됩니다. 열기](https://www.broadnet.me/developers/webhooks)

[다른 문자 제공업체에서 전환하시겠습니까? 마이그레이션 가이드는 현재의 발송, 전송 결과 보고 및 웹훅 호출을 BroadNet API로 매핑하며, 발신자 ID, 병행 운영, 트래픽 증대 및 롤백 과정을 다룹니다. 마이그레이션 가이드 읽기](https://www.broadnet.me/developers/migrate)

변경 사항 및 시점

OpenAPI 스펙, SDK, MCP 서버, 문서 및 개발 도구의 날짜별 변경 사항입니다.

[변경 이력 보기](https://www.broadnet.me/developers/changelog) [Atom 피드](https://www.broadnet.me/changelog.xml)

공통 레시피

## 첫날 바로 시작할 수 있는 5가지 단계

의사 코드가 아닌 실제 코드입니다. 복사, 붙여넣기, 수신자 변경 후 바로 발송하세요.

### 문자 발송

POST /sms/sendSms에 HTTPS 호출 한 번이면 메시지 ID가 반환됩니다. messageType을 TEXT 또는 UNICODE로 설정하면 전송 결과 보고가 웹훅으로 전송됩니다.

[SMS API](https://www.broadnet.me/ko/products/sms-api)

sms.ts

```
// 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
```

데모 보기

## 화면으로 보는 플랫폼

BroadNet 메시징 콘솔의 간략한 가이드 — 로그인, 발송 및 측정까지. API가 구동하는 것과 동일한 플랫폼입니다.

[로그인 및 비밀번호 재설정 로그인 및 비밀번호 재설정](https://www.youtube.com/watch?v=i851uzE5gMI)

[단일 메시지 발송 단일 메시지 발송](https://www.youtube.com/watch?v=TIG0n1C9ecE)

[전송 결과 보고 확인 전송 결과 보고 확인](https://www.youtube.com/watch?v=op5OjCrAlIQ)

커뮤니티 및 지원

## 전문 엔지니어가 즉각 응답합니다.

npm에 등록된 공식 TypeScript SDK입니다. 공개 OpenAPI 사양과 Postman 컬렉션을 제공합니다. 단순한 1차 지원 스크립트 대기열이 아닌, 직접 경로를 관리하는 전문 지원 팀이 함께합니다.

[npm 전체 타입 정의가 포함된 공식 TypeScript/Node.js SDK입니다. npm과 axios로 설치하세요. npmjs.com/package/@broadnet/cpaas-sdk](https://www.npmjs.com/package/@broadnet/cpaas-sdk)

[Postman 필수 호출 모음 또는 모든 작업에 대한 OpenAPI 사양 가져오기. 컬렉션 가져오기](https://www.broadnet.me/developers/postman)

[지원 운영 계정을 위한 24/7 엔지니어링 지원. P1 이슈 발생 시 15분 이내 응답. developers@broadnet.me](mailto:developers@broadnet.me)

요청부터 운영까지

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

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 승인 기간이 더 긴 경우에는 더 오래 걸릴 수 있습니다.

자주 묻는 질문

## 개발자 질문

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

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

Postman이 OpenAPI 명세로 컬렉션을 만듭니다. /developers/openapi.yaml (OpenAPI 3.1)을 임포트하면 모든 BroadNet 엔드포인트가 담긴 컬렉션이 생성되며, 그다음 액세스 토큰을 Bearer 컬렉션 변수로 추가하세요.

/status 상태 페이지에서 5분마다 합성 점검으로 측정한 웹사이트 및 공개 API 접속 가능 여부와 장애 기록을 확인할 수 있으며, 업데이트는 /status/rss.xml RSS 피드로 받아볼 수 있습니다. 운영 환경 API 엔드포인트에는 99.99% 가동 시간 SLA가 적용됩니다.

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

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

## 테스트 계정 신청

본인의 인증된 번호로 테스트 메시지를 발송해 보세요. 운영 환경 적용 전, 당사는 발신자 신원, 트래픽 목적 및 목적지 요구 사항을 검토합니다. 대부분의 팀은 영업일 기준 5~15일 이내에 서비스를 시작할 수 있습니다.

[테스트 계정 신청 (영문 양식)](https://www.broadnet.me/ko/contact?intent=test-access) [기술팀 문의](https://www.broadnet.me/ko/contact)

$ npm install @broadnet/cpaas-sdk axios · 몇 분 안에 첫 문자 발송