コア
接続
エージェントで利用できるアプリ、API、MCP サーバー、VoIP プロバイダー。
組織
組織はテナントの単位です。エージェント、電話番号、通話、キーなど、他のすべてのリソースは必ず 1 つの組織に属します。アカウントは複数の組織に所属でき、それぞれに独自の残高、キー、メンバーリストがあります。 組織 → キーで作成するsk_live_ API キーは、1 つの組織に紐付けられます。この紐付けにより REST API は非常にフラットになります。キーがすでに組織を識別するため、URL パスに組織 ID を指定する必要はありません。
ダッシュボード: 組織切り替え（サイドバー下部）と
組織設定 — 一般、キー、アラート、請求設定、
請求履歴のタブ。
API: /v1/orgs、
/v1/developer/api-keys。
エージェント
エージェントは、通話を実行する AI 設定です。以下をまとめます。- エージェントの発話内容と動作を定めるプロンプト。転送、キーパッド操作、通話終了などの通話アクションも含まれ、これらは個別の設定ではなく通常のプロンプト行として指定します。
- エンジンティア（
spark、bolt、storm-*）：Spark はコストに最適化され、Bolt は速度に、Storm は複雑なプロンプトに対する高度な推論に最適化されています。 - 音声、主要言語、任意の追加言語。発信者が言語を切り替えると、エージェントも自動的に切り替わります。対応言語を参照してください。
- 接続する機能：連携アプリ、 API 接続、ナレッジベース、 MCP サーバー、インライン 関数ツール。
- 動作設定：発話順序、応答モード、バックグラウンドトラック、 保留タイムアウト。
/dashboard/agents)。最初の音声エージェントを構築するを参照してください。
API: /v1/agents — CRUD、
複製、転送、バージョン履歴、プロンプトヘルパー。
電話番号
電話番号は組織に属し、着信通話をエージェントにルーティングします （発信通話にも使用できます）。取得元は2種類あります。- デモ番号 — ThunderPhoneのプールからプロビジョニングされる実在の米国番号で、数秒で利用可能になります。着信専用で、短い音声免責事項を流して応答します。ダッシュボードでは、1組織あたり最大10件に制限されています。最初のテストには最適ですが、本番環境向けではありません。
- VoIP番号 — VoIP接続を通じて、独自のプロバイダーから持ち込む番号です。TwilioとTelnyxは直接接続できます（Telnyxにはガイド付きセットアップがあります）。SignalWireとVonageは近日対応予定です。現在は、任意のSIPトランクを受け付ける手動SIP設定を介して接続できます。インポートと検証が完了すると、VoIP番号は着信と発信の両方に対応します。
/dashboard/phone-numbers)。
電話番号を取得するを参照してください。
API: /v1/phone-numbers、
/v1/voip-connections、
/v1/phone-number-labels。
通話
すべての着信通話、発信通話、シミュレーション、ウィジェットセッションは、 通話ログになります。通話ログには、ロールタグ付きの完全な文字起こし、 構造化されたターン履歴（ツール呼び出しを含む）、録音、請求合計、 任意のAI評価と問題レポートが含まれます。 通話がライブ中の場合は、開いて通話を聞くことができます。無音で参加するため、通話中の誰にも聞こえません。聞き始めると、 ささやきを使用できます。通話中にエージェントへ直接送信される指示を入力します。発信者には聞こえず、エージェントはリアルタイムで指示に従います。 ダッシュボード: アーカイブと通話ごとの詳細は通話履歴 (/dashboard/call-history)、
進行中の通話はライブ。 通話を確認、聞く、コーチするを参照してください。
API: /v1/calls — 一覧、文字起こし、
履歴、音声、評価、エクスポート。
/v1/issue-reports。
Webウィジェット
Webウィジェットは、サイト訪問者にエージェントとのマイクベースの会話を提供します。 電話番号は不要です。許可したドメインにオリジン制限された 公開可能キー (pk_live_...)で認証するため、クライアントサイドコードでも安全に使用できます。
キーは2つのモードのいずれかで動作します。agent（1つのエージェントに静的に紐付け）、
またはwebhook（訪問者ごとにサーバーが設定を選択 —
通話ごとの動的設定を参照）。ウィジェットセッションは電話通話と同じ通話インフラストラクチャを通ります。
ダッシュボード: Webウィジェット (/dashboard/web-widgets) —
ウィジェットの作成、モードとエージェントの設定、許可ドメインの管理、
埋め込みスニペットのコピーを行えます。
Webウィジェットを作成するを参照してください。
API: /v1/publishable-key、
/v1/mic-session、および
Widget SDKドキュメント。
ナレッジベース
ナレッジベースは、通話中にエージェントが回答の根拠として検索できるドキュメントの集合です。 ファイルを直接アップロードするかGoogle Driveからインポートし、ビルダーでナレッジベースをエージェントに紐付けます。 会話で必要になったとき、エージェントは組み込みの検索ツールでナレッジベースをクエリします。 ダッシュボード: ドキュメントライブラリはナレッジ (/dashboard/knowledge)、
エージェントへの紐付けはビルダーのナレッジセクション。
エージェントにナレッジベースを提供するを参照してください。
接続
接続により、エージェントは外部の世界と連携できます。4種類の接続を、1つの サイドバーグループで管理します。- アプリ（
/dashboard/app-connections） — Slack、HubSpot、Salesforce、Google Calendar、Google Sheets、 Cal.com への OAuth 接続です。一度接続すれば、操作ごとのツール（Slack メッセージの投稿、 HubSpot コンタクトのアップサート、Cal.com スロットの予約など）を任意のエージェントに 切り替えて追加できます。アプリを接続を参照してください。 - API（
/dashboard/api-connections） — 任意の HTTP API を エージェントアクションに変換します。cURL コマンドを貼り付けると、AI ウィザードがツール 定義の下書きを作成します。手動で作成することもできます。リリース前に リクエストをテスト ボタンでサンドボックス呼び出しを実行できます。 API 接続を参照してください。これは/v1/integrationsのダッシュボード画面です。 - MCP（
/dashboard/mcp-connections） — URL で Model Context Protocol サーバーを追加し、エージェントが公開されているツールを使用できるようにします。 MCP サーバーを追加を参照してください。 - VoIP（
/dashboard/voip-connections） — 独自の電話番号を使用するためのプロバイダー認証情報です。 VoIP プロバイダーを接続を参照してください。
/v1/integrations と
/v1/voip-connections。
ツール統合を構築も参照してください。
キャンペーン
キャンペーンでは、大規模にアウトバウンド通話を発信します。コンタクトの CSV をアップロードし、 エージェントと発信番号を選択して、通話時間帯（曜日、時間、タイムゾーン対応）、 同時実行数、再試行ポリシー（最大試行回数と、再試行する結果（応答なし、留守番電話、失敗））を 設定します。キャンペーンはリストを順に処理し、すべての通話を通話履歴に記録します。 ダッシュボード: キャンペーン（/dashboard/campaigns）。
アウトバウンド通話キャンペーンを実行を参照してください。
単発のプログラムによる通話:
アウトバウンド通話 API。
ライブモニタリング
ライブには、組織全体で進行中のすべての通話が表示され、任意の通話を開いて リアルタイムで通話を聞き、ささやくことができます。これは監督用の画面です。新しい プロンプトへの最初の実トラフィックを確認したり、実行中のキャンペーンを監視したりできます。 ダッシュボード: ライブ（/dashboard/live）。
ライブ通話を監視・監督を参照してください。
シミュレーション
シミュレーションは、AI 発信者がエージェントと実際の会話を行う機能です。同じ電話経路、 実際の文字起こし、実際の評価を使用するため、リリース前後にテストできます。エージェントまたは 電話番号を指定し、発信者シナリオを自分で作成するか、エージェントのプロンプトから AI で シナリオを生成します。指定すればエッジケースも含められます。通話はライブで確認できます。 シナリオはスイートにグループ化され、最低合格率を固定できます。また、CI でリリースを 制限することもできます。承認済みベースラインに対するリグレッションは、シナリオごとに 報告されます。 ダッシュボード: シミュレーション（/dashboard/simulations）と、
エージェントビルダー内の シミュレーション ボタン。
通話をシミュレートを参照してください。
API: /v1/test-calls と
スイートランナー。エージェントをエンドツーエンドでテストを参照してください。
実験
実験では、ライブトラフィック上でエージェント設定の A/B テストを行います。 バリアント（異なるプロンプト、エンジン、設定）を定義し、トラフィックを分割して、 バリアントごとの結果を比較します。Webhook でバケットロジックを手作業で実装する代わりに 使用できます。 ダッシュボード: 実験（/dashboard/experiments）と、
エージェントビルダーの A/B タブ。
実験（A/B テスト）を参照してください。
問題
問題とは、特定の通話でフラグ付けされた問題です。人間のレビュアーが報告したもの、またはAI評価によって検出されたものがあります。問題には重大度、ソース、ステータスが含まれ、問題ページはトリアージキューとして機能します。フィルタリング、該当する通話の確認、修正の追跡を行えます。 ダッシュボード: 問題（/dashboard/issues）、および通話履歴での通話ごとのフラグ付け。問題のトリアージを参照してください。
API: /v1/issue-reports。
レポート
レポートは、選択したエージェントと期間の範囲で、通話データに関する自然言語の質問（「先週、発信者が人間の担当者を求めた理由の上位3つは何でしたか？」）に対し、AIが作成した分析で回答します。 ダッシュボード: レポート（/dashboard/reports）。レポートを参照してください。
可観測性
可観測性は、通話量、結果、品質を時系列で確認できるメトリクス画面です。エージェントと時間範囲でフィルタリングでき、後続の分析用にエクスポートできます。 ダッシュボード: 可観測性（/dashboard/observability）。可観測性を参照してください。
アラート
アラートルールは、指定した時間範囲でメトリクス（成功率、失敗率、平均スコア、通話量、スイートの回帰）を監視し、しきい値を超えるとトリガーされます。通知はメールとSlackに送信され、Webhookエンドポイントにalert.triggered イベントを送信します。
ダッシュボード: 組織 → アラート。アラートを参照してください。
Webhook
ThunderPhoneは、通話中および通話後にイベントが発生すると、サーバーに HTTP POST Webhook を送信します。配信モデルは2種類あります。- Webhookエンドポイント（推奨）: 複数のURLを
/v1/developer/webhook-endpointsで管理できます。エンドポイントごとのシークレットと、エンドポイントごとのイベントサブスクリプションを設定できます。 - レガシーの単一URL Webhook: 組織ごとに1つのURLです。
/v1/webhookまたは組織 → 一般で管理します。後方互換性のために維持されています。
- ブロッキングイベントでは、進行中の通話を制御する設定をサーバーから応答として返す必要があります。対象はincoming-callイベント（
telephony.incoming/web.incoming）です。応答まで最大10秒です。タイムアウトした場合は、静的に割り当てられたエージェントが通話を処理します。 - 非ブロッキングイベントは、送信後に応答を待たない通知であり、指数バックオフで再試行されます。配信セマンティクスを参照してください。
X-ThunderPhone-Signature にHMAC-SHA256署名が含まれます。署名の検証を参照してください。
関数ツール
関数ツールは、エージェントが会話の途中で呼び出せるHTTPエンドポイントです。OpenAI形式の関数スキーマとエンドポイントURLをThunderPhoneに指定します。エージェントが呼び出すタイミングを判断し、ThunderPhoneがそのサーバーから署名付きHTTPリクエストを送信して、結果をエージェントに返します。 エージェントには、通話の転送、キーパッド（DTMF）入力の送信、通話の終了、保留中の待機といった組み込みの通話機能もあります。ツール定義ではなく、シンプルなプロンプト行で有効にできます。 ダッシュボード: ビルダーのAPI接続セクション（接続を参照）。 API:/v1/integrationsおよび関数ツール仕様。
チームとロール
各組織には、2つのロールを持つメンバー一覧があります。メンバーはエージェントを構築・運用し、管理者はチームと請求も管理できます。メールで招待できます。招待は7日後に期限切れとなり、取り消すこともできます。メンバー行の⋯メニューからロールの変更やメンバーの削除を行えます。シングルサインオンは組織全体で設定できます。SSOを参照してください。 ダッシュボード: 組織 → 一般。チームを招待するを参照してください。 API:/v1/members、/v1/invites。
請求
ThunderPhoneは前払い制です。各組織は米ドル残高を保有し、通話ごとにエージェントの分単価（エンジンティアと追加料金。ビルダーでは設定変更に応じて総額レートがリアルタイムで表示され、プレミアム言語には2¢/分が追加されます）が差し引かれます。残高がゼロになると、着信通話は拒否され、発信通話は402 Payment Requiredを返します。
手動でチャージするか、残高しきい値、補充額、任意の月間利用上限を指定して自動チャージを有効にすると、通話が文の途中で切れることを防げます。
ダッシュボードの場合： 組織 → 請求設定および
請求履歴。詳細は
資金を追加して自動チャージを有効にするを参照してください。
APIの場合： /v1/billing。
アプリ内コパイロット
ダッシュボードには組み込みのコパイロットが搭載されています。「Xをするにはどうすればよいですか」と質問すると、このドキュメントに基づいて回答し、実際のコントロールを強調表示するクリックごとのガイドを提示し、任意のガイドツアーを再生できます。このページで紹介しているコントロールを見つける最も速い方法です。 アプリ内コパイロットに質問するを参照してください。全体を組み合わせる
ダッシュボードのクイックスタート
5ステップのウィザード：エージェント → 請求 → 電話番号 → シミュレーション → 確認。
APIクイックスタート
同じ最初の通話を4つのREST呼び出しで実行。
ダッシュボードの使用
エージェントを構築し、資金を追加し、電話番号を取得して、通話をシミュレーション・確認。
ツールとデータを接続
OAuthアプリ、カスタムAPI、MCPサーバー、VoIPプロバイダー。
分析と改善
レポート、可観測性、実験、問題、アラート。
チームとアカウント
招待とロール、APIキー、セキュリティ、SSO。
開発者クックブック
APIレシピ：着信、発信、動的設定、ツール、テスト。
Webhook署名を検証
HMACチェックを一度正しく実装し、どこでも再利用。