ThunderPhoneアカウントが必要です。
登録は無料で、1分もかかりません。curlよりクリック操作が好みの場合は、
ダッシュボードのクイックスタートでコードを書かずに
同じ最初の通話まで進めます。
ステップ1: APIキーを取得する
1
ログイン
app.thunderphone.comを開きます。
2
キーに移動
ダッシュボードで組織 → キーに移動します。
3
キーを作成
キーを作成をクリックし、名前を付けて
sk_live_...の値をコピーします。キーの生の値は一度だけ表示されるため、すぐに
シークレットマネージャーへ保存してください。sk_live_YOUR_API_KEYを先ほどコピーした値に置き換えます。
キーにより組織が自動的に識別されるため、URLに組織IDを指定する必要はありません。
ステップ2: エージェントを作成する
エージェントは、AIが会話を処理する方法を定義します。これには、プロンプト、音声、 製品ティア、ツール、ウィジェットの利用可否が含まれます。ステップ3: 電話番号をプロビジョニングする
この呼び出しは、ThunderPhone のデモプールに番号をリクエストし、新しいエージェントを着信ハンドラーとして割り当てます。(VoIP プロバイダーから独自の番号を持ち込む場合は、VoIP 接続を参照してください。)status="provisioning" で開始され、数秒以内に
active に移行します。ブラウザを閉じる頃には、その番号で着信を受けられる状態になります。
ステップ4(任意): Webhook を設定する
リアルタイムイベント(動的な通話ルーティング、通話後処理)には、 Webhook エンドポイントを追加します。必要なイベントのみを購読してください。secret が含まれます。シークレットマネージャーにコピーしてください。
そのシークレットを使用して、受信リクエストの X-ThunderPhone-Signature
ヘッダーを検証します(Webhook の概要を参照)。
ステップ5: エージェントをテストする
プロビジョニングした番号に電話をかけます。エージェントが応答して自己紹介し、プロンプトに従います。 通話終了後に通話を確認します。次のステップ
関数ツールを追加する
会話中にエージェントから API を呼び出せるようにします。
発信する
独自のコードから通話をトリガーします。
Webhook を処理する
通話イベントにリアルタイムで対応します。
API リファレンス全文
すべての公開エンドポイントを文書化しています。