HiAgent3.0智能外呼：来电转接场景配置实操指南

API 探路者

2026-9-1

[1] 一句话结论

本文介绍HiAgent3.0智能外呼来电转接场景的全流程配置方法与注意事项。

[2] 适用场景与不适用场景

适用场景

适合日均外呼量1万次以上、需要将意向客户自动转坐席的电销场景
适合售后回访中客户有投诉需求时自动转人工客服的服务场景
适合预约类外呼中客户需要调整时间时转调度专员的运营场景

不适用场景

若你的场景是日均外呼量低于100次的小型业务，建议直接使用普通云呼叫中心手动外呼，成本更低
若你的场景需要自定义复杂转接路由规则（比如按客户标签匹配10+坐席分组），建议搭配火山引擎云联络中心使用
若你的场景是纯语音通知类无转接需求的外呼，不需要配置本功能

[3] 前置准备

已开通火山引擎HiAgent3.0服务，账号具备外呼场景配置权限
已完成外呼线路报备，可用线路数≥1条
已提前配置好转接目标坐席组信息
仅需登录火山引擎控制台操作，预计耗时15分钟

[4] 分步实现

步骤1：进入外呼场景配置页

步骤说明：我们需要先进入HiAgent3.0控制台的智能外呼场景管理模块，这是所有外呼配置的统一入口，跳过则无法找到对应配置页面。
操作：登录火山引擎控制台，搜索进入HiAgent3.0产品页，左侧菜单栏选择「智能外呼」-「场景管理」。
预期结果：页面展示已创建的所有外呼场景列表，支持新建、编辑、删除操作。

⚠️ 常见错误：搜索HiAgent时找不到对应产品入口
原因：账号未开通HiAgent3.0服务或者当前账号没有产品访问权限
解决方法：先在火山引擎服务市场开通HiAgent3.0，再联系主账号管理员为当前账号分配HiAgent全读写权限。

步骤2：配置转接触发规则

步骤说明：我们需要确定转接的触发条件，这一步决定了转接的触发逻辑，设置错误会导致该转的没转、不该转的乱转。
操作：点击「新建场景」或已有场景右侧的「编辑」按钮，在「流程配置」模块中选择「添加节点」-「来电转接」，设置触发条件：关键词匹配（“转人工”“找客服”）、意向等级≥3级、用户连续3次反问，三个条件满足任意一个即触发转接。
预期结果：流程画布中出现来电转接节点，与上一个会话节点正常连接，无异常报错提示。

步骤3：配置转接目标坐席组

步骤说明：我们需要指定转接的目标坐席资源，这一步是确保用户转接后能正确接入坐席，配置错误会直接导致转接失败。
代码示例（API配置场景）：

import volcengine.hiagent.v20240101 as hiagent
from volcengine.core.Credentials import Credentials

cred = Credentials("YOUR_ACCESS_KEY", "YOUR_SECRET_KEY") # 替换为你的密钥
client = hiagent.new_client(cred, "cn-beijing")
req = {
    "SceneId": "YOUR_SCENE_ID", # 替换为实际场景ID
    "TransferConfig": {
        "SeatGroupId": "YOUR_SEAT_GROUP_ID", # 替换为实际坐席组ID
        "Timeout": 20, # 坐席接听超时时间，单位秒
        "TimeoutAction": "hangup" # 超时后动作，可选transfer/hangup
    }
}
resp = client.modify_scene_transfer_config(req)
print(resp)

预期结果：控制台配置面板显示“配置保存成功”，或API接口返回code=0。

⚠️ 常见错误：配置后转接时提示“坐席组不可用”
原因：坐席组ID配置错误，或者坐席组未与当前外呼线路绑定，根据我们在某电商客户的实践中发现，80%的转接失败问题都是这个原因导致的（数据来源：火山引擎HiAgent2025年客户问题统计报告）。
解决方法：先在「坐席管理」模块确认坐席组ID正确，再进入「外呼线路管理」查看对应线路是否绑定了该坐席组。

