BroadNet
AI 에이전트용·/developers/ai-agents

AI 에이전트를 위한 메시징 및 음성 서비스.

AI 에이전트에게 커버리지, 규칙, 가격을 조회하고 귀사의 BroadNet 계정으로 문자, WhatsApp 및 일회용 비밀번호를 전송할 수 있는 안전한 방법을 제공하세요. 귀사의 스택에 적합한 방식(두 개의 MCP 서버, REST API, TypeScript SDK 또는 일반 머신 리더블 파일)을 선택하여 사용하십시오.

접속 방식 선택

에이전트에는 보통 두 가지가 필요합니다: 계획을 세우기 위한 정보와 실행을 위한 방법입니다. BroadNet은 이 둘을 분리하여 관리합니다. 지식 서버는 계정 없이도 질문에 답할 수 있지만, 메시지 전송에는 항상 토큰이 필요합니다.

지식 MCP 서버

본 웹사이트와 동일한 데이터를 기반으로 제공되는 공개 읽기 전용 답변: 커버리지, 발신자 ID 규칙, 예시 요금 목록, 규정, 세그먼트 수, 답변, 고객 사례, 변경 이력 및 상태.

https://www.broadnet.me/mcp
인증:
없음
액세스:
읽기 전용 · 13 도구, IP당 분당 60건의 요청
추천 대상:
계정 생성 전 단계의 기획, 조사 및 프리세일즈 문의
메시징 MCP 서버

MCP 도구로 노출되는 BroadNet 메시징 API입니다. 에이전트는 제공된 토큰의 권한을 사용하여 메시지를 전송하고 추적합니다.

https://mcp.broadnet.me/mcp
인증:
Bearer <token>
액세스:
계정에 적용됨
추천 대상:
사용자의 요청에 따라 메시지를 전송하며, 사람이 각 전송 건을 확인하는 어시스턴트 및 에이전트입니다.
REST API

Bearer 토큰 기반 REST API이며, 채널당 하나의 경로 패밀리로 구성되고 OpenAPI 3.1 사양으로 정의됩니다. 에이전트가 판단하고, 코드가 호출을 수행합니다.

https://api.broadnet.me
인증:
Bearer <token>
액세스:
코드가 API를 호출합니다 · OpenAPI 3.1
추천 대상:
백엔드에서 재시도, 로깅 및 제한을 직접 관리하는 프로덕션 에이전트입니다.
TypeScript SDK

OpenAPI 명세에서 생성된 유일한 공식 SDK인 @broadnet/cpaas-sdk입니다. 다른 언어는 REST API를 호출하거나 클라이언트를 생성합니다.

npm i @broadnet/cpaas-sdk
인증:
Bearer <token>
액세스:
코드가 API를 호출합니다 · TypeScript / Node.js
추천 대상:
전체 타입을 포함한 Node.js 에이전트 프레임워크 및 도구 정의.

에이전트 발송 가능 메시지

에이전트가 사용하는 인터페이스에 관계없이 동일한 규칙이 적용됩니다: 등록된 발신자, 수신 동의를 한 수신자, 그리고 채널에 적합한 콘텐츠를 사용해야 합니다.

SMS

요청당 메시지 1건 또는 파일 기반의 대량 작업이 가능합니다. 과금은 세그먼트 단위로 이루어지므로, 장문 문자나 비라틴 문자는 비용이 더 많이 발생할 수 있습니다. 전송 전 세그먼트 수를 먼저 확인하세요.

REST API
POST /sms/sendSms (JSON) POST /sms/sendbulk (장문 문자)
Messaging MCP
문자 발송 도구, 예: post_sms_send
WhatsApp

24시간 서비스 창 내에서는 자유 형식 메시지 전송이 가능하며, 창 외에는 승인된 템플릿만 사용 가능합니다. 템플릿은 목록화되어 있으며 이름으로 전송됩니다.

REST API
POST /whatsapp/message/sendbulk (장문 문자)
Messaging MCP
post_whatsapp_message_sendget_whatsapp_template_listpost_whatsapp_template_send
OTP

