Open in
ThunderPhoneからの移行
エージェントをオープンファイルとしてエクスポートし、コーディングエージェントスキルを使ってLiveKit Agents、Pipecat、Vapi、またはRetellで再構築し、通話履歴と録音をダウンロードします。
ThunderPhoneはいつでも離れられます。任意のエージェントを、オープンファイルを含むzipとして無料でエクスポートできます。また、スキルを使うと、コーディングエージェントがLiveKit Agents、Pipecat、Vapi、またはRetell上で再構築できます。このページでは、持ち出せるもの、エクスポート方法、移行先で再設定する内容について説明します。
持ち出せるもの
| 内容 | 方法 |
|---|---|
| エージェント: 指示、ツール、転送先番号、ステップ、設定、番号ルーティング、Webhook | エージェントのエクスポート。エージェントごとに1つのzip |
| エージェントのナレッジファイル | エージェントのエクスポートに含まれます |
| 通話履歴と文字起こし | 通話のエクスポート。リクエストごとに最大1,000件の通話 |
| 録音 | 通話ごとに、リクエスト1件につき1つの録音 |
| 自身の通信事業者で管理する電話番号 | 電話番号は通信事業者から移動していません。電話番号を参照 |
エージェントをエクスポートする
Zeus で行う場合
エージェントを開き、その設定(エージェントエディタの 通話処理)に移動します。最下部の エクスポート、コピー、削除 で、エクスポート を選択します。 ZIP ファイルがコンピューターにダウンロードされます。
API を使用する場合
curl 'https://api.thunderphone.com/v1/agents/12/export' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o agent-12.zipZIP ファイルはリクエスト時に作成されます。エージェントを読み取れるユーザーは誰でもエクスポートできます。ナレッジ、電話番号、Webhook が含まれるのは、認証情報でそれらを読み取れる場合のみです。OAuth トークンには knowledge:read、numbers:read、integrations:read が必要で、Webhook には管理者またはオーナー権限も必要です。除外された項目は manifest.json の omitted に一覧表示されます。API は 1 分間に 30 件を超えるエクスポートに対して 429 を返します。
| クエリパラメーター | 説明 |
|---|---|
include_url_paths | true を指定すると、ツールのエンドポイントなど、各 URL のパスがエクスポートに保持されます。デフォルトでは、すべての URL はホストまでに切り詰められます。どちらの場合も、URL からユーザー名、パスワード、クエリ文字列は削除されます |
ツールのエンドポイントが必要になるため、別の場所でエージェントを再構築する場合は include_url_paths=true を使用します。共有する予定のコピーでは指定しないでください。
ZIP ファイルの内容
| ファイル | 内容 |
|---|---|
manifest.json | 形式(thunderphone.agent-export/v1)、含まれる項目、除外された項目とその理由を示す omitted リスト |
agent.json | 認証情報を除去した、GET /v1/agents/{agent_id} が返すエージェント |
prompt.md | 現在有効な指示 |
knowledge/index.json とその隣のファイル | エージェントのナレッジ。各ドキュメントは保存されている場合は元のファイル、それ以外の場合は抽出されたテキストです |
numbers.json | このエージェントにルーティングされる着信および発信の電話番号。固定されたバージョンまたはバリアントも含まれます |
webhooks.json | シークレットを除いた、このエージェントにスコープ設定された Webhook エンドポイント |
README.md | 各ファイルの説明 |
25 MB を超えるナレッジファイル、およびエクスポート全体で 100 MB を超える分は除外されます。各項目は、そのダウンロードエンドポイント
GET /v1/knowledge/documents/{document_id}/original とともに manifest.json に一覧表示されます。
含まれないもの
- 認証情報の値。ツールのヘッダーは名前のみが一覧表示されます。ヘッダー値は ThunderPhone では書き込み専用です。API レスポンスで返されることはないため、エクスポートにも含まれません。移行先で再入力してください。これは ThunderPhone が認証情報として保存している認証情報に適用されます。指示とナレッジファイルは、入力またはアップロードした内容のままコピーされます。そのため、キーをプロンプトやドキュメントに貼り付けたことがある場合は、ZIP ファイルに含まれます。共有する前に確認してください。
- 通話履歴と録音。これらには専用のエクスポートがあります。通話履歴と録音を参照してください。
- バージョン履歴。エクスポートには、現在有効なエージェントの状態が含まれます。以前のバージョンは引き続き
GET /v1/agents/{agent_id}/versionsに一覧表示されます。 - このエージェントが引き継ぐ他のエージェント。それぞれ同じ方法でエクスポートしてください。
別のプラットフォームへ移行
migrate-off-thunderphone スキルは、コーディングエージェントによる移行をガイドします。ThunderPhone スキルをインストールします。
npx skills add thunderphone/skills次に、ThunderPhone からエージェントを移行し、移行先として LiveKit Agents、Pipecat、Vapi、または Retell を指定するようコーディングエージェントに依頼します。スキルはエクスポートをダウンロードし、各認証情報を確認したうえで、移行先向けのマッピングからエージェントを再構築し、番号を移行する前にその環境でテストします。変換は、設定したキーを使用してコーディングエージェント内で実行されます。ThunderPhone が別のプラットフォーム上のアカウントに書き込むことはありません。
スキルがマッピングするファイルとして引き継がれるもの:
- 共有指示とステップを含む指示。
- ツール: 同じエンドポイント、メソッド、パラメータスキーマ。各ツールの
request_formatには、エンドポイントが想定する本文の形式が記録されます。 - 転送先番号、通話終了設定、キーパッド設定。
- ナレッジファイル。
- ボイスメール、無音、通話時間の設定。
- エージェントが応答する番号と発信に使用する番号。
移行先で再設定するもの:
- 音声、言語モデル、音声プロバイダー。 移行先で選択します。音声や通話の聞こえ方が一致する保証はありません。
- 認証情報。 ツールヘッダーの値と Webhook シークレット。
- 電話機能。 番号をエージェントに接続する方法は、プラットフォームごとに異なります。
- ステップと引き継ぎ。 フローまたは引き継ぎ機能を備えた移行先では、そこで再構築されます。それ以外では、スキルがステップを指示に統合して通知します。
- 対応する機能がない ThunderPhone 設定。 インテリジェンス、聞き取りと応答速度の設定、組み込みのメールおよびテキストメッセージツール、通話評価、要約、結果ラベルは、再構築しない限り移行されません。
- リクエスト署名。 ThunderPhone は送信するツールリクエストと Webhook に署名します。別のプラットフォームは独自の方法で署名するため、ThunderPhone の署名を検証するエンドポイントには新しい検証処理が必要です。
- テスト。 番号を移行する前に、移行先で再構築したエージェントをテストします。
新しいエージェントがテストに合格するまで、ThunderPhone のエージェントはそのまま残してください。元に戻す手段になります。
電話番号
新しいエージェントがテストに合格した後、最後に番号を移行します。
- 自社キャリアの番号(VoIP 接続)は、そのキャリアに残ります。キャリアのコンソールで、新しいプラットフォームを接続先に設定します。次に、ThunderPhone でその番号の リリース を選択し、この番号も … アカウントでキャンセルする はチェックしないままにします。番号は ThunderPhone から切断され、キャリアアカウントに残ります。API では、
DELETE /v1/phone-numbers/{phone_number_id}?confirm=trueを使用してリリースし、release_at_providerは送信しないでください。 - ThunderPhone が提供した番号。 維持したい番号をリリースする前に、サポートへ連絡してください。ThunderPhone の番号のリリースは永続的です。番号はプールに戻され、別の顧客に割り当てられる場合があります。
通話履歴と録音
これらはエージェントエクスポートとは別です。
- 通話。
GET /v1/calls/exportは、リクエストごとに最大 1,000 件の通話を CSV(メタデータ)または JSON(文字起こしを含む)で返します。agent_idでフィルタリングし、start_dateとend_dateを使用して履歴をページ送りします。返された件数より一致した通話が多い場合、X-Truncatedレスポンスヘッダーはtrueになります。 - 録音。
GET /v1/calls/{call_id}/audioは、1 件の通話録音用の短期間有効な URL を返します。一括録音ダウンロードはありません。
curl 'https://api.thunderphone.com/v1/calls/export?export_format=json&agent_id=12&start_date=2026-10-01T00:00:00Z&end_date=2026-11-01T00:00:00Z' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o calls-2026-10.json費用
無料です。エージェントのエクスポート、通話のエクスポート、録音のダウンロードは 無料です。ThunderPhone はサブスクリプション料金やシート料金のない従量課金制です。ThunderPhone の電話番号は、解放すると請求が停止します。
利用終了後
契約期間の定めはありません。アカウントの管理者メールアドレス、または別の検証可能なチャネルから legal@thunderphone.com 宛に書面で通知することで、契約を終了できます。支払いの遅延によりサービスが停止される場合がありますが、それだけで契約が終了したり、顧客データの削除が開始されたりすることはありません。データについて、利用規約には次のように記載されています。「正式な終了後、プロバイダーは、顧客のエクスポート権、バックアップサイクル、法的保全措置、法令上必要な保持、DPA、および締結済みの BAA に従い、60 日以内に顧客データを返却または削除します。」
全文は 利用規約の サービス期間、停止、終了に記載されています。利用規約が優先されます。これは要約です。