ThunderPhone v3、提供開始。セルフサービスで、1分あたり2セントから。発表内容を見る

Using the dashboard

ThunderPhoneからの移行

エージェントをオープンファイルとしてエクスポートし、コーディングエージェントスキルを使ってLiveKit Agents、Pipecat、Vapi、またはRetellで再構築し、通話履歴と録音をダウンロードします。

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

持ち出せるもの

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

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

Zeus で行う場合

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

API を使用する場合

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

ZIP ファイルはリクエスト時に作成されます。エージェントを読み取れるユーザーは誰でもエクスポートできます。ナレッジ、電話番号、Webhook が含まれるのは、認証情報でそれらを読み取れる場合のみです。OAuth トークンには knowledge:read、numbers:read、integrations:read が必要で、Webhook には管理者またはオーナー権限も必要です。除外された項目は manifest.json の omitted に一覧表示されます。API は 1 分間に 30 件を超えるエクスポートに対して 429 を返します。

クエリパラメーター説明
include_url_pathstrue を指定すると、ツールのエンドポイントなど、各 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
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 日以内に顧客データを返却または削除します。」

全文は 利用規約の サービス期間、停止、終了に記載されています。利用規約が優先されます。これは要約です。

関連