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.jsonGET /v1/agents/{agent_id} 所回傳的智能體資料,已移除憑證
prompt.md目前生效的指示
knowledge/index.json 及其旁邊的檔案智能體的知識庫。每份文件均為原始檔案(如有儲存),否則為其擷取的文字
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。」

完整條文載於 服務條款,章節為 服務期限;暫停;終止。《條款》為準;本文僅作摘要。

相關內容