---
title: "別のプラットフォームからエージェントをインポート"
description: "APIキーまたはJSONエクスポートを使用して、Vapi、Retell、ElevenLabs Agents、Blandからエージェント、ツール、ナレッジベースを移行し、マッピングを確認してインポートします。"
ui: zeus
---

エージェントがVapi、Retell、ElevenLabs Agents、またはBlandにある場合、インポーターがそれらを取得し、すべてのフィールドをThunderPhoneにマッピングして、作成前に結果を表示します。

<Note>
  APIキーはインポートにのみ使用されます。インベントリの取得中は暗号化され、取得の完了時、および失敗または破棄時には直ちに削除されます。インポートの開始または確定には管理者ロールが必要です。
</Note>

## インポートを開始する

1. **エージェント**を開き、**エージェントをインポート**を選択するか、Zeus にエージェントの移行を依頼します。
2. プラットフォームを選択します。
3. 手順に従ってそのプラットフォームでキーを作成し（該当する設定ページが開きます）、貼り付けます。または、**エクスポートした JSON を貼り付け**を選択し、そのプラットフォームのダッシュボードまたは API から 1 つ以上のエージェントオブジェクトを貼り付けます。
4. **エージェントを取得**を選択します（プラットフォーム名が表示されます）。取得とマッピングは通常 1 分未満で完了します。ページを離れて後で戻ることもできます。進行中のインポートと以前のインポートは、**エージェントをインポート**ページに表示されます。

旧ビューでは、**インポート**は**音声エージェント**にあり、同じ手順がダイアログで開きます。

## プランを確認する

各エージェントには、名前、一致した音声（一致の信頼度を含む）、引き継がれるツールとナレッジベース、翻訳時に変更された内容に関する注記が表示されます。行を展開してプロンプトを確認します。

- **整理済み**（旧ビューでは **書き直し済み**）— [プロンプトガイド](/ja/guides/prompting)の形式に従った、一貫性のある1つのプロンプトです。元の電話番号、URL、ツール名、プレースホルダーはすべて保持されます。
- **Vapiと同じ**、または使用しているプラットフォーム名（旧ビューでは **構造化済み**）— 抽出されたとおりに見出しの下へ配置した元の設定です。書き直しを検証できない場合、または書き直し後の内容が元より大幅に短い場合に自動で使用されます。

フローからインポートしたエージェントには、プロンプトの代わりに **共有指示** と、フローから保持するステップ数が表示されます。旧ビューのレビューには、各ステップの名前、エージェントに指示する内容、次の遷移先が表示されます。**1つのプロンプトとして表示** では、同じエージェントを単一のプロンプトとして表示します。これは、ステップを利用できない場所で実行される内容です。
引き継ぎがあるエージェントには、発信者を引き継ぐ先のエージェントが一覧表示されます。いずれかの選択を解除すると、レビューにはその引き継ぎが設定されないことが表示されます。

空のエージェントと、プラットフォームが作成したデフォルトのスターターエージェントを除き、すべてのエージェントは最初から選択されています。不要なエージェントの選択を解除し、名前、音声、設定、またはプロンプトの選択を編集してから、**インポート** を選択します。エージェントはAPI接続とナレッジを関連付けた状態で保存されます。番号に割り当てる前にエージェントを開いて確認し、通話を試してください。

## フロー、スカッド、エージェント転送

複数ステップのエージェントは構造を維持します。通話中にステップと引き継ぎがどのように実行されるかについては、[エージェントステップ](/ja/guides/agent-steps)を参照してください。

- **フローはステップになります。** Retell の複数プロンプト状態と会話フロー、Bland のパスウェイ、ElevenLabs のワークフローは、エージェントのステップとしてインポートされます。元のグローバルプロンプトは共有指示になります。
  - 各ノードの指示、固定文言、収集する値、ツールが引き継がれます。
  - 文言で記述されたエッジ条件は、エージェントが判断する遷移になります。収集した値またはウェブフック応答に対する単一の比較（`age >= 18`）は、厳密にチェックされる遷移になります。
  - ウェブフックノードと関数ノードは、ステップ開始時にツールを実行します。グローバルノードにはどのステップからも到達できます。独自の次の経路を持たないノードは、中断したステップに通話を戻します。
  - 転送ノードと終了ノードは、通話を転送または終了する最終ステップになります。Retell の転送ノードでは、転送が成立しない場合に備えて次の経路が維持されます。
  - 次のステップを選択するだけの分岐ノードは、可能な場合は前のステップに統合されます。統合できない場合は、注記付きの独立したステップとして維持されます。
  - ステップとして扱うには大きすぎるフロー、または ThunderPhone でステップとして表現できないフローは、すべてのステップを列挙した単一のプロンプトとして、注記付きでインポートされます。
