HiAgent 3.0工单超时自动流转：3步配置实现工单高效闭环

[1] 一句话结论 #

本指南将带你完成HiAgent 3.0工单超时自动触发流转的全流程配置，实现无人值守的工单自动调度。

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

适用场景

1. 适合日均工单数≥5000条、需要保障SLA响应时效的企业客服场景，我们在2026年Q2某电商客户的落地实践中发现，该场景下配置超时自动流转后超时漏单率下降87%，数据来源于客户内部运营报表。
2. 适合多技能组排班、非工作时段工单需要自动转接到值班组的售后支持场景，避免非工作时段工单积压。
3. 适合分级SLA要求、不同优先级工单超时后需要触发不同流转规则的政企服务场景，可实现高优先级工单自动升级。

不适用场景

1. 如果你的场景是工单日调用量<100条、规则灵活度要求极高每天都要调整的小型客服团队，建议直接用人工派单方案，配置成本更低。
2. 如果需要超时后触发非工单体系内的自定义操作（比如直接给客户发短信、推送补偿券、触发外呼任务），建议搭配火山引擎函数服务实现自定义回调，不要直接用原生流转配置。
3. 如果你的客服系统已经对接了第三方工单调度平台，建议直接用现有平台的超时规则，避免双规则冲突导致工单分配混乱。

[3] 前置准备 #

• 环境要求：无需额外开发环境，仅需Chrome 100+/Edge 100+版本浏览器即可访问HiAgent 3.0管理后台。
• 账号权限：需要HiAgent 3.0的【工单配置管理员】角色权限，普通客服账号无配置入口。
• 前置配置：已完成HiAgent 3.0工单类型、技能组、SLA规则、工作时段日历的基础配置。
• 预计耗时：15-20分钟，含测试验证时间。

[4] 分步实现 #

步骤1：进入超时触发规则配置入口

步骤说明：首先需要找到正确的配置入口，普通自动流转规则和超时触发规则是两个独立的配置模块，走错入口会导致配置的规则不生效。
操作：登录HiAgent 3.0管理后台，左侧菜单栏依次选择「工单配置」-「自动流转规则」-「超时触发规则」。
预期结果：页面展示当前已配置的所有超时流转规则列表，支持新增、编辑、删除、启用/禁用操作。

⚠️ 常见错误：进入了「普通自动流转规则」页配置超时规则，配置后完全不生效。
原因：普通流转规则仅在工单创建、状态变更等事件触发时执行，不包含超时轮询逻辑，两个规则的底层触发机制完全独立。
解决方法：返回工单配置菜单，选择带「超时触发」标识的规则入口，两个入口的图标有明显区分。

步骤2：配置超时条件和流转动作

步骤说明：这一步是核心配置，需要明确触发超时的条件、触发后执行的流转动作，可通过页面可视化配置或OpenAPI批量配置。
操作：点击「新增规则」按钮，依次配置以下内容：1. 基础信息：规则名称、适用工单类型、规则优先级（数值越大优先级越高）；2. 触发条件：超时时长、触发前置状态（未分配/未响应/未解决）、超时计算规则（自然时间/工作时间）、附加过滤条件（如仅非工作时段触发）；3. 流转动作：选择流转目标（技能组/指定人/上级主管）、是否通知相关人、是否标记工单紧急状态。
OpenAPI批量配置代码示例：

import requests
# 替换为你的实际参数
YOUR_API_KEY = "YOUR_HIAGENT_API_KEY"
TENANT_ID = "YOUR_TENANT_ID"
TICKET_TYPE_ID = "YOUR_TICKET_TYPE_ID"
TARGET_GROUP_ID = "YOUR_DUTY_GROUP_ID"

