Skip to main content
本指南将带您了解通过四个 REST 调用,让您的 AI 电话智能体接听第一通电话的流程。
您需要一个 ThunderPhone 账户。 注册免费,不到一分钟即可完成。更喜欢点击而不是使用 curl? 控制台快速入门无需编写任何代码,即可完成同样的首次通话。

第 1 步:获取 API 密钥

1

登录

2

前往密钥

在控制台中前往 组织 → 密钥
3

创建密钥

点击 创建密钥,为其命名,然后复制 sk_live_... 值。原始密钥仅显示一次——请立即将其存储到您的密钥管理器中。
遇到问题?创建服务器 API 密钥将逐步详细介绍 此流程,应用内智能副驾还可以为您实时突出显示每个控件。
在本指南中,请将 sk_live_YOUR_API_KEY 替换为您刚刚复制的值。该密钥会自动识别您的组织,因此您无需在 URL 中填写组织 ID。

第 2 步:创建智能体

智能体定义 AI 如何处理对话——提示词、语音、产品层级、工具以及小组件可用资格。
产品层级:spark 针对成本优化,bolt 针对速度优化, storm-base / storm-extra 则针对复杂提示词的智能能力优化。请参阅 智能体了解完整对比。

第 3 步:配置电话号码

此调用会向 ThunderPhone 的演示号码池请求一个号码,并将您的新智能体分配为入站处理程序。(如需从 VoIP 提供商引入您自己的号码,请参阅VoIP 连接。)
您的新号码初始状态为 status="provisioning",并会在几秒内变为 active;当您关闭浏览器时,该号码已可接听来电。

第 4 步(可选):设置 webhook

如需接收实时事件(动态通话路由、通话后处理),请添加一个 webhook 端点。 仅订阅您需要的事件。
响应中包含一个一次性 secret ——请将其复制到您的密钥 管理器中。使用该密钥验证传入请求中的 X-ThunderPhone-Signature 标头(请参阅 Webhook 概述)。

第 5 步:测试您的智能体

拨打您刚刚配置的号码。智能体会接听电话、进行自我介绍, 并遵循您的提示词。 通话结束后检查通话:
查看特定通话的详细信息,以获取转录文本和录音 URL:

后续步骤

添加函数工具

让您的智能体在对话期间调用您的 API。

发起外呼

从您自己的代码中触发通话。

处理 Webhook

实时响应通话事件。

完整 API 参考

记录了所有公共端点。