HiAgent 3.0智能外呼：阶梯定价规则配置实战指南

[1] 一句话结论 #

本指南将帮你快速完成HiAgent 3.0智能外呼阶梯定价规则的配置，规避常见计费错误。

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

适用场景

1. 企业月外呼接通量10万分钟以上，需要按采购量级享受阶梯优惠的营销/政务通知外呼场景；
2. 按业务线独立核算外呼成本，需要配置多档位阶梯计费规则的集团客户场景；
3. 有固定年度外呼预算，需要预购流量包享受更低单价的规模化外呼场景。

不适用场景

1. 月外呼接通量低于1万分钟的小型客户，本方案不适用，建议改用按量付费模式，参考[/doc/hiaiagent3.0/按量付费配置指南]；
2. 仅需要固定并发线路无需按分钟计费的场景，本方案不适用，建议选择并发包月套餐，参考[/doc/hiaiagent3.0/并发包月套餐配置]；
3. 外呼场景涉及敏感行业（如金融催收、医疗药品营销）的客户，本定价规则不适用，需单独咨询商务定制方案。

[3] 前置准备 #

• 已完成HiAgent 3.0企业版账号开通，拥有财务及计费配置管理员权限；
• Python 3.9+ 或 Node.js 18+ 开发环境（如需调用API配置）；
• HiAgent 3.0 SDK v1.2.2及以上版本；
• 预计配置耗时15-20分钟。

[4] 分步实现 #

步骤1：查询当前账号可选购的阶梯档位

步骤说明：首先要确认账号所属区域支持的阶梯档位，避免配置已下线的旧档位导致规则失效。如果跳过这一步直接配置旧档位，会触发规则校验失败，配置流程无法继续。
代码示例：

import volcengine.hiaiagent.v20230801 as hiaiagent

client = hiaiagent.new_client()
client.set_ak("YOUR_ACCESS_KEY") # 替换为你的AccessKey
client.set_sk("YOUR_SECRET_KEY") # 替换为你的SecretKey

req = {
    "Product": "outbound_call",
    "BillType": "step_package"
}
resp = client.describe_bill_quotas(req)
print(resp)

预期结果：返回当前支持的5档阶梯价格列表，包含分钟数、总价、单价、有效期字段，其中1000万分钟档位单价低至0.1元/分钟（数据来源：阿里云官方智能外呼计费文档）。

⚠️ 常见错误：调用接口返回403权限错误，提示"无计费配置查询权限"
原因：使用的账号仅拥有开发权限，没有财务管理员权限。
解决方法：联系企业主账号管理员在访问控制中为当前账号添加"HiAgent计费配置管理员"角色。

步骤2：配置阶梯定价触发规则

步骤说明：这一步是设置当外呼累计用量达到对应档位阈值时自动触发下一档单价，或者预购对应档位的流量包。如果跳过阈值配置，会默认按最高档0.2元/分钟计费，我们在某电商客户的实践中发现，未配置阈值的客户平均每月会多支出30%以上的外呼成本。
代码示例：

req = {
    "RuleName": "2026年度外呼阶梯计费规则",
    "StepConfig": [
        {"StepThreshold": 100000, "UnitPrice": 0.20}, # 10万分钟档单价0.2元/分钟
        {"StepThreshold": 500000, "UnitPrice": 0.18}, # 50万分钟档单价0.18元/分钟
        {"StepThreshold": 1000000, "UnitPrice": 0.16}, # 100万分钟档单价0.16元/分钟
        {"StepThreshold": 5000000, "UnitPrice": 0.14}, # 500万分钟档单价0.14元/分钟
        {"StepThreshold": 10000000, "UnitPrice": 0.10} # 1000万分钟档单价0.1元/分钟
    ],
    "EffectiveTime": "2026-08-25 00:00:00", # 规则生效时间
    "ExpireTime": "2027-08-24 23:59:59" # 规则失效时间
}
resp = client.create_step_bill_rule(req)
print(resp)

预期结果：返回规则ID，状态为"已生效"。

⚠️ 常见错误：提交规则后返回参数校验失败，提示"阶梯阈值必须按升序排列"
原因：配置的StepThreshold数值没有从小到大依次填写。
解决方法：调整StepConfig数组顺序，确保阈值从低到高排列，且每个阈值对应上一档的总分钟数。

