电话系统接入操作手册

通过将 Audio Agent 与电话系统集成，让你的语音 Agent 直接接听电话。用户拨打电话即可与 Agent 语音对话。
本期支持范围：

• Twilio 服务商 · 呼入（用户打进来）· 号码呼入 ，适合「客户直接拨打一个电话号码，就能和 Agent 通话」的场景。
• 第三方 SIP 转接呼入,适合已有呼叫中心或外呼系统，接通客户后把通话转接给 Agent 的场景。

一、开始之前（前置准备）

1. 一个已开启语音能力的 Agent
   Agent 需已配置语音模型、音色与开场白（在 Agent 的语音设置中完成）。电话接通后播放的正是这里配置的开场白。
2. 一个 Twilio 账号
   • 若走「公网号码呼入」：需要你自己的 Twilio 账号，并已购买一个电话号码。
   • 若走「第三方 SIP 转接」：使用 GPTBots 平台提供的共享 SIP 端点，无需自备号码。
3. 进入路径：开发空间 → 你的 Agent → 集成 → 电话系统。

二、绑定公网电话号码（最常用）

适合「客户直接拨打一个电话号码，就能和 Agent 通话」的场景。

步骤

1. 服务提供商：选择 Twilio · Elastic SIP Trunk。

2. 填写 Twilio 账号信息：

   字段	填写内容	说明
   Account SID	ACxxxxxxxx…	Twilio 控制台首页可见
   Auth Token	你的 Twilio Auth Token	用于校验来电请求签名（X-Twilio-Signature），防止伪造呼入
   Elastic SIP Trunk 域名	your-trunk.pstn.twilio.com	你的 Trunk 域名
   接入区域	就近选择（US1 / IE1 / DE1 / AU1 / JP1 / SG1）	影响通话延迟
   绑定电话号码	+1 415 555 0188	你在 Twilio 购买的号码，含国家码
   呼叫方向	仅呼入	本期仅支持呼入

3. 点击 保存。保存成功后，「Webhook」区域会自动生成一条 媒体 / 回调 URL。

4. 把这条 URL 回填到 Twilio：
   复制「媒体 / 回调 URL」→ 打开 Twilio 控制台该号码的配置 → 找到 A CALL COMES IN（当有来电时） → 方式选 Webhook、粘贴该 URL、方法用 HTTP POST → 保存。

5. 完成。用手机拨打该号码，应能听到 Agent 的开场白并开始对话。

三、第三方 SIP 系统转接呼入（呼叫中心 / PBX）

适合「已有呼叫中心或外呼系统，接通客户后把通话转接给 Agent」的场景。此时 GPTBots 本身作为一个 SIP 端点，纯 SIP 互联、无需电话号码。

该区域仅当服务商为 Twilio、且平台已开通共享 SIP Domain 时显示。

你会看到的信息

1. Agent SIP 地址（SIP URI）· 唯一语音入口
   你的第三方系统在接通客户后，将通话通过 SIP REFER 转接到此地址，即按「呼入」接入同一个 Agent。
2. SIP 用户名 / SIP 密码（保存配置后自动生成）
   你的 PBX / 软电话用这组用户名和密码在 SIP Domain 上鉴权。

   ⚠️ 密码仅在生成 / 重新生成时显示一次，平台不保存。请立即复制妥善保管；遗忘只能点「重新生成」换一组新的。

3. 支持能力：SIP REFER / 转接、自定义头（X-headers）传参、TLS / SRTP。

使用指南

在你的 SIP 系统里，用上面的 SIP 用户名 + 密码 向 Agent SIP 地址 发起 / 转接呼叫即可。若同时也绑定了公网号码，二者接入的是同一个 Agent，无需重复配置。

四、进阶：传入终端用户身份，做个性化

默认情况下 Agent 按来电号码识别来电者。如果你的系统已有自己的用户体系，可以在 SIP 呼叫时通过自定义头（X-headers） 携带用户标识：

• 头名称：X-User-Id
• 作用：Agent 会据此关联该用户的属性与历史对话，实现个性化应答（例如按会员等级、历史订单回答）。

未传 X-User-Id 时，Agent 以主叫号码作为来访标识，仍可正常对话，只是不做基于用户档案的个性化。

五、拨打测试与查看记录

1. 拨打绑定号码（或从第三方系统转接），确认：
   • 能听到开场白；
   • 能正常多轮对话；
   • 说话可以打断 Agent 正在播报的内容。
2. 在 日志 / 对话记录 页可查看该通电话：
   • 会话来源标记为 Twilio，并显示来电号码；
   • 完整的多轮问答记录；
   • 运行时序（logtree）：开始节点 → 各轮对话 / 工具调用 → 结束语音。

六、常见问题（FAQ）

Q1. 拨打号码没反应 / 直接挂断？

• 检查「媒体 / 回调 URL」是否已正确回填到 Twilio 号码的 A CALL COMES IN，方法为 HTTP POST。
• 检查 Auth Token 是否填对——填错会导致来电验签失败被拒接。
• 确认 Agent 的语音能力已配置完整（模型 / 音色 / 开场白）。

Q2. 提示凭据不足 / 无法接通？

• 确认账户积分充足：积分耗尽会拒接来电。
• 确认未超并发通话上限：超限的新来电会被拒接。

Q3. SIP 密码忘了怎么办？

• 点「重新生成」获取新密码（旧密码即时失效），并同步更新到你的 SIP 系统。密码只显示一次，请及时保存。

Q4. 单通电话最长多久？

• 单通通话最长 60 分钟，超过将自动结束。

Q5. 能让 Agent 主动打电话出去吗？

• 本期仅支持呼入（用户打进来），暂不支持外呼。

七、注意事项

• 本期仅支持 Twilio 服务商与 呼入 方向。
• 通话计费与普通语音 Agent 一致，按用量扣减积分。
• 修改集成配置（号码、凭据等）后需重新保存生效。