HiAgent按量计费：智能外呼回访场景落地指南

[1] 一句话结论 #

本指南将讲解HiAgent按量计费模式在智能外呼客户回访场景的正确使用方法。

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

适用场景

1. 适合月度外呼量在5000-100万次、话术迭代频率>2次/周的企业客户回访场景，按调用量付费无需预存大额费用。
2. 适合有阶段性外呼需求（如大促后售后回访、问卷调研），峰值调用量是日常3倍以上的弹性场景，无需为闲置资源付费。
3. 适合新业务试水外呼回访场景，不确定长期调用量的中小团队，可随时启动/停服无违约金。

不适用场景

1. 不适合月度外呼量稳定超过120万次的场景，我们在多个电商客户的实践中发现这种场景下包年包月方案成本可降低15%以上，建议参考[HiAgent包年包月计费方案]。
2. 不适合涉及敏感个人信息传输的外呼场景，建议参考[火山引擎隐私计算外呼解决方案]，满足等保2.0三级要求。
3. 不支持需要对接自有SIP线路、自主控制外呼路由的场景，建议使用[火山引擎语音服务外呼平台]。

[3] 前置准备 #

• 开发环境与版本要求：Python 3.9+ / Node.js 18+，HiAgent SDK v1.2.0及以上版本
• 账号与权限要求：已完成火山引擎企业实名认证，开通HiAgent按量计费权限、智能外呼产品权限
• 依赖项：提前完成外呼号码资质备案，话术模板预审核通过
• 预计耗时：2小时（不含资质审核时间）

[4] 分步实现 #

步骤1：开通HiAgent按量计费权限

步骤说明：登录火山引擎控制台进入HiAgent产品页，在「计费管理」模块开启按量计费开关，这一步是确认计费模式优先级，跳过的话会默认走预付费额度扣减，预付费额度耗尽后服务会直接中断。
操作指引：控制台路径：产品与服务->人工智能->HiAgent->计费管理->选择按量计费->确认开通
预期结果：计费模式栏显示「当前生效：按量计费」，账户余额≥100元即可正常调用。

⚠️ 常见错误：开通后首次调用提示「计费模式未生效」
原因：开通后有1-5分钟的权限缓存同步期，不是实时生效
解决方法：开通后等待5分钟再发起调用，若仍报错可提交工单让运维刷新账号权限

步骤2：上传并审核外呼回访话术模板

步骤说明：需要先将回访话术上传到HiAgent平台完成合规审核，未审核的模板调用会被系统拦截，避免违反《通信短信息和语音呼叫服务管理规定》导致外呼号码被封禁。
代码示例：

import volcengine_hiagent
# 初始化客户端，替换为自己的AK/SK
client = volcengine_hiagent.Client(
    access_key="YOUR_ACCESS_KEY",
    secret_key="YOUR_SECRET_KEY",
    region="cn-beijing"
)
# 提交话术模板审核
resp = client.create_call_template(
    template_name="618大促售后回访模板",
    content="您好，这里是XX官方售后，请问您对本次收到的商品满意吗？满意请按1，不满意请按2，需要人工服务请按0",
    scene_type="customer_return_visit",
    is_voice_navigation=True
)
print("模板ID：", resp.template_id)

预期结果：返回状态码200，得到唯一模板ID，模板状态显示「审核中」，审核周期通常为1-2小时。

⚠️ 常见错误：话术模板多次审核不通过
原因：模板包含诱导消费、询问敏感个人信息（身份证号、银行卡号）的内容，或者未明确标注所属企业身份
解决方法：参考[HiAgent外呼话术审核规范]修改模板，提交时备注「客户回访场景」可将审核时效缩短到30分钟内

步骤3：调用按量计费外呼接口发起回访任务

步骤说明：调用批量外呼接口传入用户号码列表和已审核的模板ID，按量计费模式仅对成功接通的通话计费，未接通、空号、用户拒接都不产生费用，无需担心无效调用成本。
代码示例：

resp = client.batch_start_call(
    template_id="YOUR_TEMPLATE_ID", # 替换为上一步拿到的模板ID
    phone_list=["13XXXXXXXXX", "13XXXXXXXXX"], # 替换为目标用户号码
    call_time_window=["9:00-12:00", "14:00-20:00"], # 仅在指定时间段外呼，避免骚扰用户
    max_retry_times=1 # 未接通时重试1次
)
print("外呼任务ID：", resp.call_task_id)

