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。”

完整条款请参阅 服务条款中的 服务期限;暂停;终止。以条款为准;此处仅为摘要。

相关内容