계정 정보를 받고 5분 뒤 첫 테스트 SMS를 보내 보세요.
테스트 계정을 신청하시면 영업일 기준 1일 이내에 테스트 자격 증명을 보내드립니다. 그 후 토큰을 사용하여 TypeScript SDK를 설치하고 다음을 호출하세요. smsSendsmsPost. 테스트 계정을 수령한 후 약 5분 이내에 첫 테스트 메시지가 고객님의 인증된 번호로 전송됩니다. 아래의 모든 샘플은 바로 복사하여 사용할 수 있으며, 5단계에서는 운영 환경 적용 전 확인해야 할 사항을 다룹니다.
첫 메시지 발송까지의 단계별 소요 시간입니다.
- 01
테스트 계정 신청
영업일 기준 1일 이내에 회신드립니다메시징 엔지니어가 테스트 계정 정보를 전달해 드리며, 대상 국가, 발송량 및 사용 사례에 대해 30분간의 상담을 진행합니다.
- 02
첫 테스트 메시지 발송
계정 정보 수령 후 약 5분 이내Quickstart 코드를 사용하여 본인의 인증된 번호로 테스트 문자를 발송하세요. 전송 결과 보고는 웹훅으로 전송됩니다.
- 03
연동
영업일 기준 2–5일코드 샘플과 동일한 엔드포인트를 대상으로 테스트 자격 증명을 사용하여 빌드 및 테스트를 진행하세요. REST 또는 SMPP에서 BroadNet 엔지니어가 함께 지원합니다.
- 04
승인
영업일 기준 3–10일연동 작업과 병행하여 발신자 신원, 트래픽 목적 및 목적지 규칙을 검토하고 각 규제 기관에 발신자 ID 등록을 진행합니다.
- 05
운영
전환일계정에 대한 운영 액세스 및 경로가 활성화되었습니다. 통합 작업이 이미 https://api.broadnet.me을 호출하고 있습니다.
전체 소요 기간: 대부분의 시장에서 신청부터 운영 환경 적용까지 영업일 기준 5–15일이 소요됩니다. 규제 기관의 발신자 ID 승인 기간이 더 긴 경우에는 더 오래 걸릴 수 있습니다.
- 사용자 애플리케이션REST API 또는 SMPP을 통해 전송
- BroadNet 플랫폼각 메시지를 검증, 경로 지정 및 과금
- 통신사의 SMSC통신사 직접 연동
- 가입자 단말기메시지 전송 완료
액세스 토큰을 받으세요.
테스트 계정을 신청하시면 액세스 토큰이 포함된 인증 정보가 제공됩니다. 영업일 기준 1일 이내에 회신드립니다. 토큰을 BROADNET_TOKEN 환경 변수에 저장하고, 모든 호출 시 Authorization: Bearer 헤더에 포함하여 전송하세요. 이 페이지의 모든 예시는 운영 환경의 베이스 URL인 https://api.broadnet.me을 사용합니다.
POST /sms/sendSms을 사용하여 본인의 인증된 번호로 테스트 문자를 발송해 보세요. 응답 본문에 메시지 ID가 포함된 200 OK가 반환되면, 코드를 작성하기 전 토큰이 정상적으로 작동함을 확인할 수 있습니다.
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@broadnet/cpaas-sdk에서 Configuration 및 SMSSMSApi를 임포트합니다. 임포트가 정상적으로 처리되고 타입 체크가 완료되면 발송 준비가 끝납니다.
첫 메시지를 발송하세요.
기본 URL과 토큰으로 SMSSMSApi를 생성하고, senderId, destinationNumber, message, messageType를 사용하여 smsSendsmsPost를 호출한 뒤 결과를 기록하세요. 응답 본문은 메시지 ID이며, 나중에 전송 결과 보고를 매칭하기 위해 이를 보관해야 합니다.
// 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 IDHTTP/1.1 200 OK
2603121407537573731손에 든 휴대폰을 확인하세요. 문자를 받았다면 가장 어려운 단계는 끝난 것입니다. 아래의 과정은 운영을 위한 마무리 단계입니다.
전송 결과 보고 수신
BroadNet은 계정에 설정된 웹훅 URL로 SUBMITTED, SENT, DELIVERED, (읽음 보고를 지원하는 채널의 경우) READ, 또는 FAILED 및 REJECTED와 같은 전송 상태를 전송합니다. 각 업데이트를 저장하고, 2xx 응답으로 빠르게 회신한 뒤 비동기 방식으로 처리하세요.
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);
});단말기에 수신이 확인되었습니다. SUBMITTED 및 SENT와 같은 이전 상태는 메시지가 네트워크를 통해 이동함에 따라 업데이트됩니다.
WhatsApp과 같이 읽음 확인이 가능한 채널에서 수신자가 메시지를 읽었을 때 표시됩니다.
전송되지 않았습니다. 재전송하기 전에 번호 형식과 발신자 ID를 확인하세요.
휴대전화로 메시지를 보낸 후, 서버 로그에서 DELIVERED 상태 업데이트를 확인하세요.
운영 환경 적용 전.
발신자 신원, 트래픽 목적 및 발신자 ID 승인이 완료되면 운영 환경을 사용할 수 있습니다. 승인까지는 통합 작업과 병행하여 영업일 기준 3~10일이 소요됩니다. 승인 후에는 동일한 코드로 운영 트래픽을 전송할 수 있습니다. 승인 전에는 토큰이 소스 제어 시스템에 노출되지 않도록 주의하고, 전송 결과 보고 웹훅을 설정한 뒤 재시도 정책을 결정하세요.
- 01보안 정보를 귀하의 환경으로 이동하세요
BROADNET_TOKEN을 환경 변수나 비밀 관리자(secrets manager)에 보관하고, 소스 제어 시스템이나 클라이언트 측 코드에 절대 포함하지 마세요. 유출될 경우 즉시 교체해야 합니다.
- 02안전한 재시도 및 잔액 확인
네트워크 오류 및 5xx 응답은 지수 백오프(exponential backoff) 방식을 사용하여 재시도하세요. 수락된 모든 발송은 메시지 ID를 반환하므로, 이를 저장하고 무작정 재전송하는 대신 전송 결과 보고를 확인하십시오. 대량 문자 발송 시 모든 응답에는 잔여 크레딧이 포함됩니다.
- 03SDK 버전 고정
package.json에서 @broadnet/cpaas-sdk를 특정 버전으로 고정하고 신중하게 업그레이드하세요. API 경로는 버전 접두사가 없으므로 변경 로그와 OpenAPI 명세의 변경 사항을 확인하시기 바랍니다.
- 04상태 코드별 오류 처리
오류 발생 시 HTTP 상태 코드와 status, error, message, errorCode, requestUri를 포함한 ExceptionResponse 본문이 반환됩니다. 400 및 401 오류는 수정하고, 5xx 오류는 지수 백오프(backoff)를 적용하여 재시도하세요.
- 05재시도 정책 결정
기본 설정: 5xx 및 네트워크 오류 시에는 지수 백오프(exponential backoff)를 적용하며, 4xx 오류에는 적용하지 않습니다. 타임아웃 발생 시 재전송하기 전에 전송 결과 보고를 확인하세요. 첫 번째 요청이 이미 수락되었을 수 있습니다.
아래 체크리스트를 코드에 적용하여 확인하세요. 모든 항목이 체크되면 승인 완료 즉시 운영 환경에 적용할 준비가 된 것입니다.
동일한 코드 경로가 매일 3억 건 이상의 메시지를 처리합니다.
테스트 트래픽은 가상의 데이터가 아닙니다. 위 단계에서 설정한 모든 요청, 키, 웹훅은 실제 기업용 트래픽이 통과하는 것과 동일한 라우팅, 과금 및 컴플라이언스 스택을 통해 처리되며, 아래 인증 항목에 따라 매년 감사를 받습니다.
빠른 시작 질문
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)로 클라이언트를 생성하세요.
찾으시는 질문이 없나요? 엔지니어링 팀에 문의하기
5단계 아래로.
마지막 단계 하나만 남았습니다
본인의 인증된 번호로 테스트를 진행하고 통합을 완료한 후, 동일한 콘솔에서 운영 트래픽으로 전환하세요. 매일 3억 건 이상의 메시지를 처리하는 것과 동일한 SDK, 동일한 엔드포인트, 동일한 SLA를 제공합니다.