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

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

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

接続方法の選択

エージェントには通常、計画のための事実と、実行するための手段の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. ツール呼び出し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営業日かかります。コードメッセージは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}"
      }
    }
  }
}
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時間のサービスウィンドウ外でも機能します。自由形式のテキストにはオープンウィンドウが必要です。

マシンリーダブルなエントリーポイント

接続ではなくブラウジングを行うエージェントは、プレーンファイルからすべてを読み取ることができます。ログインは一切不要です。

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

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

  • コンテンツ送信前の同意

    オプトインした受信者に対してのみマーケティングメッセージを送信し、オプトインの記録を保持してください。sender_id_rulesツールを使用すると、各市場のオプトインルールを確認できます。

  • オプトアウトを遵守

    プロモーションメッセージには、STOPなどの市場ごとのオプトアウトキーワードが含まれます。エージェントは、オプトアウトした番号には決してメッセージを送信しません。

  • 登録済みの送信元IDのみ

    多くの市場では、英数字の送信元IDの事前登録が必要です。本エージェントは、お客様のアカウントで承認された送信元IDのみを使用し、未承認のIDを捏造することはありません。

  • 送信禁止時間帯を尊重

    夜間のマーケティングを禁止している市場がいくつかあります。sender_id_rulesは取得した送信禁止時間帯(quiet hours)を返します。OTPおよびアラートは、通常24時間いつでも許可されています。

  • OTPフローをSMSパンピングから保護

    ボットは、利益を得る対象となる番号に対してOTPをトリガーする可能性があります。番号、IP、およびデバイスごとにコードのリクエストにレート制限を設け、提供していない宛先をブロックしてください。MyOTPでは、これらの保護機能がデフォルトで有効になっています。

  • 担当者がすべての送信を承認

    特に多数の受信者に送信するツールを使用する前に、クライアントに確認させるようにし、エージェントが必要なツールのみを有効にしてください。

  • 自身の番号でテストする

    テスト用認証情報を使用して、自身で検証済みの番号にのみ送信してください。例やプロンプトには架空の番号を使用しています。

  • トークンをチャット内に含めない

    トークンは送信用の認証情報です。環境変数から読み込み、プロンプトからは決して読み込まないでください。漏洩した場合は直ちに失効させてください。

関連

質問

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に接続する

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