BroadNet
운영 BroadNet 답변

API를 통해 문자를 어떻게 발송하나요?

최종 검토일 1 분 소요BroadNet 엔지니어링 검토 완료
빠른 답변

HTTP API를 통해 SMS를 발송한다는 것은 목적지 번호, 발신자 ID 및 메시지 텍스트를 REST 엔드포인트로 전달하는 것을 의미하며, 해당 엔드포인트는 메시지를 통신사 네트워크로 전달하고 전송 상태를 추적할 수 있는 메시지 ID를 반환합니다.

쉬운 용어 정의벤더 중립적검토일 2026년 9월 24일
다이어그램A2P 메시지가 휴대폰에 도달하는 방식
  1. 사용자 애플리케이션REST API 또는 SMPP을 통해 전송
  2. BroadNet 플랫폼각 메시지를 검증, 경로 지정 및 과금
  3. 통신사의 SMSC통신사 직접 연동
  4. 가입자 단말기메시지 전송 완료
전송 결과 보고(DLR)가 동일한 경로를 통해 웹훅으로 전달됩니다
상세 답변

알아야 할 모든 정보, 불필요한 정보는 없습니다.

§01

요청

BroadNet 게이트웨이는 Authorization: Bearer 토큰과 JSON 본문을 포함한 POST 요청을 https://api.broadnet.me/sms/sendSms로 수신합니다. 본문 구성은 senderId(발신자 ID), destinationNumber(국제 형식의 수신번호, 숫자만 입력, + 기호 제외), message(메시지 내용), messageType(GSM-7의 경우 TEXT, 아랍어·이모지 및 기타 비라틴 문자의 경우 UNICODE)입니다. 호출이 성공하면 응답 본문에 메시지 ID와 함께 200 OK가 반환됩니다.

§02

인코딩 및 길이

GSM-7 메시지는 세그먼트당 160자(메시지가 여러 세그먼트로 나뉠 경우 153자)까지 수용 가능합니다. 이모지나 비라틴 문자를 위해 Unicode로 전환하면 70자(장문 문자 시 67자)로 줄어듭니다. 일반 GSM-7의 경우 messageType을 TEXT로, 본문에 Unicode 또는 아랍어가 필요한 경우 UNICODE로 설정하여 문자가 깨지지 않도록 하세요. POST /sms/identify은 발송 전 인코딩 및 세그먼트 수를 반환합니다.

§03

전송 결과를 추측하지 말고 추적하세요

반환된 메시지 ID는 전송 결과 보고(DLR)를 확인하기 위한 핸들입니다. 메시지 제출 시 200 응답을 받는 것을 단말기 수신 증거로 간주하지 마십시오. 웹훅을 설정하여 통신사의 최종 상태(전송 성공, 실패 또는 만료)를 수신하세요.

§04

운영 환경 전환

국제 E.164 번호를 사용하고, 규모를 확장하기 전에 각 대상 국가에 발신자 ID를 등록하며, 일관된 지연 시간을 위해 통신사 직접 연동 경로를 통해 메시지를 발송하세요. 대량 발송 시 동일한 계정으로 SMPP뿐만 아니라 REST를 통해서도 접속할 수 있으므로, HTTP로 시작하여 재등록 절차 없이 바인딩 유형을 전환할 수 있습니다.

BNBroadNet 엔지니어링 팀 작성·2003년부터 통신사급 메시징 서비스 운영, 본사는 두바이에 위치·편집 표준
FAQ

자주 묻는 질문

GET 요청으로 SMS를 보낼 수 있나요, 아니면 POST가 필요한가요?
POST 방식을 사용하세요. REST 엔드포인트 POST /sms/sendSms은 JSON 바디와 Bearer 토큰을 사용하므로, 메시지 텍스트와 인증 정보가 URL이나 서버 로그에 노출되지 않습니다. 기존 SMPP 시대의 통합을 위해 레거시 HTTP API (/websmpp/websms)은 여전히 GET 방식을 지원하지만, 신규 통합 시에는 REST API를 사용해야 합니다.
SMPP가 필요한가요, 아니면 HTTP API로 충분한가요?
대부분의 물량에는 REST/HTTP API로 충분하며 통합 속도가 가장 빠릅니다. SMPP는 매우 높은 지속 처리량과 지속적인 바인딩에 적합합니다. 동일한 BroadNet 계정으로 두 방식 모두 사용할 수 있으므로, 재등록 없이 HTTP로 시작하여 나중에 SMPP를 추가할 수 있습니다.
메시지가 실제로 전송되었는지 어떻게 확인하나요?
제출 시 메시지 ID가 반환되며, 최종 단말기 상태는 웹훅(webhook)을 통해 전송 결과 보고(DLR) 형식으로 비동기적으로 전달됩니다 — 전송 완료, 실패 또는 만료. 제출 응답을 전송 성공의 증거로 간주하지 마십시오.
이 기능으로 구축하기

연동에 도움이 필요하신가요?

아래 페이지들은 이 개념을 실제 서비스로 구현하는 제품 및 연동 가이드입니다. 실시간 상담을 원하신다면, 중동·북아프리카 영업시간 중 당일에도 저희 엔지니어링 팀과 통화가 가능합니다.

엔지니어링 팀 문의
피드백

이 답변이 도움이 되었나요?

여러분의 투표는 예시, 다이어그램, 코드 스니펫을 통해 어떤 답변을 더 확장할지 우선순위를 정하는 데 도움이 됩니다.

이 답변이 도움이 되었나요?
감사합니다. 확인되었습니다. 해당 답변을 계속 유지하겠습니다.
확인했습니다. 부족했던 점을 — 간단히 남겨주세요.

콘텐츠 작성 및 검토 방식

도움이 더 필요하신가요?

귀사의 구축 프로젝트에 대해 실제 엔지니어와 상담하세요.

영업일 기준 1일 이내에 회신드립니다. 운영 계정은 24/7 지원을 받으실 수 있습니다. BroadNet의 솔루션 엔지니어는 단순한 스크립트가 아닌 실제 작동하는 코드를 제공합니다.

$ curl -X POST https://api.broadnet.me/sms/sendSms
응답 SLA
테스트 계정 신청영업일 기준 1일 이내에 회신드립니다
운영 환경24 / 7 · < 15 min
통신사 NOC24 / 7 · 페이저