预期结果：返回任务ID，任务状态显示「运行中」，可在控制台实时查看外呼进度。

步骤4：核对按量计费明细

步骤说明：外呼任务完成后可在计费中心查看明细，确认费用扣减是否正确，目前智能外呼回访场景按量计费定价为0.02元/次（数据来源：火山引擎HiAgent 2026年公开定价页）。
操作指引：控制台路径：费用中心->账单管理->明细账单->筛选产品为HiAgent
预期结果：每成功接通1次通话扣减0.02元，未接通记录无费用产生。

[5] 实际验证 #

我们可以用以下测试用例验证配置是否正确：
测试用例：上传已通过审核的简单回访话术模板，传入10个可正常接通的测试手机号，发起批量外呼任务，设置重试次数为1。
预期输出：外呼任务成功率≥95%，成功接通的通话对应计费明细每条扣减0.02元，接口返回HTTP 200状态码，控制台可查看所有通话的录音和转写文本。
验证成功标志：任务完成率100%，未接通号码无计费记录，用户收到的外呼号码为提前备案的官方号码。
常见失败排查方法：

1. 任务启动失败：先检查AK/SK是否有外呼接口调用权限，再确认模板是否已经通过审核，未审核的模板会直接拦截调用。
2. 计费异常：检查是否有重复调用的情况，是否触发了单日10万次的默认调用上限，超出上限的调用会被限流且不计费。
3. 接通率低于60%：检查外呼号码是否被标记为骚扰号码，是否在非允许时间段发起了呼叫，可提交工单申请更换外呼号码段。

[6] 常见问题 FAQ #

Q1：HiAgent按量计费智能外呼是按什么维度计费的？
A：仅按成功接通的通话次数计费，未接通、空号、用户拒接、通话时长不足3秒都不产生费用，当前定价为0.02元/次（数据来源：火山引擎HiAgent官方定价页），无其他额外费用。

Q2：什么情况下不建议使用HiAgent按量计费做外呼回访？
A：如果你的月度外呼量稳定超过120万次，包年包月模式的单位成本会低15%以上，不建议使用按量计费；如果需要自定义外呼线路、对接自有人工坐席系统，也更适合使用火山引擎语音服务外呼平台。

Q3：我可以跳过话术模板审核直接发起外呼吗？
A：不可以，未审核的模板调用会被系统直接拦截，无法发起外呼，多次提交违规模板还可能导致账号外呼权限被临时封禁，影响正常业务。

Q4：按量计费模式有调用量上限吗？
A：默认单账号日调用上限是10万次，如有更高需求可提交工单申请调整，最高可支持单账号日调用1000万次，无需额外支付扩容费用。

Q5：外呼的通话录音会保存多久？可以导出吗？
A：默认保存30天，可在控制台自定义保存时长，最长支持180天，存储费用单独计算为0.003元/GB/天，支持批量导出录音和转写文本。

[7] 相关阅读 #

1. 《HiAgent按量计费定价详解》，[/docs/hiagent/pricing/pay-as-you-go]，讲解HiAgent各场景按量计费的定价规则、阶梯优惠和结算周期。
2. 《智能外呼场景合规操作指南》，[/docs/hiagent/best-practice/compliance]，梳理外呼场景的国家监管要求、平台审核标准和避坑指南。
3. 《HiAgent外呼SDK接入文档》，[/docs/hiagent/sdk/call-sdk]，提供Python、Java、Go等多语言SDK的接入示例和全量参数说明。
4. 《HiAgent包年包月计费方案介绍》，[/docs/hiagent/pricing/monthly]，讲解包年包月方案的适用场景和成本测算方法。

[8] 参考资料 #

[1] 火山引擎HiAgent按量计费官方文档，https://www.volcengine.com/docs/hiagent/pricing/pay-as-you-go，2026年8月
[2] 智能外呼场景合规管理规范，https://www.volcengine.com/docs/hiagent/compliance/call-rule，2026年6月
本文基于HiAgent v2.1.0版本编写。

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

2026-08-24