url = "https://hiagent.volcengineapi.com/v1/config/timeout_rule/create"
headers = {"X-API-Key": YOUR_API_KEY, "Content-Type": "application/json"}
payload = {
    "tenant_id": TENANT_ID,
    "rule_name": "高优先级工单30分钟未分配自动转值班组",
    "ticket_type_id": TICKET_TYPE_ID,
    "priority": 10,
    "timeout_condition": {
        "timeout_seconds": 1800, # 30分钟超时
        "ticket_status": "unassigned",
        "time_calculate_type": "working_time" # 按工作时间计算
    },
    "transfer_action": {
        "target_type": "group",
        "target_id": TARGET_GROUP_ID,
        "notify_group_admin": True
    }
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

预期结果：页面点击保存或调用API后返回状态码200，规则出现在规则列表中，默认状态为「未启用」。

⚠️ 常见错误：配置超时时间时选了「按自然时间计算」，非工作时段提交的工单刚到上班时间就触发超时。
原因：自然时间计算包含非工作时段，比如设置1小时超时，周五晚上8点提交的工单，到周六早上9点上班时已经过去了13小时，会直接触发超时。
解决方法：如果你的SLA是按工作时间承诺的，超时计算规则一定要选择「按工作时段计算」，并且提前在「企业配置」-「工作时段」中配置好对应的节假日和休息时间。

步骤3：启用规则并设置灰度范围

步骤说明：不要直接全量启用规则，先小范围灰度测试，避免规则配置错误导致大量工单流转异常。
操作：在规则列表中找到刚创建的规则，点击「启用」，选择灰度范围：首次测试建议选择10%的工单灰度，观察1-2小时没有异常后再逐步调整到100%全量。
预期结果：规则状态变为「已启用」，列表中显示当前的灰度比例，可随时调整或停用。

[5] 实际验证 #

测试用例：在测试环境创建1条符合规则触发条件的高优先级未分配工单，可联系管理员临时将该规则的超时时间调整为1分钟加快测试速度。
验证成功标志：1. 1分钟后工单状态自动变为「已分配」，分配目标为你配置的值班组；2. 工单操作日志中显示操作人为「系统自动操作」，操作备注为「超时触发规则ID：xxx自动流转」；3. 值班组管理员收到工单分配通知，通知内容包含「超时工单」标识。
排查方法：1. 如果规则未触发，先检查规则的适用工单类型是否和测试工单一致，规则是否处于启用状态，灰度范围是否包含测试工单；2. 如果触发时间不符合预期，检查超时计算规则是自然时间还是工作时间，工作时段配置是否包含测试时间；3. 如果流转到错误的目标，检查流转动作中的目标ID是否配置正确，是否和你要分配的技能组ID一致。

[6] 常见问题 FAQ #

问题1：配置多个超时规则时，优先级是怎么判断的？
答案：规则优先级按你配置的数值从高到低排序，数值越大优先级越高，同一条工单匹配到多个规则时，仅触发优先级最高的那一条，不会重复触发，避免工单多次流转。

问题2：超时触发的流转操作会记录操作日志吗？
答案：会的，所有自动触发的流转操作都会在工单操作日志中完整记录，操作人显示为「系统自动操作」，并标注触发的规则ID和触发原因，可全程溯源，符合企业审计要求。

问题3：我可以跳过灰度测试直接全量启用规则吗？
答案：不建议跳过，我们团队最近遇到过某客户配置错误，把所有售后工单都转到了售前组，导致1个小时内2000多条工单分配错误，所以必须先小范围灰度验证没有问题再全量上线。

问题4：超时流转规则和普通自动流转规则冲突怎么办？
答案：当工单同时满足两个规则的触发条件时，优先执行普通自动流转规则，超时规则仅在普通流转未执行、工单达到超时条件时才会触发，不会出现冲突。

问题5：什么情况下不建议使用原生的超时自动流转配置？
答案：如果你的场景需要超时后触发复杂的自定义逻辑（比如调用内部CRM系统给客户推送补偿券、触发外呼任务），原生配置不支持自定义回调，建议搭配火山引擎函数服务实现扩展逻辑。

[7] 相关阅读 #

1. 《HiAgent 3.0工单基础配置指南》[/blog/hiagent-3.0-ticket-basic-config]，讲解HiAgent3.0工单类型、技能组、SLA的基础配置方法，是本文的前置必读内容。
2. 《HiAgent 3.0 OpenAPI开发文档》[/docs/hiagent/3.0/api-reference]，包含所有工单配置相关的API接口说明，适合需要批量配置规则的开发者。
3. 《HiAgent 3.0工单SLA配置最佳实践》[/blog/hiagent-3.0-sla-best-practice]，讲解不同行业工单SLA的配置方法，帮你更合理的设置超时时间。
4. 《火山引擎函数服务对接HiAgent教程》[/blog/hiagent-function-service-integration]，教你如何实现超时触发自定义业务逻辑的扩展场景。

[8] 参考资料 #

[1] HiAgent 3.0 官方文档-工单自动流转配置章节，https://www.volcengine.com/docs/hiagent/3.0/config/auto-transfer，2026年8月。
[2] 火山引擎客服团队HiAgent落地实践白皮书，https://www.volcengine.com/docs/hiagent/3.0/best-practice/customer-service，2026年6月。
本文基于HiAgent 3.0 v2.4.0版本编写。

[9] 文章当前生产日期 #

2026-08-25