Skip to main content
このガイドでは、AIエージェントで最初の電話に応答するまでに必要な4つのREST呼び出しを説明します。
ThunderPhoneアカウントが必要です。 登録は無料で、1分もかかりません。curlよりクリック操作が好みの場合は、 ダッシュボードのクイックスタートでコードを書かずに 同じ最初の通話まで進めます。

ステップ1: APIキーを取得する

1

ログイン

app.thunderphone.comを開きます。
2

キーに移動

ダッシュボードで組織 → キーに移動します。
3

キーを作成

キーを作成をクリックし、名前を付けて sk_live_...の値をコピーします。キーの生の値は一度だけ表示されるため、すぐに シークレットマネージャーへ保存してください。
困った場合は、サーバーAPIキーを作成するで この手順をステップごとに詳しく確認できます。また、アプリ内コパイロットが 各コントロールをリアルタイムでハイライト表示します。
このガイド全体で、sk_live_YOUR_API_KEYを先ほどコピーした値に置き換えます。 キーにより組織が自動的に識別されるため、URLに組織IDを指定する必要はありません。

ステップ2: エージェントを作成する

エージェントは、AIが会話を処理する方法を定義します。これには、プロンプト、音声、 製品ティア、ツール、ウィジェットの利用可否が含まれます。
製品ティア: sparkはコスト向けに最適化され、boltは速度向け、 storm-base / storm-extraは複雑なプロンプトに対する高度な知能向けです。完全な 比較はエージェントを参照してください。

ステップ3: 電話番号をプロビジョニングする

この呼び出しは、ThunderPhone のデモプールに番号をリクエストし、新しいエージェントを着信ハンドラーとして割り当てます。(VoIP プロバイダーから独自の番号を持ち込む場合は、VoIP 接続を参照してください。)
新しい番号は status="provisioning" で開始され、数秒以内に active に移行します。ブラウザを閉じる頃には、その番号で着信を受けられる状態になります。

ステップ4(任意): Webhook を設定する

リアルタイムイベント(動的な通話ルーティング、通話後処理)には、 Webhook エンドポイントを追加します。必要なイベントのみを購読してください。
レスポンスには一度だけ表示される secret が含まれます。シークレットマネージャーにコピーしてください。 そのシークレットを使用して、受信リクエストの X-ThunderPhone-Signature ヘッダーを検証します(Webhook の概要を参照)。

ステップ5: エージェントをテストする

プロビジョニングした番号に電話をかけます。エージェントが応答して自己紹介し、プロンプトに従います。 通話終了後に通話を確認します。
特定の通話を詳しく確認し、文字起こしと録音 URL を取得します。

次のステップ

関数ツールを追加する

会話中にエージェントから API を呼び出せるようにします。

発信する

独自のコードから通話をトリガーします。

Webhook を処理する

通話イベントにリアルタイムで対応します。

API リファレンス全文

すべての公開エンドポイントを文書化しています。