접속 방식 선택
에이전트에는 보통 두 가지가 필요합니다: 계획을 세우기 위한 정보와 실행을 위한 방법입니다. BroadNet은 이 둘을 분리하여 관리합니다. 지식 서버는 계정 없이도 질문에 답할 수 있지만, 메시지 전송에는 항상 토큰이 필요합니다.
본 웹사이트와 동일한 데이터를 기반으로 제공되는 공개 읽기 전용 답변: 커버리지, 발신자 ID 규칙, 예시 요금 목록, 규정, 세그먼트 수, 답변, 고객 사례, 변경 이력 및 상태.
- 인증:
- 없음
- 액세스:
- 읽기 전용 · 13 도구, IP당 분당 60건의 요청
- 추천 대상:
- 계정 생성 전 단계의 기획, 조사 및 프리세일즈 문의
MCP 도구로 노출되는 BroadNet 메시징 API입니다. 에이전트는 제공된 토큰의 권한을 사용하여 메시지를 전송하고 추적합니다.
- 인증:
- Bearer <token>
- 액세스:
- 계정에 적용됨
- 추천 대상:
- 사용자의 요청에 따라 메시지를 전송하며, 사람이 각 전송 건을 확인하는 어시스턴트 및 에이전트입니다.
Bearer 토큰 기반 REST API이며, 채널당 하나의 경로 패밀리로 구성되고 OpenAPI 3.1 사양으로 정의됩니다. 에이전트가 판단하고, 코드가 호출을 수행합니다.
- 인증:
- Bearer <token>
- 액세스:
- 코드가 API를 호출합니다 · OpenAPI 3.1
- 추천 대상:
- 백엔드에서 재시도, 로깅 및 제한을 직접 관리하는 프로덕션 에이전트입니다.
OpenAPI 명세에서 생성된 유일한 공식 SDK인 @broadnet/cpaas-sdk입니다. 다른 언어는 REST API를 호출하거나 클라이언트를 생성합니다.
- 인증:
- Bearer <token>
- 액세스:
- 코드가 API를 호출합니다 · TypeScript / Node.js
- 추천 대상:
- 전체 타입을 포함한 Node.js 에이전트 프레임워크 및 도구 정의.
에이전트 발송 가능 메시지
에이전트가 사용하는 인터페이스에 관계없이 동일한 규칙이 적용됩니다: 등록된 발신자, 수신 동의를 한 수신자, 그리고 채널에 적합한 콘텐츠를 사용해야 합니다.
요청당 메시지 1건 또는 파일 기반의 대량 작업이 가능합니다. 과금은 세그먼트 단위로 이루어지므로, 장문 문자나 비라틴 문자는 비용이 더 많이 발생할 수 있습니다. 전송 전 세그먼트 수를 먼저 확인하세요.
- REST API
POST /sms/sendSms(JSON)POST /sms/sendbulk(장문 문자)- Messaging MCP
- 문자 발송 도구, 예:
post_sms_send
24시간 서비스 창 내에서는 자유 형식 메시지 전송이 가능하며, 창 외에는 승인된 템플릿만 사용 가능합니다. 템플릿은 목록화되어 있으며 이름으로 전송됩니다.
- REST API
POST /whatsapp/message/sendbulk(장문 문자)- Messaging MCP
post_whatsapp_message_sendget_whatsapp_template_listpost_whatsapp_template_send
고객사의 시스템에서 코드를 생성하면, 에이전트가 이를 문자 또는 WhatsApp 인증 템플릿으로 전송합니다. 공개 API에는 별도의 인증 엔드포인트가 없으므로, 코드 확인은 고객사 시스템에서 직접 수행해야 합니다.
- REST API
- 메시지에 인증번호가 포함된
POST /sms/sendSms - Messaging MCP
- 동일한 문자 및 WhatsApp 템플릿 도구
음성 OTP, TTS(text-to-speech) 콜아웃 및 IVR은 담당 계정 팀을 통해 제공됩니다. 공개 OpenAPI 사양과 MCP 도구는 메시징 채널을 지원하며 음성 통화는 지원하지 않습니다. AI 기반 아웃바운드 콜에 대해서는 DialerBee를 참조하세요.
- REST API
- 계정별로 제공
- Messaging MCP
- 음성 도구 없음
실제 예시: 에이전트의 OTP 인증 서비스 출시 계획
사용자가 에이전트에게 UAE로 OTP를 계획해 달라고 요청합니다. 에이전트는 공개 지식 서버의 도구 네 개를 호출합니다. 아래 결과는 에이전트가 사용하는 필드로 요약된 서버의 실제 출력값입니다.
UAE 고객에게 매월 약 50,000건의 인증번호를 발송하려고 합니다. 무엇이 필요하며 비용은 얼마나 들까요?
- 1도구 호출
check_coverageUAE 커버리지는 어떻게 되며, 어떤 통신사가 포함되나요?→{"country":"UAE"}결과 (축약됨){ "country": "UAE", "regulator": "TDRA (Telecommunications and Digital Government Regulatory Authority)", "channels": { "sms": "Live", "otp": "Live", "whatsapp": "Live", "rcs": "Available", "voice": "Live" }, "operators": [ { "name": "Etisalat / e&", "status": "Direct" }, { "name": "du", "status": "Direct" }, { "name": "Virgin Mobile", "status": "Operator-grade" } ] } - 2도구 호출
sender_id_rules그 지역의 발신자 ID 등록 요건은 무엇인가요?→{"country":"ae"}결과 (축약됨){ "typicalLeadTime": "5-7 business days", "requirements": [ { "format": "Alphanumeric (Latin or Arabic), up to 11 chars. AD- prefix mandatory on promotional senders.", "preRegistration": "Required — one sender ID per legal entity per use case" } ], "marketingRules": { "quietHours": "TDRA's spam policy bars marketing text messages between 21:00 and 07:00 GST. Transactional OTP and alerts are 24/7." } } - 3도구 호출
count_sms_segments메시지의 세그먼트 수는 얼마인가요?→{"text":"Your MyShop code is 482913. It expires in 5 minutes. Never share it."}결과 (축약됨){ "encoding": "GSM-7", "units": 68, "segments": 1 } - 4도구 호출
estimate_price예상 요금은 얼마인가요?→{"country":"UAE","channel":"sms","volume":50000}결과 (축약됨){ "country": "UAE", "unitPriceUsd": 0.0123, "unit": "per SMS segment", "estimatedMonthlyUsd": 615, "ratesReviewed": "2026-09-24", "note": "Indicative list rate, excluding taxes and sender-ID fees. Volume pricing available; a written quote confirms per-operator pricing." }
UAE는 통신사 직접 연동(Etisalat / e& · du)을 통해 커버됩니다. 발신자 ID는 TDRA에 사전 등록해야 하며, 통상적으로 5–7 영업일이 소요됩니다. 인증번호 문자는 1 SMS 세그먼트입니다. 세그먼트당 US$0.0123의 예시 리스트 요금을 적용할 경우, 세금과 발신자 ID 수수료를 제외한 50,000개 코드의 월 비용은 약 US$615입니다. 이는 견적서가 아닙니다.
다음 단계: broadnet.me/signup에서 테스트 계정을 신청하세요. 토큰을 받으면 메시징 서버를 통해 귀하의 인증된 번호로 테스트 인증번호 하나를 보낼 수 있습니다. 확인을 위해 해당 메시지를 준비할까요?
매 배포 시 라이브 도구 출력값을 기반으로 생성됨
복사 및 붙여넣기
예시는 가상의 번호만을 사용합니다. 토큰은 환경 변수에서 읽어오십시오. 채팅창이나 커밋된 파일에 절대 붙여넣지 마십시오.
{
"mcpServers": {
"broadnet-knowledge": {
"type": "http",
"url": "https://www.broadnet.me/mcp"
},
"broadnet": {
"type": "http",
"url": "https://mcp.broadnet.me/mcp",
"headers": {
"Authorization": "Bearer ${BROADNET_TOKEN}"
}
}
}
}curl -X POST https://www.broadnet.me/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-06-18" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"estimate_price",
"arguments":{"country":"UAE","channel":"sms","volume":50000}}}'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"
}'
# 200 OK → response body is the message ID, e.g. 2603121407537573731// 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# Send an approved WhatsApp template
curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-F batchId=0 \
-F campaignName=order-updates \
-F destinationNo=447700900123 \
-F messageType=TEMPLATE \
-F templateName=order_update \
-F templateLanguage=en_US \
-F bodyTemplateVariables=INV-400
# 200 OK → the response carries the batchId; per-recipient status
# (SUBMITTED → SENT → DELIVERED → READ) arrives on your webhook.기계 판독 가능 엔트리 포인트
연결 대신 브라우징을 수행하는 에이전트는 일반 파일의 모든 내용을 읽을 수 있습니다. 이 중 어떤 에이전트도 로그인이 필요하지 않습니다.
- llms.txt
/llms.txt에이전트 액세스 및 제약 사항 섹션과 언어별 파일 1개가 포함된 언어 모델용 사이트 인덱스입니다.
- 에이전트 기능
/.well-known/agent-skills/index.json다섯 가지 SKILL.md 런북: 커버리지 및 요금, 발신자 ID 등록, 첫 테스트 문자, 테스트 계정 신청, 그리고 MCP 서버 연결.
- A2A 에이전트 카드
/.well-known/agent-card.json동일한 읽기 전용 지식 도구를 위한 Agent2Agent 카드로, /a2a에서 JSON-RPC로 제공됩니다.
- API 카탈로그
/.well-known/api-catalogOpenAPI 명세, API 문서, MCP 서버 및 상태 페이지를 가리키는 RFC 9727 링크셋입니다.
- MCP 서버 카드
/.well-known/mcp.jsonMCP 서버의 전송 및 인증 방식을 설명하는 서버 카드입니다.
- OpenAPI 3.1
/developers/openapi.yaml전체 REST API 설명: 다운로드하거나 이를 기반으로 타입이 지정된 클라이언트를 생성하세요.
- Markdown 버전
/pricing/sms/uae.md페이지의 깔끔한 Markdown 복사본을 얻으려면 대부분의 페이지 URL 끝에 .md를 추가하거나, Accept: text/markdown을 전송하세요.
- 데이터 파일
/data/coverage.jsonJSON 형식으로 제공되는 모든 시장의 커버리지, 공시 요금 및 규제 정보 (커버리지 및 요금 정보는 CSV 형식).
- JSON 상태
/status/api/v2/summary.jsonStatuspage v2 요약 형식으로 제공되는 웹사이트, API 게이트웨이 및 두 MCP 엔드포인트의 측정된 도달 가능성.
에이전트 준수 규칙
메시지를 발송하는 에이전트는 귀사의 자격 증명을 사용하여 귀사의 브랜드로서 활동합니다. 이러한 규칙을 에이전트의 지침과 도구에 포함하여 구축하세요.
- 콘텐츠 전송 전 수신 동의
수신 동의를 한 수신자에게만 마케팅 메시지를 발송하고, 수신 동의 기록을 보관하세요. sender_id_rules 도구는 각 시장의 수신 동의 규칙을 반환합니다.
- 수신 거부 준수
프로모션 메시지에는 STOP와 같은 시장의 수신 거부 키워드가 포함됩니다. 에이전트는 수신 거부를 신청한 번호로 절대 메시지를 발송하지 않습니다.
- 등록된 발신자 ID만 사용 가능
많은 시장에서 영문·숫자 조합의 발신자 ID 사전 등록을 요구합니다. 에이전트는 임의의 ID가 아닌, 귀하의 계정에서 승인된 발신자 ID만을 사용합니다.
- 방해 금지 시간 준수
여러 국가에서는 야간 마케팅 메시지 발송을 금지합니다. sender_id_rules는 해당 지역의 발송 제한 시간(quiet hours)을 반환하며, OTP 및 알림 메시지는 보통 24시간 내내 허용됩니다.
- SMS 펌핑을 방지하는 OTP 흐름 보호
봇이 수익을 목적으로 특정 번호에 OTP 전송을 유도할 수 있습니다. 번호, IP 및 기기별로 코드 요청 속도를 제한하고, 서비스를 제공하지 않는 목적지는 차단하세요. MyOTP는 이러한 보호 기능을 기본적으로 적용합니다.
- 사람이 모든 발송 건을 확인합니다
특히 다수의 수신자에게 발송하는 도구를 사용하기 전에는 반드시 고객의 요청을 확인해야 하며, 에이전트에게 필요한 도구만 활성화하세요.
- 본인 번호로 테스트하기
테스트 계정으로는 본인의 인증된 번호로만 발송할 수 있습니다. 예시와 안내 문구에 사용된 번호는 가상의 번호입니다.
- 채팅창에 토큰을 노출하지 마세요
토큰은 전송 인증 정보입니다. 토큰을 프롬프트에서 불러오지 말고 환경 변수에서 로드해야 하며, 유출될 경우 즉시 폐기하십시오.
관련 항목
두 서버에 대한 상세 정보: 엔드포인트, 인증, 클라이언트 설정 및 데모
테스트 계정 신청부터 curl 또는 TypeScript SDK를 이용한 첫 문자 발송까지 가능합니다.
모든 채널의 전송 엔드포인트, Bearer 인증 및 오류 형식.
메시지를 중복 발송하지 않고 재시도하는 방법
모든 메시지 텍스트의 인코딩 및 세그먼트 수
음성 및 문서 에이전트를 위한 아랍어 음성-텍스트 변환(STT) 및 비전 모델.
컨택 센터를 위한 다국어 AI 아웃바운드 다이얼러
OTP 사기 작동 방식 및 이를 차단하는 방어책
질문
AI 에이전트가 BroadNet을 통해 문자 및 WhatsApp 메시지를 보낼 수 있나요?
네. BroadNet 토큰으로 메시징 MCP 서버(https://mcp.broadnet.me/mcp)에 연결하거나, 코드에서 REST API(https://api.broadnet.me)를 호출하도록 하세요. 어느 방식이든 에이전트는 토큰의 권한으로 동작하므로, 발송할 때마다 담당자가 확인하도록 하세요.
커버리지나 요금에 대해 문의하려면 계정이 필요한가요?
아니요. https://www.broadnet.me/mcp에 있는 지식 MCP 서버는 공개되어 있으며 읽기 전용입니다. 이 서버는 웹사이트와 동일한 데이터를 기반으로 커버리지, 발신자 ID 규칙, 예시 리스트 가격 및 규정을 반환합니다. 가격은 예시 리스트 요금이며 견적서가 아닙니다.
에이전트가 인증번호를 어떻게 발송하나요?
귀사의 시스템이 인증번호를 생성하면 에이전트가 POST /sms/sendSms를 통해 문자 또는 WhatsApp 인증 템플릿으로 이를 전송합니다. 공개 API에는 별도의 검증 엔드포인트가 없으므로, 인증번호 확인은 귀사의 시스템 내에서 이루어집니다.
에이전트가 음성 통화를 할 수 있나요?
음성 OTP, TTS(text-to-speech) 호출 및 IVR은 BroadNet 계정 팀을 통해 제공됩니다. 이는 공개 OpenAPI 명세나 MCP 도구에는 포함되어 있지 않습니다. DialerBee는 컨택 센터를 위한 BroadNet의 AI 아웃바운드 다이얼러입니다.
토큰은 어떻게 받나요?
/signup에서 테스트 계정을 신청하세요. BroadNet이 영업일 기준 1일 이내에 테스트 인증 정보를 회신해 드립니다. 즉시 발급되는 셀프 서비스 키는 없습니다.
에이전트를 BroadNet에 연결하기
지금 바로 퍼블릭 지식 서버로 시작하세요. 에이전트의 발송 준비가 완료되면 테스트 계정을 신청하세요.