--- title: "コアコンセプト" description: "プラットフォーム全体の地図。各オブジェクトの役割、ダッシュボード上の場所、関連するAPIを把握できます。" --- ThunderPhone は、AI 音声エージェントを構築、運用、改善するためのフルプラットフォームです。このページは全体像を示します。各概念を短いセクションで説明し、対応するダッシュボード画面と API を紹介します。まず一度目を通し、用語の説明が必要になったときに戻ってきてください。 ダッシュボードのサイドバーは、この構成を反映しています。 [エージェント](#agents)、[音声](#voices)、[電話番号](#phone-numbers)、 [Web ウィジェット](#web-widgets)、[通話](#calls)、 [クライアントポータル](#client-portals)、[ナレッジ](#knowledge-bases)。 [ライブモニタリング](#live-monitoring)とアウトバウンド [キャンペーン](#campaigns)。 エージェントで使用できる[アプリ、API、MCP サーバー、VoIP プロバイダー](#connections)。 [シミュレーション](#simulations)、[検証セット](#validation-sets)、 [実験](#experiments)、 [問題](#issues)、[レポート](#reports)、 [可観測性](#observability)。 [チームとロール](#team-and-roles)、[API キー](#organizations)、 [アラート](#alerts)、[請求](#billing)。 独自コード向けの[Webhook](#webhooks)と[関数ツール](#function-tools)。 --- ## 組織 **組織**はテナントの単位です。エージェント、電話番号、通話、キーなど、その他すべてのリソースは、必ず 1 つの組織に属します。アカウントは複数の組織に所属でき、それぞれに独自の残高、キー、メンバーリストがあります。 **組織 → キー**で作成する `sk_live_` API キーは、1 つの組織に紐付けられます。この紐付けにより、REST API は非常にシンプルです。キーがすでに組織を識別するため、URL パスに組織 ID を指定する必要はありません。 **ダッシュボード内:** 組織切り替え（サイドバーフッター）と **組織**設定 — マイアカウント、一般、キー、アラート、 請求設定、請求履歴のタブ。詳細は [組織設定リファレンス](/ja/guides/organization-settings)を参照してください。 **API 内:** [`/v1/orgs`](/api-reference/organizations)、 [`/v1/developer/api-keys`](/api-reference/developer-api-keys)。 --- ## エージェント **エージェント**は、通話を実行する AI 設定です。以下をまとめます。 - エージェントの発話内容と動作を制御する**プロンプト**。転送、キーパッド操作、通話終了などの通話アクションも含まれ、個別の設定ではなく通常のプロンプト行として記述します。 - **エンジンティア**（`spark`、`bolt`、`storm-*`）：Spark はコスト向けに最適化され、Bolt は速度向け、Storm は複雑なプロンプトにおける高度な推論向けです。 - **音声**、**主要言語**、任意の**追加言語**。発信者が言語を切り替えると、エージェントも自動的に切り替わります。[対応言語](/ja/guides/supported-languages)を参照してください。 - 接続済みの機能：[接続済みアプリ](#connections)、 [API 接続](#connections)、[ナレッジベース](#knowledge-bases)、 [MCP サーバー](#connections)、インラインの [関数ツール](#function-tools)。 - 動作設定：発話順序、応答モード、バックグラウンドトラック、保留タイムアウト。 ビルダーでの編集は**下書きに自動保存**されます。**デプロイ**をクリックするまで公開されません。デプロイのたびにビルダーの**履歴**タブにスナップショットが保存されるため、以前の任意のバージョンを確認して復元できます。 **ダッシュボード内:** **音声エージェント** → エージェントビルダー (`/dashboard/agents`)。詳細は [最初の音声エージェントを構築する](/ja/guides/build-an-agent)を参照してください。 **API 内:** [`/v1/agents`](/api-reference/agents) — CRUD、 複製、転送、バージョン履歴、プロンプトヘルパー。 ## 音声 **音声ライブラリ**には、エージェントが使用できる音声、再生可能な サンプル、対応言語、性別とアクセントの分類、およびプレミアム音声・言語の 追加料金が含まれます。有料サンプラーでは、選択前に1～500文字の任意の フレーズを合成できます。 対象となる組織は、短いWAVまたはMP3サンプルから**カスタム音声**を作成することもできます。カスタム音声には上限と非同期の作成ステータスがあり、準備が完了するとライブラリ音声と同じエージェント選択画面に表示されます。 **ダッシュボード内:** **音声** (`/dashboard/voices`)。詳細は [音声ライブラリとカスタム音声](/ja/guides/voice-library)を参照してください。 **API内:** [`/v1/voices`](/api-reference/voices)、 [音声サンプル](/api-reference/voice-samples)、および [カスタム音声](/api-reference/custom-voices)。 --- ## 電話番号 **電話番号**は組織に属し、着信通話をエージェントにルーティングします （発信通話にも使用できます）。取得元は2種類あります。 - **ThunderPhone番号** — ThunderPhoneのプールから提供される実在の米国番号です。数秒で利用可能になり、{/* rate:phone */}月額$1に加えて1分あたり1¢{/* /rate */}の追加料金がかかります。最初は着信専用です。組織の管理者は**電話番号**ページから発信機能をリクエストできます。ThunderPhoneが各リクエストを手動で審査し、承認された番号は通話の発信とキャンペーンの実行が可能になります。組織ではデフォルトで25件まで保有できます。 - **VoIP番号** — [VoIP接続](#connections)を通じて独自のプロバイダーから持ち込む番号です。TwilioとTelnyxはAPIキーで直接接続できます（Telnyxにはガイド付きの新規アカウント設定もあります）。SignalWire、Vonage、Plivo、その他のSIPトランクは、手動のSIP設定であるSIPセットアップを通じて接続します。インポートと認証が完了すると、VoIP番号は着信と発信に対応します。 各番号の行では、ルーティングモードの設定、着信エージェントの選択、 番号へのラベル付けを行えます。 **ダッシュボード内:** **電話番号** (`/dashboard/phone-numbers`)。 詳細は[電話番号を取得する](/ja/guides/get-a-phone-number)を参照してください。 **API内:** [`/v1/phone-numbers`](/api-reference/phone-numbers)、 [`/v1/voip-connections`](/api-reference/voip-connections)、 [`/v1/phone-number-labels`](/api-reference/phone-number-labels)。 --- ## 通話 すべての着信通話、発信通話、シミュレーション、およびウィジェットセッションは **通話ログ**になります。通話には、役割タグ付きの完全な文字起こし、 構造化されたターン履歴（ツール呼び出しを含む）、録音、請求合計、 および任意のAI評価と問題レポートが含まれます。 通話が**ライブ**中の場合、開いて**通話を聞く**ことができます。通話には 無音で参加するため、通話中の誰にも聞こえません。通話を聞いている間は、 **ささやき**を使用できます。通話中にエージェントへ直接送信される指示を入力すると、 発信者には聞こえず、エージェントがリアルタイムで従います。 **ダッシュボード内:** アーカイブと通話ごとの詳細は**通話履歴** (`/dashboard/call-history`)、 進行中の通話は**ライブ**で確認できます。詳細は [通話を確認し、聞き、指導する](/ja/guides/review-calls)を参照してください。 **API内:** [`/v1/calls`](/api-reference/calls) — 一覧、文字起こし、 履歴、音声、評価、エクスポート。 [`/v1/issue-reports`](/api-reference/issue-reports)。 --- ## クライアントポータル **クライアントポータル**は、外部クライアント向けのブランド設定済み読み取り専用 通話履歴ビューです。組織管理者は表示する通話のエージェントを選択し、承認済みの 閲覧者メールアドレスを追加し、ロゴとアクセントカラーをアップロードし、必要に応じて カスタムドメインを検証します。ポータル閲覧者は、ダッシュボードへのアクセス権なしで 通話の詳細、文字起こし、利用可能な録音を確認できます。 **ダッシュボード内:** **クライアントポータル** (`/dashboard/client-portals`)。詳細は [クライアントポータル](/ja/guides/client-portals)を参照してください。 **API内:** 管理用インターフェースとして [`/v1/client-portals`](/api-reference/client-portals)を使用できます。 --- ## Webウィジェット **ウェブウィジェット**を使用すると、サイト訪問者は電話番号なしで、マイクを通じてエージェントと会話できます。許可したドメインからのみブラウザで使用できる**公開可能キー**（`pk_live_...`）で認証されるため、クライアント側コードでも安全に使用できます。ドメインリストは認証ではなく、ページが送信できるセッション設定は、キーで許可するまで無効です。 キーは2つのモードのいずれかで動作します。`agent`（1つのエージェントに静的に紐付け）または`webhook`（サーバーが訪問者ごとに設定を選択 — [通話ごとの動的設定](/ja/guides/dynamic-call-config)を参照）です。ウィジェットセッションは、電話と同じ通話インフラストラクチャを経由します。 **ダッシュボード:** **Webウィジェット**（`/dashboard/web-widgets`）— ウィジェットの作成、モードとエージェントの設定、許可ドメインの管理、埋め込みスニペットのコピーを行えます。[Webウィジェットを作成する](/ja/guides/embed-a-web-widget-dashboard)を参照してください。 **API:** [`/v1/publishable-key`](/api-reference/publishable-keys)、[`/v1/mic-session`](/api-reference/mic-sessions)、および[Widget SDKドキュメント](/ja/widget/overview)。 --- ## ナレッジベース **ナレッジベース**は、通話中にエージェントが回答の根拠を得るために検索できるドキュメントの集合です。ファイルをアップロードするか、テキストを貼り付けるか、URLからWebページをインポートし、ビルダーでナレッジベースをエージェントに接続します。会話で必要になったとき、エージェントは組み込みの検索ツールでナレッジベースを照会します。 **ダッシュボード:** ドキュメントライブラリは**ナレッジ**（`/dashboard/knowledge`）、エージェントへの接続はビルダーの**ナレッジ**セクションで行います。[エージェントにナレッジベースを追加する](/ja/guides/knowledge-base)を参照してください。 --- ## 接続 接続により、エージェントは外部サービスにアクセスできます。種類は4つで、すべて1つのサイドバーグループにあります。 - **アプリ**（`/dashboard/app-connections`）— Slack、HubSpot、Salesforce、Google Calendar、Google Sheets、Cal.comへのOAuth接続です。一度接続すれば、操作ごとのツール（Slackメッセージの投稿、HubSpotコンタクトのアップサート、Cal.com枠の予約など）を任意のエージェントで有効にできます。[アプリを接続する](/ja/guides/connect-apps)を参照してください。 - **API**（`/dashboard/api-connections`）— 任意のHTTP APIをエージェントアクションに変換します。cURLコマンドを貼り付けるとAIウィザードがツール定義の下書きを作成します。手動で作成することもできます。リリース前に**テストリクエスト**ボタンでサンドボックス呼び出しを実行できます。[API接続](/ja/guides/api-connections)を参照してください。これは[`/v1/integrations`](/api-reference/integrations)のダッシュボード画面です。 - **MCP**（`/dashboard/mcp-connections`）— URLでModel Context Protocolサーバーを追加し、エージェントが公開されているツールを使用できるようにします。[MCPサーバーを追加する](/ja/guides/mcp-servers)を参照してください。 - **VoIP**（`/dashboard/voip-connections`）— [独自の電話番号を使用する](#phone-numbers)ためのプロバイダー認証情報です。[VoIPプロバイダーを接続する](/ja/guides/voip-providers)を参照してください。 ThunderPhoneは独自のMCPエンドポイントも公開しており、外部MCPクライアントからエージェントの一覧取得、通話と文字起こしの確認、通話の発信を行えます。[ThunderPhoneをMCPサーバーとして使用する](/ja/guides/thunderphone-mcp-server)を参照してください。 **API:** [`/v1/integrations`](/api-reference/integrations)、[`/v1/mcp-servers`](/api-reference/mcp-servers)、[`/v1/voip-connections`](/api-reference/voip-connections)。[ツール統合を構築する](/ja/guides/build-tool-integration)も参照してください。 --- ## キャンペーン **キャンペーン**では、大規模なアウトバウンド通話を実行できます。連絡先のCSVをアップロードし、エージェントと発信元番号を選択して、発信時間帯（曜日、時間、タイムゾーン対応）、同時実行数、再試行ポリシー（最大試行回数と、再試行する結果 — 応答なし、留守番電話、失敗）を設定します。キャンペーンはリストを順に処理し、すべての通話を通話履歴に記録します。 **ダッシュボード:** **キャンペーン**（`/dashboard/campaigns`）。[アウトバウンド通話キャンペーンを実行する](/ja/guides/outbound-campaigns)を参照してください。 **単発のプログラムによる通話:** [アウトバウンド通話API](/ja/guides/place-outbound-calls)。 ## ライブモニタリング **ライブ**では、組織全体で進行中のすべての通話を表示し、任意の通話を開いてリアルタイムで[傍受とささやき](#calls)を行えます。これは監督用の画面です。新しいプロンプトが初めて実際のトラフィックを処理する様子を確認したり、実行中のキャンペーンを監視したりできます。 **ダッシュボード:** **ライブ** (`/dashboard/live`)。[ライブ通話を監視・管理する](/ja/guides/monitor-live-calls)を参照してください。 --- ## シミュレーション **シミュレーション**とは、AIの発信者がエージェントと実際に会話する機能です。同じ電話経路、実際の文字起こし、実際の評価を使用するため、リリース前後にテストできます。エージェントまたは電話番号を指定し、発信者シナリオを作成するか、エージェントのプロンプトからAIで**シナリオを生成**します。必要に応じてエッジケースも含められます。通話はライブで確認できます。 シナリオは**スイート**としてグループ化され、最低合格率を固定し、CIでリリースをゲートできます。承認済みベースラインに対する回帰は、シナリオごとに報告されます。 **ダッシュボード:** **シミュレーション** (`/dashboard/simulations`) と、エージェントビルダー内の**シミュレーション**ボタン。[通話をシミュレーションする](/ja/guides/simulate-a-call)を参照してください。 **API:** [`/v1/test-calls`](/api-reference/test-calls) とスイートランナー。[エージェントをエンドツーエンドでテストする](/ja/guides/test-agents)を参照してください。 --- ## 検証セット **検証セット**は、実際の通話の瞬間を、繰り返し実行可能な単一ターンの回帰チェックに変換します。各例では、会話コンテキスト、関連する発信者音声、元の応答、期待される動作を固定します。リプレイは追加の通話を発信せずに現在のエージェント下書きに対して実行され、デプロイダイアログでは最新の実行結果がその下書きと引き続き一致しているかを確認できます。 **ダッシュボード:** 組織データセット用の**検証セット** (`/dashboard/validation`) と、実行結果用のエージェントビルダーの**検証**タブ。[検証セット](/ja/guides/validation-sets)を参照してください。 **API:** [`/v1/validation-sets`](/api-reference/validation-sets) と、同じリファレンスページにあるエージェントおよび例のリプレイエンドポイント。 --- ## 実験 **実験**では、ライブトラフィックでエージェント設定をA/Bテストします。バリアント（異なるプロンプト、エンジン、設定）を定義し、トラフィックを分割して、バリアントごとの結果を比較します。Webhookでバケットロジックを手作業で実装する代わりに使用してください。 **ダッシュボード:** **実験** (`/dashboard/experiments`) と、エージェントビルダーの**A/B**タブ。[実験（A/Bテスト）](/ja/guides/experiments-ab-testing)を参照してください。 --- ## 問題 **問題**とは、特定の通話でフラグ付けされた問題です。人間のレビュー担当者が登録するか、AI評価によって検出されます。問題には重要度、発生元、ステータスが含まれ、問題ページはトリアージキューとして機能します。フィルタリングし、問題のある通話を調査して、修正を追跡できます。 **ダッシュボード:** **問題** (`/dashboard/issues`) と、通話履歴での通話ごとのフラグ付け。[問題のトリアージ](/ja/guides/issues)を参照してください。 **API:** [`/v1/issue-reports`](/api-reference/issue-reports)。 --- ## レポート **レポート**は、通話データに関する自然言語の質問（「先週、発信者が人間の担当者を求めた主な理由の上位3つは何ですか？」）に対し、選択したエージェントと日付範囲を対象とするAI作成の分析で回答します。 **ダッシュボード:** **レポート** (`/dashboard/reports`)。[レポート](/ja/guides/reports)を参照してください。 --- ## 可観測性 **可観測性**はメトリクス画面です。通話量、結果、時間の経過に伴う品質を確認でき、エージェントと時間枠でフィルタリングできるほか、後続の分析用にエクスポートできます。 **ダッシュボード:** **可観測性** (`/dashboard/observability`)。[可観測性](/ja/guides/observability)を参照してください。 --- ## アラート **アラートルール**は、時間枠内のメトリクス（成功率、失敗率、平均スコア、通話量、スイートの回帰）を監視し、設定したしきい値を超えると発火します。通知はメールとSlackに送信され、[Webhookエンドポイント](/ja/webhooks/endpoints)に`alert.triggered`イベントを発火します。 **ダッシュボード:** **組織 → アラート**。[アラート](/ja/guides/alerts)を参照してください。 --- ## Webhook ThunderPhone は、通話中および通話後にイベントが発生すると、サーバーへ **HTTP POST webhook** を送信します。配信モデルは 2 種類あります。 - **Webhook エンドポイント**（推奨）：エンドポイントごとのシークレットとイベント購読を使用して、多数の URL を [`/v1/developer/webhook-endpoints`](/ja/webhooks/endpoints) で管理します。 - **レガシー単一 URL webhook**：組織ごとに 1 つの URL。 [`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook) または **組織 → 一般** で管理します。後方互換性のために維持されています。 イベントは 2 つのクラスに分かれます。 - **ブロッキングイベント**では、進行中の通話を制御する設定をサーバーから応答する必要があります。対象は [着信イベント](/ja/webhooks/call-incoming) （`telephony.incoming` / `web.incoming`）です。電話通話は再試行1回を含めて最大 13秒、ウィジェットセッションは10秒待機します。 フォールバックエージェントはありません。有効な設定がない場合、電話通話は終了し、ウィジェットセッションは失敗します。 - **ノンブロッキングイベント**は、指数バックオフで再試行されるファイアアンドフォーゲット通知です。詳細は [配信セマンティクス](/ja/webhooks/overview) を参照してください。 すべてのリクエストには、タイムスタンプ付きのHMAC-SHA256署名が `X-ThunderPhone-Signature-V2` に含まれ、従来の本文のみを対象とする `X-ThunderPhone-Signature` も含まれます。詳細は [署名の検証](/ja/webhooks/overview) を参照してください。 --- ## 関数ツール **関数ツール**は、エージェントが会話の途中で呼び出せる HTTP エンドポイントです。ThunderPhone に OpenAI スタイルの関数スキーマとエンドポイント URL を渡すと、エージェントが呼び出すタイミングを判断します。ThunderPhone は自社サーバーから署名付き HTTP リクエストを実行し、結果をエージェントに返します。 エージェントには、通話の転送、キーパッド（DTMF）入力の送信、通話の終了、保留待機といった **組み込みの通話機能** もあります。ツール定義ではなく、シンプルなプロンプト行で有効にできます。 **ダッシュボード内：** ビルダーの **API 接続** セクション（[接続](#connections) を参照）。 **API 内：** [`/v1/integrations`](/api-reference/integrations) および [関数ツール仕様](/ja/tools/overview)。 --- ## チームとロール 各組織には、2 つのロールを持つメンバーリストがあります。**メンバー**はエージェントを構築・運用し、**管理者**はチームと請求も管理できます。メールで招待できます。招待は 7 日後に期限切れとなり、取り消すこともできます。メンバー行の ⋯ メニューからロールの変更やメンバーの削除を行えます。シングルサインオンは組織全体で設定できます。詳細は [SSO](/ja/guides/sso) を参照してください。 **ダッシュボード内：** **組織 → 一般**。 [チームを招待する](/ja/guides/invite-your-team) を参照してください。 **API 内：** [`/v1/members`](/api-reference/members)、 [`/v1/invites`](/api-reference/invites)。 --- ## 請求 ThunderPhone は **前払い制**です。各組織には USD 残高があり、通話ごとにエージェントの分単価（エンジンティアと追加料金。ビルダーでは設定変更に応じて総額料金がリアルタイムで表示され、[一部の追加対応言語](/ja/guides/supported-languages) には {/* rate:language */}3¢/分{/* /rate */} が加算されます）で残高から差し引かれます。残高がゼロになると、着信通話は拒否され、発信通話は `402 Payment Required` を返します。 手動でチャージするか、残高しきい値、補充額、任意の月間利用上限を指定して **自動チャージ**を有効にできます。これにより、通話が会話の途中で切断されることを防げます。 **ダッシュボード内：** **組織 → 請求設定** および **請求履歴**。 [残高を追加して自動チャージを有効にする](/ja/guides/billing-and-topups) と、 [完全な料金リファレンス](/ja/guides/pricing) を参照してください。 **API 内：** [`/v1/billing`](/api-reference/billing)。 --- ## アプリ内コパイロット ダッシュボードには組み込みの **コパイロット** が用意されています。「X を行う方法」と質問すると、このドキュメントに基づいて回答し、実際のコントロールをハイライトするクリックごとの操作ガイドを提示し、任意のガイドツアーを再生できます。このページで紹介されているコントロールを見つける最も速い方法です。 [アプリ内コパイロットに質問する](/ja/guides/ask-the-copilot) を参照してください。 --- ## すべてを組み合わせる 5ステップのウィザード：エージェント → 請求 → 番号 → シミュレーション → 確認。 4回のREST呼び出しで同じ最初の通話を実現。 エージェントを構築し、資金を追加し、番号を取得して、通話をシミュレーション・確認。 OAuthアプリ、カスタムAPI、MCPサーバー、VoIPプロバイダー。 レポート、可観測性、実験、問題、アラート。 招待とロール、APIキー、セキュリティ、SSO。 APIレシピ：着信、発信、動的設定、ツール、テスト。 HMACチェックを一度正しく実装し、どこでも再利用。