從其他平台匯入智慧體
使用 API 金鑰或 JSON 匯出檔，從 Vapi、Retell、ElevenLabs Agents 或 Bland 匯入智慧體、工具和知識庫，檢閱對應設定後即可匯入。
如果你的智慧體位於 Vapi、Retell、ElevenLabs Agents 或 Bland，匯入工具會擷取它們，將每個欄位對應至 ThunderPhone，並在建立任何內容前向你顯示結果。
開始匯入
- 開啟 智慧體 並選擇 匯入（或在空白智慧體頁面上選擇 從 Vapi、Retell、ElevenLabs 或 Bland 匯入）。
- 選擇平台。
- 依照對話方塊中的編號步驟，在該平台建立金鑰（系統會為你開啟正確的設定頁面）並貼上金鑰；或切換至 貼上匯出的 JSON，貼上該平台控制台或 API 中的一個或多個智慧體物件。
- 選擇 擷取我的智慧體。擷取及對應通常不到一分鐘；你可以離開頁面，之後透過任務匣返回查看。
檢閱方案
每個智慧體都會顯示名稱、已配對的語音（及配對信心度）、智慧層級、隨附的工具與知識庫，以及轉換過程中任何變更的備註。展開列即可閱讀提示詞：
- 重寫 —— 依照提示詞指南風格整合為一份連貫的提示詞，並保留來源中的每個電話號碼、URL、工具名稱與預留位置。
- 結構化 —— 將來源設定依標題排列，內容與擷取結果完全一致。當無法驗證重寫內容時，系統會自動使用此選項。
取消勾選你不想匯入的智慧體（測試副本預設為未勾選），編輯名稱、語音、層級或提示詞選項，然後選擇 匯入。建立完成的智慧體會在建置工具中開啟，並附上其 API 連線與知識庫。
匯入的內容
取得金鑰
- 開啟 dashboard.vapi.ai/org/api-keys （組織設定 → API 金鑰）。
- 建立金鑰並選擇 私人——公開金鑰無法列出 智慧體。
- 將金鑰複製到對話方塊中。Vapi 金鑰沒有範圍限制；如果你僅為此用途建立金鑰，請在匯入後於 Vapi 刪除該金鑰。
| Vapi 欄位 | ThunderPhone |
|---|---|
model.messages[system] | 提示詞 |
firstMessage, firstMessageMode | 提示詞中的開場白；由誰先說話 |
voice.provider + voiceId | 最接近的語音目錄音色（顯示比對信心度） |
transcriber.language | 主要語言 |
model.model | 智慧等級 |
model.tools / toolIds（function、apiRequest） | API 連線 |
transferCall 目的地 | 提示詞中的轉接區段（內建轉接） |
endCall, dtmf | 內建功能 |
query 工具（knowledgeBases[].fileIds）和舊版 knowledgeBaseId | 知識庫，並將已上傳的檔案作為文件 |
endCallMessage, endCallPhrases, voicemailMessage, messagePlan.idleMessages | 提示詞區段；語音信箱訊息設定 |
silenceTimeoutSeconds | 靜默掛斷 |
maxDurationSeconds, server.url, squads, workflows, sms/ghl/make/code/mcp 工具 | 已回報，未匯入 |
取得金鑰
- 開啟 dashboard.retellai.com/apiKeys （系統設定 → API 金鑰），然後選擇 建立金鑰。
- 開啟 限制權限，並將 智慧體、知識庫 和 電話 設為 讀取。其他所有群組均維持未勾選；匯入工具絕不會寫入 Retell。
- 將金鑰複製到對話方塊中。
| Retell 欄位 | ThunderPhone |
|---|---|
Retell LLM general_prompt, begin_message, start_speaker | 提示詞；開場白；由誰先說話 |
states + starting_state | 提示詞中的依序通話流程 |
對話流程 global_prompt + 節點 | 依序通話流程；轉接節點也會成為轉接規則 |
general_tools 自訂項目 | API 連線 |
transfer_call, end_call, press_digit | 提示詞轉接 + 內建功能 |
voice_id（11labs-, openai-, cartesia-, …） | 最接近的語音目錄音色 |
language | 主要及其他語言 |
model / s2s_model | 智慧等級 |
knowledge_base_ids（網址、文件、文字來源） | 含文件的知識庫 |
voicemail_option, end_call_after_silence_ms, boosted_keywords | 語音信箱設定；靜默掛斷；提示詞詞彙 |
webhook_url, max_call_duration_ms（低於 60 分鐘預設值時）、自訂 LLM 引擎、send_sms、MCP | 已回報，未匯入 |
取得金鑰
- 開啟 elevenlabs.io/app/settings/api-keys 並選擇 建立 API 金鑰。
- 在權限下，授予 Agents Platform：讀取 （如果顯示，也授予 Knowledge base：讀取）；匯入工具不需要其他權限。
- 將金鑰複製到對話方塊中。
| ElevenLabs 欄位 | ThunderPhone |
|---|---|
conversation_config.agent.prompt.prompt | 提示詞 |
first_message, language | 開場白；主要語言 |
prompt.llm | 智慧等級 |
tts.voice_id | 最接近的語音目錄音色 |
類型為 webhook 的 tools / tool_ids | API 連線（查詢或本文結構描述） |
系統工具 end_call, transfer_to_number, keypad | 內建功能 + 提示詞轉接 |
knowledge_base 網址／文字／檔案項目 | 知識庫：網址項目會成為網址文件；文字和檔案項目會依 ID 擷取，並以其擷取出的文字匯入 |
turn.silence_end_call_timeout | 靜默掛斷 |
conversation.max_duration_seconds, 用戶端工具、MCP | 已回報，未匯入 |
取得金鑰
- 開啟 app.bland.ai/dashboard/settings。
- 複製該處顯示的 API 金鑰（Bland 每個帳戶只有一組金鑰；其沒有範圍限制，因此你也可以選擇之後輪替金鑰）。
- 將其貼到對話方塊中。
網頁智慧體在 Bland 中沒有名稱，因此匯入工具會依據 問候語（「Hi, this is Nova…」）或提示詞（「You are Nova…」）為其命名。
| Bland 欄位 | ThunderPhone |
|---|---|
網頁智慧體 prompt, first_sentence, language, model, voice | 提示詞；開場白；語言；等級；最接近的音色 |
自訂 tools（name、url、method、input_schema、headers） | API 連線 |
撥入號碼 prompt 或 pathway_id | 每個撥入號碼對應一個智慧體 |
| 每個 pathway，無論是否附加至號碼 | 每個 pathway 對應一個智慧體 |
| Pathway 節點和邊（Default、Knowledge Base、Transfer Call、End Call、Webhook） | 依序通話流程；知識庫節點文字會成為文件；轉接和 Webhook 會成為內建功能及 API 連線 |
transfer_phone_number | 轉接區段 |
max_duration, webhook | 已回報，未匯入 |
| Bland 擁有的號碼 | 已回報為無法攜碼 |
需要在 ThunderPhone 中處理的項目
審查頁面底部的報告會列出所有未移轉的項目及其原因：
- 電話號碼。 你向電信業者持有的號碼可作為 VoIP 號碼連接。平台持有的號碼無法移轉；請取得新號碼並將其附加至匯入的智慧體。
- 每個智慧體的 Webhook。 ThunderPhone 會依組織傳送已簽署的 Webhook；請在 Webhook 下設定。
- 供應商儲存的憑證。 可見的工具標頭會一併複製。舊平台以 id 儲存的憑證會被標示；請將其加入 API 連線的標頭。
- 沒有對應項目的工具（簡訊傳送、平台專屬自動化）會列出，確保不會有任何項目遭到無聲略過。
- 通話時長上限。 ThunderPhone 沒有每個智慧體的通話最長時限；請改用靜音掛斷設定及提示詞的結束規則。
未使用金鑰匯入
選取 貼上匯出的 JSON，並貼上你的平台 API 或控制台匯出的物件，可貼上一個物件或 JSON 清單：
- Vapi —— 智慧體物件（
GET /assistant/{id}）。透過toolIds附加的工具及知識檔案需要金鑰才能解析。 - Retell —— 智慧體物件（
GET /get-agent/{id}）以及其 Retell LLM（GET /get-retell-llm/{id}）或同一清單中的對話流程物件；匯入工具會依 id 將其連結。單獨貼上的 LLM 或流程會以自動產生的名稱匯入。 - ElevenLabs —— 智慧體物件（
GET /v1/convai/agents/{id}）；其 Webhook 工具會內嵌包含，因此不會留下未解析的項目。 - Bland —— 網頁智慧體、
/v1/agents回應，或路徑物件。
僅以 id 參照且未包含在貼上內容中的任何項目，都會列在備註中。
匯入後
- 開啟每個智慧體並閱讀其備註。
- 從建置器撥打測試電話。
- 附加電話號碼。
- 使用請求測試工具測試每個 API 連線。
- 確認知識文件已完成建立索引。
- 如果舊智慧體使用組織 Webhook，請設定組織 Webhook。
匯入工具也可透過 REST API 使用。