步骤3：绑定外呼任务到阶梯计费规则

步骤说明：创建完规则后需要把对应的外呼任务绑定到该规则，否则规则不会生效，仍会按默认计费方式结算。我们团队最近遇到过多个客户完成规则配置后忘记绑定任务，导致连续2个月按最高档计费的情况。
代码示例：

req = {
    "TaskIds": ["YOUR_TASK_ID_1", "YOUR_TASK_ID_2"], # 替换为你的外呼任务ID
    "RuleId": "YOUR_RULE_ID_FROM_STEP2" # 替换为步骤2返回的规则ID
}
resp = client.bind_bill_rule_to_task(req)
print(resp)

预期结果：返回绑定成功的任务ID列表，绑定失败的任务ID会单独列出并标注失败原因。

[5] 实际验证 #

测试用例：创建一个测试外呼任务，绑定刚配置的规则，发起10次接通的外呼，累计通话时长15分钟。
验证方法：进入HiAgent控制台-计费中心-账单明细页面，查询近1小时的外呼账单。
成功标志：账单明细中对应外呼记录的计费规则ID与你创建的规则ID一致，15分钟的计费单价为0.2元/分钟，总费用3元，未接通的呼叫不计入费用。
常见失败原因排查：

1. 如果单价不对：检查规则生效时间是否覆盖当前测试时间，阶梯阈值是否按升序配置；
2. 如果规则未生效：检查任务是否正确绑定到规则，账号是否有对应档位的流量包余量；
3. 如果账单未生成：账单有15分钟延迟，等待15分钟后再查询即可。

[6] 常见问题 FAQ #

Q1：我之前买的5万分钟低档位套餐还能继续用吗？
A：2026年7月30日之前已经开通的存量低档位套餐可以正常使用至到期，到期后续费只能选择10万分钟及以上的阶梯档位。如果你的用量不够10万分钟，建议转用按量付费模式。

Q2：什么情况下不建议使用阶梯定价套餐？
A：如果你的月外呼接通量波动较大，且连续3个月月均用量低于8万分钟，不建议购买阶梯流量包，因为流量包有效期1年，到期未用完的余量会直接清零，反而会造成成本浪费，这种情况建议选择按量付费模式。

Q3：阶梯定价的计费是按自然月累计还是按流量包购买时间累计？
A：按你配置的规则生效周期累计，如果你购买的是年度流量包，就按1年有效期内的累计接通分钟数计算档位，不满1分钟按1分钟计算，未接通的呼叫不计入累计量。

Q4：可以同时配置多个阶梯定价规则吗？
A：可以，但是同一个外呼任务只能绑定一个计费规则，不同业务线的任务可以绑定不同档位的规则，实现独立核算。

Q5：号码线路费用包含在阶梯定价里吗？
A：不包含，号码线路费用需要单独向服务商采购，不计入上述阶梯定价的费用内，具体线路价格可以咨询对应的商务经理。

[7] 相关阅读 #

1. 《HiAgent 3.0按量付费模式配置指南》[/doc/hiaiagent3.0/20240912001]：介绍按量付费模式的配置方法，适合小用量客户
2. 《HiAgent 3.0并发包月套餐介绍》[/doc/hiaiagent3.0/20241015003]：讲解并发包月套餐的适用场景和配置步骤
3. 《HiAgent 3.0计费账单查询接口文档》[/doc/hiaiagent3.0/api/20240820007]：提供计费账单查询的API调用示例
4. 《HiAgent 3.0外呼任务创建教程》[/doc/hiaiagent3.0/20240730002]：手把手教你创建外呼任务并绑定计费规则

[8] 参考资料 #

[1] 智能外呼如何计费,有哪些计费项，https://help.aliyun.com/zh/outboundbot/product-overview/billing，2026-08-20
[2] 阿里云智能外呼Agent新规：2026年起新购续费门槛升至10万分钟，http://m.itbear.com.cn/html/2026-07/1455546.html，2026-07-15
本文基于HiAgent 3.0 智能外呼API v2.1版本编写

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

2026-08-25