ThunderPhone v3 現已上線。自助開通,每分鐘 2¢ 起。查看公告

Using the dashboard

離開 ThunderPhone

將智慧體匯出為開放檔案,使用程式設計智慧體技能在 LiveKit Agents、Pipecat、Vapi 或 Retell 上重新建置,並下載你的通話紀錄與錄音。

你隨時都可以離開 ThunderPhone。每個智慧體都可免費匯出為包含開放檔案的 zip 檔,而一項技能可協助你的程式開發智慧體在 LiveKit Agents、Pipecat、Vapi 或 Retell 上重新建立它。本頁說明你可以帶走哪些內容、如何匯出,以及在另一端需要重新完成哪些工作。

你可以帶走的內容

項目方式
一個智慧體:指示、工具、轉接號碼、步驟、設定、號碼路由和 Webhook智慧體匯出,每個智慧體一個 zip 檔
智慧體的知識檔案包含在智慧體匯出檔中
通話紀錄與逐字稿通話匯出,每次請求最多 1,000 通
錄音每次請求一段錄音,依通話分別取得
你自有電信業者上的電話號碼它們從未離開你的電信業者。請參閱電話號碼

匯出智慧體

在 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 下方。每分鐘匯出超過 30 次時,API 會回應 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 and the files beside it智慧體的知識。每份文件會是儲存的原始檔案;若沒有原始檔案,則為其擷取的文字
numbers.json路由至此智慧體的號碼,包括撥入和撥出號碼,以及任何釘選的版本或變體
webhooks.json限於此智慧體的 Webhook 端點,不包含其密鑰
README.md各檔案的說明

超過 25 MB 的知識檔案會被略過,整個匯出超過 100 MB 的部分也會被略過。每個項目都會列於 manifest.json 中,並附上下載該檔案的 端點: GET /v1/knowledge/documents/{document_id}/original。

絕不會納入的內容

  • 憑證值。 工具的標頭只會列出名稱。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 會傳回單一通話錄音的短效 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 終止協議。付款逾期可能會暫停服務;但單憑此事絕不會終止協議,也不會觸發刪除客戶資料。關於資料,條款指出:「在正式終止後,供應商將在六十(60)天內返還或刪除客戶資料,但須遵守客戶的匯出權利、備份週期、法律保全、法律要求的保存義務、DPA,以及任何已簽署的 BAA。」

完整內容請參閱服務條款中的 服務期限;暫停;終止。服務條款為準;此處僅為摘要。

相關內容