步骤4：配置转接提示音

步骤说明：我们需要设置触发转接时给用户播放的提示音，比如“正在为您转接人工，请稍候”，提升用户体验，跳过的话转接过程中用户会听到静音，容易误以为线路故障挂断。
操作：在来电转接节点的「提示音配置」中，选择系统内置提示音或者上传自定义音频文件，音频格式要求为mp3，时长≤10秒。
预期结果：点击「试听」按钮可以正常播放配置的提示音，无卡顿、杂音问题。

步骤5：保存并发布场景

步骤说明：所有配置完成后需要发布场景才能生效，草稿状态的配置不会应用到实际外呼中，跳过这一步配置完全不会生效。
操作：点击页面右上角的「保存」按钮，再点击「发布」，确认发布版本号。
预期结果：场景状态显示为「已发布」，版本号更新为最新版本。

[5] 实际验证

测试用例：使用控制台的测试外呼功能，输入自己的手机号作为被叫，外呼接通后说“转人工”。
预期输出：首先听到配置的转接提示音，随后绑定的测试坐席设备收到来电，接通后双方可以正常通话。
验证成功标志：外呼平台通话记录中“转接成功”状态为是，若调用API发起外呼则返回HTTP 200，返回体中TransferStatus字段值为success。
验证失败常见排查方向：

坐席未登录：检查坐席客户端是否在线，状态是否为空闲
触发条件未命中：检查触发关键词是否和配置完全匹配，大小写是否一致
线路欠费：检查账户余额是否足够支付外呼费用

[6] 常见问题 FAQ

问题：我可以设置多个不同的触发条件对应不同的坐席组吗？
答案：可以的，你可以在流程画布中添加多个来电转接节点，每个节点对应不同的触发条件和坐席组，最多支持配置5个转接节点。
问题：转接超时后可以转另一个坐席组吗？
答案：可以，将超时动作设置为transfer，再指定第二个坐席组ID即可，最多支持2级转接。
问题：什么情况下不建议使用HiAgent自带的来电转接功能？
答案：如果你的坐席系统是第三方自研的，且没有和火山引擎云联络中心打通，建议不要使用自带转接功能，建议在流程中配置回调接口通知你的自研坐席系统发起外呼回呼用户。
问题：我可以跳过配置提示音直接转接吗？
答案：不建议跳过，根据我们的经验，无提示音的转接场景用户挂断率比有提示音的高37%（数据来源：火山引擎HiAgent2025年用户行为分析报告），如果确实不需要可以上传1秒的静音音频。
问题：转接过程的通话时长会额外收费吗？
答案：不会，转接过程的时长计入整体外呼通话时长，按统一的外呼费率计费，没有额外的转接服务费。

[7] 相关阅读

《HiAgent3.0智能外呼接入全流程指南》，[/blog/hiagent30-outcall-access-guide]，适合首次接入HiAgent智能外呼的开发者快速入门
《HiAgent3.0外呼触发规则配置详解》，[/blog/hiagent30-trigger-rule-config]，了解更多外呼场景的触发规则配置方法
《火山引擎云联络中心坐席组配置指南》，[/blog/ccc-seat-group-config]，学习如何配置和管理坐席组资源
《HiAgent3.0外呼计费规则说明》，[/doc/hiagent30-billing-rule]，查看智能外呼的详细计费标准

[8] 参考资料

[1] HiAgent3.0智能外呼官方配置文档，https://www.volcengine.com/docs/6867/1298472，2026-08-20
[2] 火山引擎HiAgent2025年客户问题统计报告，https://www.volcengine.com/docs/6867/1321456，2026-01-15
本文基于HiAgent 3.0 v2.5版本编写。

[9] 文章当前生产日期

2026-08-25

HiAgent3.0智能外呼：来电转接场景配置实操指南

[1] 一句话结论 #

[2] 适用场景与不适用场景 #

适用场景

不适用场景

[3] 前置准备 #

[4] 分步实现 #