はじめに
実際の電話通話や埋め込み可能なウェブウィジェットで本番運用の音声エージェントを実行するためのドキュメント。クイックスタート、ガイド、ThunderPhone APIの完全なリファレンスを提供します。
ThunderPhoneでは、実際の電話を発信・応答し、ウェブサイト上のマイクによる会話を実現するAI音声エージェントを構築できます。 ドキュメントは4つのタブに分かれています。
ダッシュボードとAPIのクイックスタート、概念、ハウツー。 初めての場合はここから開始してください。
すべてのエンドポイント、リクエストフィールド、レスポンス形式。
埋め込み可能なウェブウィジェット — Reactコンポーネント、ヘッドレスフック、 CDNスクリプトタグ。
リアルタイムイベント、署名、配信セマンティクス。
構築できるもの
所有する電話番号への着信に、プロンプトに従い、ツールを使用し、必要に応じて 人間へ引き継ぐAIエージェントで応答します。
コードからプログラムで電話を発信 — アンケート、フォローアップ、 確認フローに対応します。
埋め込み可能なウェブウィジェットをサイトに追加し、 顧客がクリックして会話できるようにします。電話番号は不要です。
定型シナリオをバッチでエージェントに実行し、 顧客が聞く前に回帰を検出します。
開始する2つの方法
ダッシュボードで開始（最初のエージェントに推奨） — 登録すると、 ダッシュボードが5ステップのセットアップウィザードを案内します。エージェントの作成、 請求設定、電話番号の追加、シミュレーションの実行、通話の確認を行います。 ダッシュボードクイックスタートでは、 このウィザードを手順ごとに説明します。
ターミナルから開始 — APIクイックスタートでは、 同じ最初の通話を4回のREST呼び出しで実行します。
- 概念を確認
概念 — 操作するすべてのオブジェクトと、 それぞれがダッシュボード内のどこにあるかを示す一覧です。
- クイックスタートを実行
ダッシュボードクイックスタートまたは APIクイックスタート — AIエージェントで最初の 通話を行います。
- ガイドを選択
ガイドを参照
エージェントの構築、残高の追加、電話番号の取得、シミュレーション、通話の確認。
OAuthアプリ、カスタムAPI、MCPサーバー、VoIPプロバイダー。
レポート、可観測性、実験、問題、アラート。
招待とロール、APIキー、セキュリティ、SSO。
ベースURL
https://api.thunderphone.com/v1
認証には、sk_live_ 組織APIキーを使用する標準のOAuth 2.0 Bearerスキームを使用します。
キーによって対象の組織が自動的に識別されます — URLパスに組織IDは含まれません。
詳細は認証を参照してください。