- **スカッド、エージェント転送、エージェント切り替えは引き継ぎになります。** Vapi スカッドの各メンバーは、メンバー名とスカッド名を使用した個別のエージェントとしてインポートされます。最初のメンバーがスカッドへの通話に応答し、他のメンバーには引き継ぎで接続します。ElevenLabs の別エージェントへの転送と Retell のエージェント切り替えも、引き継ぎになります。発信者は通話を維持し、それまでの会話も引き継がれます。
  - 引き継ぎで到達した通話では、最初に応答したエージェントの通話設定（留守番電話、通話制限、言語、録音）が維持されます。引き継ぎ先のエージェントは、独自のプロンプト、ステップ、ツール、音声を使用します。
  - 引き継ぎ先として指定できるのは、同じインポートでインポートされたエージェントのみです。別のエージェントがインポートに含まれていない場合、または選択を解除した場合は、注記にその旨が表示され、後でエージェント設定から引き継ぎを追加できます。

## インポートされる内容

<Tabs>
  <Tab title="Vapi">
    **キーを取得する**

    1. [dashboard.vapi.ai/org/api-keys](https://dashboard.vapi.ai/org/api-keys)
       （組織設定 → APIキー）を開きます。
    2. キーを作成し、**プライベート**を選択します。パブリックキーでは
       アシスタントを一覧表示できません。
    3. ダイアログにコピーします。Vapiキーにはスコープがないため、この用途だけで作成した場合は、インポート後にVapiでキーを削除してください。

    | Vapi フィールド | ThunderPhone |
    |---|---|
    | `model.messages[system]` | プロンプト |
    | `firstMessage`, `firstMessageMode` | プロンプト内の開始メッセージ、最初に話す主体 |
    | `voice.provider` + `voiceId` | 最も近いカタログ音声。可能な範囲でVapiライブラリを検索し、一致信頼度を表示 |
    | `transcriber.language`, `languages`, keywords/keyterms | 言語と音声認識用語彙 |
    | `model.model` | マッピングされません。インポートしたエージェントはPro推論とStandard聴覚で開始します |
    | `model.tools`, `toolIds`, `toolRefs` (function, apiRequest) | API接続。Vapiリクエストエンベロープとアシスタントレベルのサーバーフォールバックは保持されます |
    | `transferCall` の宛先 | プロンプト内の電話転送。SIP、アシスタント、動的な宛先は確認用に報告されます |
    | `handoff` ツール | 同じ実行でインポートされた名前付きアシスタントへの引き継ぎ |
    | `endCall`, `dtmf` | 組み込み機能 |
    | Google Calendar、Google Sheets、`sms` | 必要なThunderPhone連携またはSMS設定とともに報告されます |
    | Slack | インポートされないものとして報告されます。ThunderPhoneはまだSlackに接続できません |
    | `query` および `knowledgeBase` ツール、旧式の `knowledgeBaseId` | アクセス可能なアップロード済みファイルをドキュメントとして含むナレッジベース |
    | `endCallMessage`, `endCallPhrases`, `voicemailMessage`、アイドルメッセージプラン、タイムアウトフック | プロンプトセクション、ボイスメール設定、無音設定 |
    | `maxDurationSeconds`、録音オプトアウト | 最大通話時間（Vapiのデフォルトである600秒は維持）。録音オプトアウトは確認ページで報告されます |
    | Squads | メンバーごとに1つのエージェント。それぞれのプロンプト、オーバーライド、音声、ツール、ナレッジを保持します。`assistantDestinations` はメンバー間の引き継ぎになり、最初のメンバーがSquadの電話番号を保持します |
    | カスタムナレッジ/モデルサーバー、コンプライアンスプラン、その他のフック、ワークフロー、未対応のホスト型ツール | 具体的な確認または再構築アクションとともに報告されます。元のプランと認証情報は保存されません |
  </Tab>
  <Tab title="Retell">
    **キーを取得する**

    1. [dashboard.retellai.com/apiKeys](https://dashboard.retellai.com/apiKeys)
       （システム設定 → APIキー）を開き、**キーを作成**を選択します。
    2. **権限を制限**を有効にし、**エージェント**、**ナレッジベース**、
       **電話**を**読み取り**に設定します。ほかのグループはすべて未選択のままにします。インポーターがRetellに書き込むことはありません。
    3. ダイアログにキーをコピーします。

    | Retell フィールド | ThunderPhone |
    |---|---|
    | 最新の公開済みエージェントと、その正確な Retell LLM / フローバージョン | 公開済みのプロンプトと動作。より新しい下書きはレビュー対象として報告 |
    | Retell LLM の `general_prompt`、`begin_message`、`start_speaker`、状態 | 共通指示、開始時の動作、状態ごとに1つのステップ。そのツール、遷移、各遷移で収集した値を含む |
    | 会話フローの `global_prompt`、ノード、コンポーネント、グローバルノード、エッジ | 共通指示とステップ。収集した値に対する方程式条件を正確に確認し、開始時の正確なテキストと転送ステップを保持 |
    | `agent_swap` ツールとノード | 同じ実行でインポートされた Retell エージェントへのハンドオフ |
    | カスタムツール | クエリパラメータ、タイムアウト、Retell/args 専用のリクエスト形式を含む API 接続。署名の変更、およびデフォルト以外の発話、再試行、応答変数、フォームエンコード設定は報告 |
    | `transfer_call`、`end_call`、`press_digit` | 条件付き転送（内線を含む）と組み込み機能。推論による転送とウォーム転送の違いは報告 |
    | `check_availability_cal`、`book_appointment_cal` | 連携で再接続する Cal.com ツールとして報告。Retell の認証情報は引き継がれません |
    | `send_sms`、MCP | SMS または MCP の設定手順とともに報告 |
    | `voice_id`（`11labs-`、`openai-`、`cartesia-`、…） | 最も近いカタログ音声 |
    | `language`（1つのロケール、多言語モード、またはロケールリスト） | 主要言語と追加言語 |
    | `model` / `s2s_model` | マッピングされません。インポートしたエージェントは Pro インテリジェンスと Standard ヒアリングで開始 |
    | `knowledge_base_ids`（URL、ドキュメント、テキストソース） | ドキュメントを含むナレッジベース |
    | `default_dynamic_variables`、サポートされるシステム変数 | ThunderPhone の変数デフォルトと、通常の通話コンテキスト指示 |
    | `voicemail_option`、`end_call_after_silence_ms`、`max_call_duration_ms`、`ring_duration_ms`、録音無効、`boosted_keywords` | ボイスメールの動作、通話制限、録音設定、プロンプト用語 |
    | `webhook_url`、カスタム LLM エンジン、サポートされないフローノード、ベンダー専用設定 | 黙って削除せず、手動レビュー対象として報告 |
  </Tab>
  <Tab title="ElevenLabs エージェント">
    **キーを取得**

    1. [elevenlabs.io/app/settings/api-keys](https://elevenlabs.io/app/settings/api-keys)
       を開き、**APIキーを作成**を選択します。
    2. 権限で**エージェントプラットフォーム: 読み取り**
       （表示される場合は**ナレッジベース: 読み取り**も）を付与します。インポーターに必要な権限はこれだけです。
    3. ダイアログにキーをコピーします。

    | ElevenLabs フィールド | ThunderPhone |
    |---|---|
    | `conversation_config.agent.prompt.prompt`、エージェントワークフローノード、順序付き分岐条件 | 共通指示とワークフローノードごとに1つのステップ。ツールノードはステップ開始時にツールを実行し、式による分岐はレビュー対象としてラベル付け |
    | `first_message`、`language`、`language_presets` | 開始メッセージ、主要言語と追加言語、翻訳済みの開始メッセージ |
    | `prompt.llm` | マッピングされません。インポートしたエージェントは Pro インテリジェンスと Standard ヒアリングで開始 |
    | `tts.voice_id` | 最も近いカタログ音声 |
    | ワークフローステップに接続されたツールを含む webhook `tool_ids` | 移植可能な本文/クエリパラメータを含む API 接続。固定ベンダーパラメータと認証情報は削除され、報告 |
    | 通話終了、電話転送、キーパッド、ボイスメール用の `built_in_tools` | 組み込み機能、転送ルール、ボイスメールの動作。SIP と動的な転送先は再構築用として報告 |
    | 別のエージェントへの転送（`transfer_to_agent`、エージェントワークフローノード） | 同じ実行でインポートされた ElevenLabs エージェントへのハンドオフ |
    | ワークフローステップのナレッジを含む `knowledge_base` の URL/テキスト/ファイル/フォルダーエントリ | ナレッジベースドキュメント。フォルダーは展開され、テキスト/ファイルの内容は ID で取得 |
    | `turn.silence_end_call_timeout`、`conversation.max_duration_seconds`、`asr.keywords`、`privacy.record_voice` | 無音および最大時間の制限、発音用語、録音をオフにした設定はレビューページで報告 |
    | カスタム LLM、MCP サーバー、手順、ワークスペース webhook、ステップごとのモデル/音声/言語オーバーライド、ElevenLabs 予約ツール | インポート後に必要な操作とともに報告 |
  </Tab>
  <Tab title="Bland">
    **キーを取得**

    1. [app.bland.ai/dashboard/settings](https://app.bland.ai/dashboard/settings)を開きます。
    2. 表示される**APIキー**をコピーします（Blandではアカウントごとにキーが1つあり、スコープは設定されません。必要に応じて後でローテーションしてください）。
    3. ダイアログに貼り付けます。

    Blandの表示ラベルは、エージェントの識別情報として扱われません。インポーターは、エージェントが名乗る内容をあいさつとプロンプトから判断します。パスウェイの場合は、グローバルプロンプトと開始ノードを使用します。この確認を実行できない場合や名前が見つからない場合、インポートされるプロンプトは中立的なままです。

    | Bland フィールド | ThunderPhone |
    |---|---|
    | Web エージェントの `prompt`、`first_sentence`、`language`、`model`、`voice`、`pathway_id` | プロンプト、開始メッセージ、言語、ティア、最も近い音声、紐付けられた公開済みパスウェイフロー |
    | Persona の本番バージョン | パーソナリティとオーケストレーションのプロンプト、音声、言語、発信者先行設定、録音、最大通話時間、デフォルトのツールとナレッジ。紐付けられたパスウェイが1つ含まれます。複数パスウェイのルーティングは手動設定用に報告されます |
    | カスタムツールとパスウェイツール（URL、メソッド、スキーマ、ヘッダー、本文変数） | API接続。Bland Secret の参照が報告され、再度追加する必要があります |
    | Cal.com、HubSpot、Salesforce、Google Calendar、Google Sheets のツール | 接続して有効化する必要がある対応する ThunderPhone 連携を示します |
    | Slack ツール | インポートされないものとして報告されます。ThunderPhone はまだ Slack に接続できません |
    | 着信番号の詳細（`prompt`、`pathway_id` / バージョン、ツール、転送、キーワード、リクエストデータ） | 着信番号ごとに1つのエージェント。通話変数のデフォルト値と転送ルールを含みます |
    | 番号に紐付けられているかどうかにかかわらず、すべてのパスウェイ | 利用可能な場合は公開済みバージョン。未公開の下書きは明確にフラグ付けされます |
    | グローバルプロンプト、Default、Knowledge Base、Transfer Call、End Call、Webhook、Wait for Response ノード、エッジ、ループ条件、グローバルノード、抽出変数、固定の発話 | 共通の指示とノードごとの1ステップ。常時実行可能なステップ、収集する値、正確な発話、Webhook ステップ、転送、通話終了を含みます。応答フィールドまたは抽出変数に対する Webhook 応答パスウェイは正確に検証されます |
    | インラインナレッジテキストと解決可能なナレッジ ID | ナレッジドキュメント。テキストまたはファイルを読み取れない項目は、手動アップロード用に報告されます |
    | `max_duration`、`wait_for_greeting`、録音設定 | 通話上限、発話順、録音設定 |
    | `webhook`、動的データ検索、複数パスの Persona ルーティング、未対応のノード設定、v2 エージェント | 必要な手動対応とともに報告されます |
    | 着信番号 | Bland では Bland と Twilio アカウントのどちらが所有しているか示されないため、両方の選択肢とともに一覧表示されます |
  </Tab>
</Tabs>

## ThunderPhoneで対応が必要な項目

レビュー画面の下部にあるレポートには、移行されなかった番号、Webhook、
ツールが一覧表示されます。残りの内容は各エージェントのメモで確認できます。これらを
合わせると、移行されなかった項目とその理由をすべて確認できます。

- **電話番号。** インポート後、各ソース番号にはその場所と実行できる操作が表示されます。
  - **自身の Twilio または Telnyx アカウント内**（たとえば、Vapi または ElevenLabs に接続した Twilio 番号）: 管理者はその番号をインポートしたエージェントに移行できます。そのアカウントを保持する [VoIP 接続](/ja/guides/bring-your-own-numbers) がまだない場合は、先に接続してください。変更前に、番号への通話が旧プラットフォームに送られなくなることを確認ステップで通知します。
    次に ThunderPhone は、通信事業者アカウント内で番号を自身に向けます（Twilio 番号は ThunderPhone の SIP トランクに参加し、Telnyx 番号は ThunderPhone の SIP 接続に移動します）。その後、有効化のために短いテスト通話を発信します。元に戻すには、通信事業者アカウントに番号を残したまま **電話とウェブ** で番号を削除し、旧プラットフォームで再度インポートしてください。
  - **SIP トランク上**: トランクを [SIP 接続](/ja/guides/voip-providers) として接続し、**電話とウェブ** で番号をインポートします。
  - **プラットフォームが販売した番号**（そこで購入した Vapi、Retell、Bland の番号）: ThunderPhone は移行できません。通信事業者へポーティングしてインポートするか、ThunderPhone の番号を取得してインポートしたエージェントに割り当ててください。
  - Bland では、番号が Bland 自身のものか Twilio アカウントのものかを示さないため、Bland の番号には両方の選択肢が表示されます。
- **エージェントごとの Webhook。** ThunderPhone は組織ごとに署名付き Webhook を配信します。[Webhook](/ja/webhooks/overview) で設定してください。
- **ベンダー保存の認証情報。** 表示されていたツールヘッダーはコピーされます。旧プラットフォームが ID で保存していた認証情報にはフラグが付きます。API 接続のヘッダーに追加してください。
- **組み込み連携。** 旧プラットフォームがホストしていたカレンダー、CRM、メッセージングツール（たとえば Cal.com の予約）には、代わりに接続する ThunderPhone の連携が表示されます。認証情報は引き継がれません。レビューでは、インポートされなかったツールを使用するようエージェントに指示しているプロンプトにもフラグが付きます。
- **テキストメッセージ。** ThunderPhone エージェントは自身の Twilio または Telnyx 番号を通じてテキストメッセージを送信します。エージェントの設定で SMS を設定してください。
- **同等の機能がないツール**（プラットフォーム固有の自動化）は、何も通知なく除外されないよう一覧表示されます。
- **通話変数。** `{{name}}` プレースホルダーは、プラットフォームで設定されていたデフォルト値とともに保持されます。ThunderPhone は[通話開始時に渡される変数](/ja/guides/call-variables)から値を入力し、それ以外の場合は空欄のままにします。レビューには渡す必要がある変数が一覧表示されます。
- **通話制限と録音。** 最大通話時間がインポートされます。ソースエージェントで変更されていない場合は、プラットフォーム固有のデフォルト値が設定されます。Vapi と ElevenLabs は 10 分、Retell は 1 時間、Bland は 30 分です。正の数ではないソース値は最大時間なしでインポートされ、そのことがレビューに表示されます。ThunderPhone の範囲外にある無音時間および最大通話時間の制限は調整され、レビューの注記にはソース値とインポート後の値が記載されます。ソースエージェントで通話録音がオフになっていた場合、エージェントのレビュー注記には、録音オフでインポートされたか、録音をオフにする機能がまだ利用できない場合は録音オンでインポートされたかが表示されます。

## インポート時に変更される内容

以前のプラットフォームでデフォルトのままにしていた一部の設定は、代わりにThunderPhoneの
デフォルトが適用されます。レビューでは、両プラットフォームで異なる設定のみを、エージェントごとに1つのメモとして
詳細に表示します。以下のThunderPhoneの
値はデフォルトであり、エージェントごとに変更できます。

| 設定 | 以前のプラットフォームのデフォルト | ThunderPhoneのデフォルト |
|---|---|---|
| 発信通話の呼び出し時間 | Retell: 30秒 | 60秒 |
| 無音通話の終了 | Retell: 10分後に切断、ElevenLabs: しない | 15秒ごとに確認（まだ誰も話していない場合は約6秒後、発信者がエージェントに待つよう求めた場合は少なくとも1分後）、1分間無音が続いたら切断 |
| 通話録音 | Blandの着信番号とペルソナ: オフ | オン。サポートにお問い合わせいただくか、利用可能な場合はエージェント設定で変更 |
| 留守番電話の場合 | Blandのペルソナ: 切断 | エージェントがプロンプトに基づいて判断 |

以前のプラットフォームで変更した設定は、設定した内容のままインポートされ、この一覧には表示されません。唯一の例外は「切断しない」という無音通話設定です。この設定はデフォルト値と同様に表示され、エージェントは ThunderPhone の確認を維持します。インポート後、これらの設定はエージェント設定で変更できます。

## キーを使わないインポート

**代わりにエクスポートした JSON を貼り付け**を選択し、プラットフォームの API
またはダッシュボードがエクスポートしたオブジェクトを、1 つのオブジェクトまたは JSON リストとして貼り付けます。

- **Vapi** — アシスタントオブジェクト（`GET /assistant/{id}`）、Squad オブジェクト
  （`GET /squad/{id}`）、またはいずれかのリスト。ID のみで紐付けられたツールと
  ナレッジファイルを解決するにはキーが必要です。Vapi では Workflows が廃止されたため、貼り付ける前に
  Workflow を Squad に変換してください。
- **Retell** — エージェントオブジェクト（`GET /get-agent/{id}?version=...`）**とともに**、
  同じバージョンの Retell LLM（`GET /get-retell-llm/{id}?version=...`）
  または同じリスト内の会話フローオブジェクト。インポーターは ID とバージョンでリンクし、
  公開ステータスが存在する場合は貼り付けられた公開済みエージェントを優先し、
  単体の LLM またはフローは生成された名前でインポートします。
- **ElevenLabs** — エージェントオブジェクト（`GET /v1/convai/agents/{id}`）。現在の
  エクスポートでは通常、Webhook ツールとナレッジドキュメントは ID のみで参照されます。
  ペーストすると、それらの項目は未解決として報告されます。完全にインポートするには API キーを使用してください。
- **Bland** — ウェブエージェント、`/v1/agents` のレスポンス、またはパスウェイオブジェクト。
  貼り付けた各オブジェクトは、2 つが同じ ID を共有している場合でも、それぞれ独自のエージェントとしてインポートされます。
  API アクセスが必要なツールとナレッジ ID は削除されるのではなく、手動設定用に一覧表示されます。

IDでのみ参照され、貼り付け内容に含まれていない項目は、メモに一覧表示されます。

## インポート後

1. 各エージェントを開き、メモを確認します。
2. エージェントのページで **テスト通話** をクリックするか、Zeus にテストを依頼します。
3. 番号を移行するか、新しい番号を追加します（上記の **電話番号** を参照）。
4. リクエストテスターで各 API 接続をテストします。
5. ナレッジドキュメントのインデックス作成が完了していることを確認します。
6. 以前のエージェントで使用していた場合は、組織の Webhook を設定します。

インポーターは [REST API](/api-reference/agent-imports) でも利用できます。

インポートによって移行先が固定されることはありません。エージェントはいつでも無料でオープンファイルとしてエクスポートできます。[ThunderPhoneを離れる](/ja/guides/leaving-thunderphone)を参照してください。
