# AIエージェント向けのメッセージングと音声。

- 正規URL: https://www.broadnet.me/ja/developers/ai-agents
- 言語: ja
- 最終更新日: 2026-10-21
- 発行者: BroadNet (https://www.broadnet.me)
- レンダリングされたページから生成した、上記ページのMarkdown版です。

AIエージェント向け· /developers/ai-agents

AIエージェントに、対応国・地域、ルール、価格の照会、および貴社のBroadNetアカウントによるSMS、WhatsApp、ワンタイムパスワードの送信を安全に行う手段を提供します。貴社のスタックに適したインターフェースを選択してください：2つのMCPサーバー、REST API、TypeScript SDK、またはプレーンなマシン読み取り可能ファイル。

[テストアクセスを申し込む（英語フォーム）](https://www.broadnet.me/ja/contact?intent=test-access) MCP設定をコピー

## 接続方法の選択

エージェントには通常、計画のための事実と、実行するための手段の2つが必要です。BroadNetはこれらを分離して管理します。ナレッジサーバーはアカウントなしで質問に回答しますが、送信には常にトークンが必要です。

ナレッジMCPサーバー

本ウェブサイトと同じデータに基づく、公開・閲覧専用の回答：対応国・地域、送信元IDのルール、参考価格、規制、セグメント数、回答、導入事例、変更履歴、およびステータス。

https://www.broadnet.me/mcp

**認証:**

なし

**アクセス:**

読み取り専用 · 13ツール、IPあたりの1分間リクエスト数 60

**対象:**

アカウント開設前の、計画、調査、およびプリセールスに関するお問い合わせ。

メッセージングMCPサーバー

MCPツールとして公開されるBroadNetメッセージングAPI。エージェントは、付与されたトークンの権限に基づき、メッセージの送信および追跡を行います。

https://mcp.broadnet.me/mcp

**認証:**

Bearer <token>

**アクセス:**

アカウントへの影響

**対象:**

ユーザーのリクエストに応じて送信し、人が各送信を確認するアシスタントおよびエージェント。

REST API

BearerトークンによるREST。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リクエストにつき1メッセージ、またはファイルによる一斉送信が可能です。料金はセグメント単位で発生するため、長いテキストや非ラテン文字のテキストはコストが高くなります。事前にセグメント数を確認してください。

**REST API**

`POST /sms/sendSms` （JSON） `POST /sms/sendbulk` （連結SMS）

**Messaging MCP**

SMS送信ツール（例： `post_sms_send` ）

WhatsApp

24時間のサービスウィンドウ内では自由形式のメッセージが可能ですが、ウィンドウ外では承認済みテンプレートのみとなります。テンプレートはリスト化されており、名前を指定して送信します。

**REST API**

`POST /whatsapp/message/sendbulk` （連結SMS）

**Messaging MCP**

`post_whatsapp_message_send` 、 `get_whatsapp_template_list` 、 `post_whatsapp_template_send`

OTP

お客様のシステムがコードを生成し、エージェントがそれをSMSまたはWhatsApp認証テンプレートで送信します。公開されているAPIには個別の検証エンドポイントがないため、コードの検証はお客様のシステム内で行う必要があります。

**REST API**

メッセージ内にコードを含む `POST /sms/sendSms`

**Messaging MCP**

同じSMSおよびWhatsAppテンプレートツール

音声

音声OTP、テキスト読み上げによるコールアウト、およびIVRは、アカウントチームを通じてプロビジョニングされます。公開されているOpenAPI仕様およびMCPツールはメッセージングチャネルを対象としており、音声通話は対象外です。AIによるアウトバウンドコールについては、DialerBeeをご参照ください。

**REST API**

アカウントごとにプロビジョニング

**Messaging MCP**

音声ツールなし

## 活用事例：エージェントによるOTPのローンチ計画

ユーザーがエージェントに対し、UAEへのワンタイムパスワード送信の計画を依頼します。エージェントは公開ナレッジサーバー上の4つのツールを呼び出します。以下の結果は、エージェントが使用するフィールドのみを抽出した、サーバーの実際の出力です。

ユーザー

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営業日かかります。コードメッセージは1SMSセグメントです。1セグメントあたりの参考価格が$0.0123の場合、税金および送信元ID手数料を除き、50,000個のコードで月額は約$615となります。これは見積もりではありません。

次のステップ：broadnet.me/signupからテストアクセスを申し込んでください。トークンを取得後、メッセージングサーバーを通じて、お客様の認証済み番号へテスト用の認証コードを1件送信できます。確認用のメッセージを準備しましょうか？

デプロイのたびにライブツールの出力から構築

## コピー＆ペースト

これらの例で使用されている数値は架空のものです。トークンは環境変数から読み込んでください。チャットやコミットされたファイルに直接貼り付けないでください。

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"を期待するものや、別の設定からヘッダーを読み取るものがあります）。トークンがまだない場合は、ナレッジエントリのみを追加してください。

tools/call estimate_price（ナレッジサーバー）

```
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}}}'
```

SMSを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` 言語モデル用のサイトインデックス。エージェントのアクセスと制約に関するセクション、および言語ごとのファイルが含まれます。](https://www.broadnet.me/llms.txt)
- [エージェントのスキル `/.well-known/agent-skills/index.json` 5つのSKILL.mdランブック：対応国・地域と料金、送信元IDの登録、最初のSMSテスト、テストアクセス、および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` ウェブサイト、APIゲートウェイ、および両方のMCPエンドポイントの到達可能性の測定結果を、Statuspage v2のサマリー形式で表示。](https://www.broadnet.me/status/api/v2/summary.json)

## エージェントが遵守すべきルール

メッセージを送信するエージェントは、お客様の認証情報を使用してお客様のブランドに代わって動作します。これらのルールをエージェントの指示とツールに組み込んでください。

- コンテンツ送信前の同意 オプトインした受信者に対してのみマーケティングメッセージを送信し、オプトインの記録を保持してください。sender_id_rulesツールを使用すると、各市場のオプトインルールを確認できます。
- オプトアウトを遵守 プロモーションメッセージには、STOPなどの市場ごとのオプトアウトキーワードが含まれます。エージェントは、オプトアウトした番号には決してメッセージを送信しません。
- 登録済みの送信元IDのみ 多くの市場では、英数字の送信元IDの事前登録が必要です。本エージェントは、お客様のアカウントで承認された送信元IDのみを使用し、未承認のIDを捏造することはありません。
- 送信禁止時間帯を尊重 夜間のマーケティングを禁止している市場がいくつかあります。sender_id_rulesは取得した送信禁止時間帯（quiet hours）を返します。OTPおよびアラートは、通常24時間いつでも許可されています。
- OTPフローをSMSパンピングから保護 ボットは、利益を得る対象となる番号に対してOTPをトリガーする可能性があります。番号、IP、およびデバイスごとにコードのリクエストにレート制限を設け、提供していない宛先をブロックしてください。MyOTPでは、これらの保護機能がデフォルトで有効になっています。
- 担当者がすべての送信を承認 特に多数の受信者に送信するツールを使用する前に、クライアントに確認させるようにし、エージェントが必要なツールのみを有効にしてください。
- 自身の番号でテストする テスト用認証情報を使用して、自身で検証済みの番号にのみ送信してください。例やプロンプトには架空の番号を使用しています。
- トークンをチャット内に含めない トークンは送信用の認証情報です。環境変数から読み込み、プロンプトからは決して読み込まないでください。漏洩した場合は直ちに失効させてください。

## 関連

[MCPサーバー 両サーバーの詳細：エンドポイント、認証、クライアント設定、およびデモ。](https://www.broadnet.me/ja/developers/mcp) [クイックスタート テストアクセスから、curlまたはTypeScript SDKを使用した最初のSMSまで。](https://www.broadnet.me/ja/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推論 音声およびドキュメントエージェント向けの、アラビア語音声文字起こしおよびビジョンモデル。](https://www.broadnet.me/ja/products/inference) [DialerBee コンタクトセンター向け多言語AIアウトバウンド発信システム](https://www.broadnet.me/ja/dialerbee) [SMSパンピングとは？ OTP詐欺の仕組みと、それを阻止する防御策](https://www.broadnet.me/ja/answers/what-is-sms-pumping)

## 質問

### AIエージェントはBroadNetを通じてSMSおよびWhatsAppメッセージを送信できますか？

はい。BroadNetのトークンを使ってメッセージングMCPサーバー（https://mcp.broadnet.me/mcp）に接続するか、コードからREST API（https://api.broadnet.me）を呼び出してください。いずれの場合もエージェントは貴社のトークンの権限で動作するため、送信のたびに人が確認する仕組みにしてください。

### 対応国・地域や料金について問い合わせる際、エージェントにアカウントは必要ですか？

いいえ。https://www.broadnet.me/mcpの知識MCPサーバーは公開されており、読み取り専用です。このサーバーは、ウェブサイトと同じデータから、対応国・地域、送信元IDのルール、参考価格、および規制を返します。価格は参考価格であり、見積もりではありません。

### エージェントはどのようにワンタイムパスワードを送信しますか？

貴社のシステムがコードを生成し、エージェントがPOST /sms/sendSmsを用いたSMS、またはWhatsApp認証テンプレートで送信します。公開APIには個別の検証エンドポイントがないため、コードの照合は貴社のシステム内で行われます。

### エージェントは音声通話を行えますか？

Voice OTP、テキスト読み上げ通話、およびIVRは、お客様のBroadNetアカウントチームを通じて提供されます。これらは公開されているOpenAPI仕様やMCPツールには含まれていません。DialerBeeは、コンタクトセンター向けのBroadNetによるAIアウトバウンド発信システムです。

### トークンはどのように取得しますか？

テストアクセスは /signup からお申し込みください。BroadNetが1営業日以内にテスト用の認証情報をお送りします。即時発行のセルフサービスキーはありません。

## エージェントをBroadNetに接続する

まずはパブリックナレッジサーバーから始めてください。エージェントの送信準備が整ったら、テストアクセスを申し込んでください。

[テストアクセスを申し込む（英語フォーム）](https://www.broadnet.me/ja/contact?intent=test-access) [MCPサーバーガイド](https://www.broadnet.me/ja/developers/mcp)