고객사의 시스템에서 코드를 생성하면, 에이전트가 이를 문자 또는 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에서 테스트 계정을 신청하세요. 토큰을 받으면 메시징 서버를 통해 귀하의 인증된 번호로 테스트 인증번호 하나를 보낼 수 있습니다. 확인을 위해 해당 메시지를 준비할까요?

매 배포 시 라이브 도구 출력값을 기반으로 생성됨

복사 및 붙여넣기

예시는 가상의 번호만을 사용합니다. 토큰은 환경 변수에서 읽어오십시오. 채팅창이나 커밋된 파일에 절대 붙여넣지 마십시오.

mcp.json — 양쪽 서버 모두
{
  "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}"
      }
    }
  }
}
tools/call estimate_price (knowledge 서버)
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}}}'
문자 1건 발송 (REST API)
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
HTTP 200 응답 시 메시지 ID가 반환됩니다. API에는 멱등성 헤더가 없습니다. 네트워크 오류 또는 5xx 오류 발생 시, 다시 발송하기 전에 ID를 통해 메시지 상태를 확인하십시오.
TypeScript SDK를 사용하여 동일하게 발송
// 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
승인된 WhatsApp 템플릿 발송 (REST API)
# 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.
템플릿은 24시간 서비스 창구 외에도 작동하지만, 자유 형식의 텍스트는 활성화된 서비스 창구가 필요합니다.

기계 판독 가능 엔트리 포인트

연결 대신 브라우징을 수행하는 에이전트는 일반 파일의 모든 내용을 읽을 수 있습니다. 이 중 어떤 에이전트도 로그인이 필요하지 않습니다.

에이전트 준수 규칙

메시지를 발송하는 에이전트는 귀사의 자격 증명을 사용하여 귀사의 브랜드로서 활동합니다. 이러한 규칙을 에이전트의 지침과 도구에 포함하여 구축하세요.

  • 콘텐츠 전송 전 수신 동의

    수신 동의를 한 수신자에게만 마케팅 메시지를 발송하고, 수신 동의 기록을 보관하세요. sender_id_rules 도구는 각 시장의 수신 동의 규칙을 반환합니다.

  • 수신 거부 준수

    프로모션 메시지에는 STOP와 같은 시장의 수신 거부 키워드가 포함됩니다. 에이전트는 수신 거부를 신청한 번호로 절대 메시지를 발송하지 않습니다.

  • 등록된 발신자 ID만 사용 가능

    많은 시장에서 영문·숫자 조합의 발신자 ID 사전 등록을 요구합니다. 에이전트는 임의의 ID가 아닌, 귀하의 계정에서 승인된 발신자 ID만을 사용합니다.

  • 방해 금지 시간 준수

    여러 국가에서는 야간 마케팅 메시지 발송을 금지합니다. sender_id_rules는 해당 지역의 발송 제한 시간(quiet hours)을 반환하며, OTP 및 알림 메시지는 보통 24시간 내내 허용됩니다.

  • SMS 펌핑을 방지하는 OTP 흐름 보호

    봇이 수익을 목적으로 특정 번호에 OTP 전송을 유도할 수 있습니다. 번호, IP 및 기기별로 코드 요청 속도를 제한하고, 서비스를 제공하지 않는 목적지는 차단하세요. MyOTP는 이러한 보호 기능을 기본적으로 적용합니다.

  • 사람이 모든 발송 건을 확인합니다

    특히 다수의 수신자에게 발송하는 도구를 사용하기 전에는 반드시 고객의 요청을 확인해야 하며, 에이전트에게 필요한 도구만 활성화하세요.

  • 본인 번호로 테스트하기

    테스트 계정으로는 본인의 인증된 번호로만 발송할 수 있습니다. 예시와 안내 문구에 사용된 번호는 가상의 번호입니다.

  • 채팅창에 토큰을 노출하지 마세요

    토큰은 전송 인증 정보입니다. 토큰을 프롬프트에서 불러오지 말고 환경 변수에서 로드해야 하며, 유출될 경우 즉시 폐기하십시오.

관련 항목

질문

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에 연결하기

지금 바로 퍼블릭 지식 서버로 시작하세요. 에이전트의 발송 준비가 완료되면 테스트 계정을 신청하세요.