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

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

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

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

[테스트 계정 신청 (영문 양식)](https://www.broadnet.me/ko/contact?intent=test-access) MCP 설정 복사

## 접속 방식 선택

에이전트에는 보통 두 가지가 필요합니다: 계획을 세우기 위한 정보와 실행을 위한 방법입니다. 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_send` `get_whatsapp_template_list` `post_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. 1 도구 호출 `check_coverage` UAE 커버리지는 어떻게 되며, 어떤 통신사가 포함되나요? → `{"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. 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. 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. 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}"
      }
    }
  }
}
```

필드 이름은 클라이언트마다 약간씩 다릅니다(일부 클라이언트는 타입을 "streamable-http"로 기대하며, 일부는 별도의 설정에서 헤더를 읽습니다). 아직 토큰이 없는 경우 지식(knowledge) 항목만 추가하십시오.

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시간 서비스 창구 외에도 작동하지만, 자유 형식의 텍스트는 활성화된 서비스 창구가 필요합니다.

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

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

- [llms.txt `/llms.txt` 에이전트 액세스 및 제약 사항 섹션과 언어별 파일 1개가 포함된 언어 모델용 사이트 인덱스입니다.](https://www.broadnet.me/llms.txt)
- [에이전트 기능 `/.well-known/agent-skills/index.json` 다섯 가지 SKILL.md 런북: 커버리지 및 요금, 발신자 ID 등록, 첫 테스트 문자, 테스트 계정 신청, 그리고 MCP 서버 연결.](https://www.broadnet.me/.well-known/agent-skills/index.json)
- [A2A 에이전트 카드 `/.well-known/agent-card.json` 동일한 읽기 전용 지식 도구를 위한 Agent2Agent 카드로, /a2a에서 JSON-RPC로 제공됩니다.](https://www.broadnet.me/.well-known/agent-card.json)
- [API 카탈로그 `/.well-known/api-catalog` OpenAPI 명세, API 문서, MCP 서버 및 상태 페이지를 가리키는 RFC 9727 링크셋입니다.](https://www.broadnet.me/.well-known/api-catalog)
- [MCP 서버 카드 `/.well-known/mcp.json` MCP 서버의 전송 및 인증 방식을 설명하는 서버 카드입니다.](https://www.broadnet.me/.well-known/mcp.json)
- [OpenAPI 3.1 `/developers/openapi.yaml` 전체 REST API 설명: 다운로드하거나 이를 기반으로 타입이 지정된 클라이언트를 생성하세요.](https://www.broadnet.me/developers/openapi.yaml)
- [Markdown 버전 `/pricing/sms/uae.md` 페이지의 깔끔한 Markdown 복사본을 얻으려면 대부분의 페이지 URL 끝에 .md를 추가하거나, Accept: text/markdown을 전송하세요.](https://www.broadnet.me/pricing/sms/uae.md)
- [데이터 파일 `/data/coverage.json` JSON 형식으로 제공되는 모든 시장의 커버리지, 공시 요금 및 규제 정보 (커버리지 및 요금 정보는 CSV 형식).](https://www.broadnet.me/data/coverage.json)
- [JSON 상태 `/status/api/v2/summary.json` Statuspage v2 요약 형식으로 제공되는 웹사이트, API 게이트웨이 및 두 MCP 엔드포인트의 측정된 도달 가능성.](https://www.broadnet.me/status/api/v2/summary.json)

## 에이전트 준수 규칙

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

- 콘텐츠 전송 전 수신 동의 수신 동의를 한 수신자에게만 마케팅 메시지를 발송하고, 수신 동의 기록을 보관하세요. sender_id_rules 도구는 각 시장의 수신 동의 규칙을 반환합니다.
- 수신 거부 준수 프로모션 메시지에는 STOP와 같은 시장의 수신 거부 키워드가 포함됩니다. 에이전트는 수신 거부를 신청한 번호로 절대 메시지를 발송하지 않습니다.
- 등록된 발신자 ID만 사용 가능 많은 시장에서 영문·숫자 조합의 발신자 ID 사전 등록을 요구합니다. 에이전트는 임의의 ID가 아닌, 귀하의 계정에서 승인된 발신자 ID만을 사용합니다.
- 방해 금지 시간 준수 여러 국가에서는 야간 마케팅 메시지 발송을 금지합니다. sender_id_rules는 해당 지역의 발송 제한 시간(quiet hours)을 반환하며, OTP 및 알림 메시지는 보통 24시간 내내 허용됩니다.
- SMS 펌핑을 방지하는 OTP 흐름 보호 봇이 수익을 목적으로 특정 번호에 OTP 전송을 유도할 수 있습니다. 번호, IP 및 기기별로 코드 요청 속도를 제한하고, 서비스를 제공하지 않는 목적지는 차단하세요. MyOTP는 이러한 보호 기능을 기본적으로 적용합니다.
- 사람이 모든 발송 건을 확인합니다 특히 다수의 수신자에게 발송하는 도구를 사용하기 전에는 반드시 고객의 요청을 확인해야 하며, 에이전트에게 필요한 도구만 활성화하세요.
- 본인 번호로 테스트하기 테스트 계정으로는 본인의 인증된 번호로만 발송할 수 있습니다. 예시와 안내 문구에 사용된 번호는 가상의 번호입니다.
- 채팅창에 토큰을 노출하지 마세요 토큰은 전송 인증 정보입니다. 토큰을 프롬프트에서 불러오지 말고 환경 변수에서 로드해야 하며, 유출될 경우 즉시 폐기하십시오.

## 관련 항목

[MCP 서버 두 서버에 대한 상세 정보: 엔드포인트, 인증, 클라이언트 설정 및 데모](https://www.broadnet.me/ko/developers/mcp) [빠른 시작 테스트 계정 신청부터 curl 또는 TypeScript SDK를 이용한 첫 문자 발송까지 가능합니다.](https://www.broadnet.me/ko/developers/quickstart) [API 레퍼런스 모든 채널의 전송 엔드포인트, Bearer 인증 및 오류 형식.](https://www.broadnet.me/developers/api) [안전한 재시도 메시지를 중복 발송하지 않고 재시도하는 방법](https://www.broadnet.me/developers/idempotency) [SMS 세그먼트 카운터 모든 메시지 텍스트의 인코딩 및 세그먼트 수](https://www.broadnet.me/developers/sms-counter) [BroadNet 추론 음성 및 문서 에이전트를 위한 아랍어 음성-텍스트 변환(STT) 및 비전 모델.](https://www.broadnet.me/ko/products/inference) [DialerBee 컨택 센터를 위한 다국어 AI 아웃바운드 다이얼러](https://www.broadnet.me/ko/dialerbee) [SMS 펌핑은 무엇인가요? OTP 사기 작동 방식 및 이를 차단하는 방어책](https://www.broadnet.me/ko/answers/what-is-sms-pumping)

## 질문

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

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

[테스트 계정 신청 (영문 양식)](https://www.broadnet.me/ko/contact?intent=test-access) [MCP 서버 가이드](https://www.broadnet.me/ko/developers/mcp)