---
title: "ThunderPhoneからの移行"
description: "エージェントをオープンファイルとしてエクスポートし、コーディングエージェントスキルを使ってLiveKit Agents、Pipecat、Vapi、またはRetellで再構築し、通話履歴と録音をダウンロードします。"
ui: zeus
---

ThunderPhoneはいつでも離れられます。任意のエージェントを、オープンファイルを含むzipとして無料でエクスポートできます。また、スキルを使うと、コーディングエージェントがLiveKit Agents、Pipecat、Vapi、またはRetell上で再構築できます。このページでは、持ち出せるもの、エクスポート方法、移行先で再設定する内容について説明します。

## 持ち出せるもの

| 内容 | 方法 |
|---|---|
| エージェント: 指示、ツール、転送先番号、ステップ、設定、番号ルーティング、Webhook | [エージェントのエクスポート](#export-an-agent)。エージェントごとに1つのzip |
| エージェントのナレッジファイル | エージェントのエクスポートに含まれます |
| 通話履歴と文字起こし | [通話のエクスポート](#call-history-and-recordings)。リクエストごとに最大1,000件の通話 |
| 録音 | 通話ごとに、リクエスト1件につき1つの録音 |
| 自身の通信事業者で管理する電話番号 | 電話番号は通信事業者から移動していません。[電話番号](#phone-numbers)を参照 |

## エージェントをエクスポートする

### Zeus で行う場合

エージェントを開き、その設定（エージェントエディタの **通話処理**）に移動します。最下部の **エクスポート、コピー、削除** で、**エクスポート** を選択します。
ZIP ファイルがコンピューターにダウンロードされます。

### API を使用する場合

<CodeGroup>
```bash cURL
curl 'https://api.thunderphone.com/v1/agents/12/export' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o agent-12.zip
```
</CodeGroup>

ZIP ファイルはリクエスト時に作成されます。エージェントを読み取れるユーザーは誰でもエクスポートできます。ナレッジ、電話番号、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}`](/api-reference/agents#agent-object) が返すエージェント |
| `prompt.md` | 現在有効な指示 |
| `knowledge/index.json` とその隣のファイル | エージェントのナレッジ。各ドキュメントは保存されている場合は元のファイル、それ以外の場合は抽出されたテキストです |
| `numbers.json` | このエージェントにルーティングされる着信および発信の電話番号。固定されたバージョンまたはバリアントも含まれます |
| `webhooks.json` | シークレットを除いた、このエージェントにスコープ設定された [Webhook エンドポイント](/ja/webhooks/endpoints) |
| `README.md` | 各ファイルの説明 |

25 MB を超えるナレッジファイル、およびエクスポート全体で 100 MB を超える分は除外されます。各項目は、そのダウンロードエンドポイント
[`GET /v1/knowledge/documents/{document_id}/original`](/api-reference/knowledge-bases#download-the-original-file) とともに `manifest.json` に一覧表示されます。

### 含まれないもの

- **認証情報の値**。ツールのヘッダーは名前のみが一覧表示されます。ヘッダー値は ThunderPhone では書き込み専用です。API レスポンスで返されることはないため、エクスポートにも含まれません。移行先で再入力してください。これは ThunderPhone が認証情報として保存している認証情報に適用されます。指示とナレッジファイルは、入力またはアップロードした内容のままコピーされます。そのため、キーをプロンプトやドキュメントに貼り付けたことがある場合は、ZIP ファイルに含まれます。共有する前に確認してください。
- **通話履歴と録音**。これらには専用のエクスポートがあります。[通話履歴と録音](#call-history-and-recordings)を参照してください。
- **バージョン履歴**。エクスポートには、現在有効なエージェントの状態が含まれます。以前のバージョンは引き続き
  [`GET /v1/agents/{agent_id}/versions`](/api-reference/agents#version-history) に一覧表示されます。
- **このエージェントが引き継ぐ他のエージェント**。それぞれ同じ方法でエクスポートしてください。

## 別のプラットフォームへ移行

`migrate-off-thunderphone` スキルは、コーディングエージェントによる移行をガイドします。[ThunderPhone スキル](/ja/guides/coding-agents)をインストールします。

```bash
npx skills add thunderphone/skills
```

次に、ThunderPhone からエージェントを移行し、移行先として **LiveKit Agents**、**Pipecat**、**Vapi**、または **Retell** を指定するようコーディングエージェントに依頼します。スキルはエクスポートをダウンロードし、各認証情報を確認したうえで、移行先向けのマッピングからエージェントを再構築し、番号を移行する前にその環境でテストします。変換は、設定したキーを使用してコーディングエージェント内で実行されます。ThunderPhone が別のプラットフォーム上のアカウントに書き込むことはありません。

スキルがマッピングするファイルとして引き継がれるもの:

- 共有指示とステップを含む指示。
- ツール: 同じエンドポイント、メソッド、パラメータスキーマ。各ツールの `request_format` には、エンドポイントが想定する本文の形式が記録されます。
- 転送先番号、通話終了設定、キーパッド設定。
- ナレッジファイル。
- ボイスメール、無音、通話時間の設定。
- エージェントが応答する番号と発信に使用する番号。

移行先で再設定するもの:

- **音声、言語モデル、音声プロバイダー。** 移行先で選択します。音声や通話の聞こえ方が一致する保証はありません。
- **認証情報。** ツールヘッダーの値と Webhook シークレット。
- **電話機能。** 番号をエージェントに接続する方法は、プラットフォームごとに異なります。
- **ステップと引き継ぎ。** フローまたは引き継ぎ機能を備えた移行先では、そこで再構築されます。それ以外では、スキルがステップを指示に統合して通知します。
- **対応する機能がない ThunderPhone 設定。** インテリジェンス、聞き取りと応答速度の設定、組み込みのメールおよびテキストメッセージツール、通話評価、要約、結果ラベルは、再構築しない限り移行されません。
- **リクエスト署名。** ThunderPhone は送信するツールリクエストと Webhook に署名します。別のプラットフォームは独自の方法で署名するため、[ThunderPhone の署名を検証する](/ja/guides/verify-webhook-signatures)エンドポイントには新しい検証処理が必要です。
- **テスト。** 番号を移行する前に、移行先で再構築したエージェントをテストします。

新しいエージェントがテストに合格するまで、ThunderPhone のエージェントはそのまま残してください。元に戻す手段になります。

## 電話番号

新しいエージェントがテストに合格した後、最後に番号を移行します。

- **自社キャリアの番号**（[VoIP 接続](/ja/guides/bring-your-own-numbers)）は、そのキャリアに残ります。キャリアのコンソールで、新しいプラットフォームを接続先に設定します。次に、ThunderPhone でその番号の **リリース** を選択し、**この番号も … アカウントでキャンセルする** はチェックしないままにします。番号は ThunderPhone から切断され、キャリアアカウントに残ります。API では、`DELETE /v1/phone-numbers/{phone_number_id}?confirm=true` を使用して[リリース](/api-reference/phone-numbers#release-a-phone-number)し、`release_at_provider` は送信しないでください。
- **ThunderPhone が提供した番号。** 維持したい番号をリリースする前に、[サポート](mailto:support@thunderphone.com)へ連絡してください。ThunderPhone の番号のリリースは永続的です。番号はプールに戻され、別の顧客に割り当てられる場合があります。

## 通話履歴と録音

これらはエージェントエクスポートとは別です。

- **通話。** [`GET /v1/calls/export`](/api-reference/calls#export-calls) は、リクエストごとに最大 1,000 件の通話を CSV（メタデータ）または JSON（文字起こしを含む）で返します。`agent_id` でフィルタリングし、`start_date` と `end_date` を使用して履歴をページ送りします。返された件数より一致した通話が多い場合、`X-Truncated` レスポンスヘッダーは `true` になります。
- **録音。** [`GET /v1/calls/{call_id}/audio`](/api-reference/calls#get-recording-audio) は、1 件の通話録音用の短期間有効な URL を返します。一括録音ダウンロードはありません。

<CodeGroup>
```bash cURL
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
```
</CodeGroup>

## 費用

無料です。エージェントのエクスポート、通話のエクスポート、録音のダウンロードは
無料です。ThunderPhone はサブスクリプション料金やシート料金のない[従量課金制](/ja/guides/pricing)です。ThunderPhone の電話番号は、解放すると請求が停止します。

## 利用終了後

契約期間の定めはありません。アカウントの管理者メールアドレス、または別の検証可能なチャネルから legal@thunderphone.com 宛に書面で通知することで、契約を終了できます。支払いの遅延によりサービスが停止される場合がありますが、それだけで契約が終了したり、顧客データの削除が開始されたりすることはありません。データについて、利用規約には次のように記載されています。「正式な終了後、プロバイダーは、顧客のエクスポート権、バックアップサイクル、法的保全措置、法令上必要な保持、DPA、および締結済みの BAA に従い、60 日以内に顧客データを返却または削除します。」

全文は
[利用規約](https://thunderphone.com/terms#term-termination)の
**サービス期間、停止、終了**に記載されています。利用規約が優先されます。これは要約です。

## 関連

- [別のプラットフォームからエージェントをインポート](/ja/guides/import-agents)
- [コーディングエージェント向けスキル](/ja/guides/coding-agents)
- [エージェント API](/api-reference/agents)
- [通話 API](/api-reference/calls)
