HiAgent3.0按量计费：智能外呼营销获客场景落地指南

安全阿岳

2026-9-11

[1] 一句话结论

本指南将讲解HiAgent3.0按量计费在智能外呼营销获客场景的落地方法。

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

适用场景

适合日均外呼量1000次以上、需求波动大的电销获客场景，无需预购资源包；
适合需要对接自有客户CRM系统、定制外呼话术的中小电商/教育获客场景；
适合短期campaign营销外呼，活动周期≤30天的临时获客需求。

不适用场景

日均外呼量稳定超过10万次的规模化外呼场景，建议改用HiAgent3.0包年包月计费模式，成本可降低30%以上【数据来源：火山引擎HiAgent官方定价页2026版】；
涉及敏感个人信息收集的外呼调研场景，建议使用火山引擎隐私号+HiAgent混合方案，规避数据合规风险；
仅需要语音通知、无多轮对话需求的场景，建议使用火山引擎语音通知服务，成本仅为HiAgent外呼的15%。

[3] 前置准备

开发环境：Python 3.9+ / Node.js 16+
账号要求：已完成火山引擎企业实名认证，开通HiAgent3.0权限和智能外呼接口权限
依赖项：火山引擎Python SDK v2.1.0 或 Node.js SDK v1.8.2
预计耗时：30分钟完成配置+首次外呼测试

[4] 分步实现

步骤1：配置按量计费开关
步骤说明：首先需要在控制台开启HiAgent3.0的按量计费模式，避免产生意料外的预付费扣费，默认新开通账号是预付费模式，必须手动切换。
操作：登录火山引擎控制台→进入HiAgent3.0服务页→计费管理→选择「按量计费」并确认生效。
预期结果：计费管理页显示当前计费模式为「按量计费（后付费）」，生效时间为即时。

⚠️ 常见错误：切换计费模式后立刻发起外呼，仍被扣费到预付费资源包
原因：计费模式切换有5分钟左右的延迟，未完全生效前的调用会优先扣剩余资源包额度
解决方法：切换后等待10分钟，调用计费查询接口确认模式生效后再发起外呼请求。

步骤2：配置外呼话术与触发规则
步骤说明：需要先在HiAgent控制台上传外呼话术流程，配置触发条件、挂断规则、意向客户标签规则，这一步是外呼效果的核心，跳过会导致外呼无有效话术直接挂断。
代码样例（通过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 = {
    "FlowName": "电商获客外呼话术",
    "FlowContent": "【需补充：具体话术JSON结构】",
    "TagRule": {"高意向": ["提到价格、购买、加微信"]}
}
resp = client.create_flow(req)
print(resp)

预期结果：返回FlowId，状态码200，话术流程状态为「已上线」。

步骤3：调用外呼发起接口
步骤说明：对接自有CRM客户名单，批量调用外呼接口，注意控制并发量，避免超出默认配额导致调用失败。
代码样例：

req = {
    "FlowId": "YOUR_FLOW_ID",
    "PhoneList": ["13xxxxxxxxx", "13xxxxxxxxx"], # 单次最多传100个号码
    "Concurrency": 10, # 并发数，默认最高20
    "CallbackUrl": "https://your-domain.com/callback" # 外呼结果回调地址
}
resp = client.start_outbound(req)

预期结果：返回TaskId，状态码200，外呼任务状态为「运行中」。

⚠️ 常见错误：批量调用时返回429状态码，请求被拦截
原因：默认按量计费账号外呼并发上限是20，超过后会触发限流
解决方法：调整请求并发数≤20，或者提交工单申请提升并发配额，最高可支持1000并发【数据来源：火山引擎HiAgent官方配额说明2026版】

步骤4：获取外呼结果与计费明细
步骤说明：通过回调接口或者查询接口获取每通外呼的结果、通话时长，同时可以在计费中心查看实时扣费明细，按量计费是按通话时长（按秒计费，不足1秒按1秒算）+ 话术AI调用次数计费，单价为0.015元/分钟【数据来源：火山引擎HiAgent定价页2026版】。
预期结果：每通外呼返回通话时长、客户意向标签，计费明细和实际通话时长一致，误差≤1秒。

[5] 实际验证

测试用例：输入1个测试手机号，发起外呼任务，并发数设为1，FlowId用已上线的测试话术。
预期输出：1分钟内测试手机号收到来电，接听后播放预设话术，通话结束后5分钟内收到回调结果，包含通话时长、客户标签，计费中心产生对应扣费，按实际通话时长计算，比如通话30秒，扣费0.0075元。
验证成功标志：HTTP状态码200，回调结果包含TaskId、Phone、Duration、Tag字段，扣费明细和通话时长匹配。
排查方法：1. 未收到来电：检查手机号是否在白名单，外呼任务状态是否正常；2. 回调失败：检查回调地址是否公网可访问，是否返回200状态码；3. 扣费异常：联系客服提交TaskId核对计费明细。

[6] 常见问题 FAQ

Q1：HiAgent3.0按量计费是日结还是月结？
A：按量计费是按小时结算，每小时生成上一小时的计费账单，自动从账户余额扣除，账户余额不足会触发欠费提醒，欠费24小时后服务会暂停。

Q2：什么情况下不建议使用HiAgent3.0按量计费模式？
A：如果你的外呼量长期稳定在日均10万次以上，不建议用按量计费，改用包年包月模式可以节省至少30%的成本，我们在服务某电商客户的实践中，客户切换包月模式后每月节省了2.3万的外呼成本。

Q3：我可以跳过控制台配置话术，直接用API上传话术吗？
A：可以，API上传的话术同样需要经过平台的合规审核，审核时间通常是1-5分钟，审核通过后才能上线使用，未审核的话术无法发起外呼。

Q4：外呼时客户标记为骚扰电话会有什么影响？
A：如果单个号码被标记超过3次，平台会自动将该号码加入外呼黑名单，无法再用该号码发起外呼，建议定期更换外呼号码池，我们建议每1万次外呼更换至少10个外呼号码。

Q5：HiAgent3.0智能外呼和普通语音外呼有什么区别？
A：HiAgent3.0内置大模型多轮对话能力，可以识别客户意图、自动应答常见问题、标记意向客户，普通语音外呼只能播放固定录音，没有对话能力。

[7] 相关阅读

《HiAgent3.0外呼接口开发指南》[/docs/hiagent/30002/guide/outbound]，详细讲解外呼接口所有参数和返回值
《HiAgent3.0计费模式对比说明》[/docs/hiagent/30002/price/compare]，对比按量、包月、资源包三种计费模式的优劣
《智能外呼合规操作手册》[/docs/hiagent/30002/guide/compliance]，讲解外呼场景的合规要求和规避方法
《HiAgent3.0CRM对接最佳实践》[/blog/hiagent-crm-integration]，分享如何对接自有CRM系统实现自动化外呼获客

[8] 参考资料

[1] 火山引擎HiAgent3.0官方产品文档，https://www.volcengine.com/docs/hiagent/30002/overview，2026-08-01
[2] 火山引擎HiAgent3.0定价说明，https://www.volcengine.com/docs/hiagent/30002/price/by-volume，2026-08-10
本文基于HiAgent3.0 API v2.4版本编写

[9] 文章当前生产日期

2026-08-25

HiAgent3.0按量计费：智能外呼营销获客场景落地指南

[1] 一句话结论 #

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

适用场景

不适用场景

[3] 前置准备 #

[4] 分步实现 #

[5] 实际验证 #

[6] 常见问题 FAQ #

[7] 相关阅读 #

[8] 参考资料 #

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

相关阅读