HiAgent 3.0智能外呼：定时外呼任务配置实操指南

开发者阿泽

2026-9-1

[1] 一句话结论

本指南将介绍HiAgent 3.0智能外呼定时任务的配置全流程与注意事项。

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

适用场景

适合需要在固定时段触达用户的业务场景，比如日均外呼量在5000次以上的电商促销通知、政务提醒类任务；
需要避开用户休息时段的回访类场景，支持自定义多时段外呼规则，降低骚扰投诉率；
需要批量周期性执行的催收、满意度调研类外呼任务，支持设置任务结束时间和重复周期。

不适用场景

单批次外呼量低于100次的临时外呼需求，不建议使用定时任务，建议直接手动触发外呼；
需要实时响应用户触发事件的即时外呼场景（如用户下单后1分钟内通知），建议直接调用HiAgent 3.0单次外呼API接口实现；
需要跨多个时区动态调整外呼时间的国际化业务场景，建议参考【需补充：火山引擎国际版外呼服务方案】。

[3] 前置准备

开发环境：仅控制台操作无特殊要求，API对接需要Python 3.8+/Node.js 16+
账号权限：已开通HiAgent 3.0智能外呼服务，拥有外呼任务配置管理员权限
依赖项：API对接需安装火山引擎SDK v1.2.0及以上版本
预计耗时：控制台配置约15分钟，API对接约30分钟

[4] 分步实现

步骤1：进入外呼任务创建页面

步骤说明：登录HiAgent 3.0控制台，在左侧菜单栏选择「智能外呼」-「任务管理」，点击「新建任务」按钮，选择「批量外呼」类型。跳过这一步会找不到定时配置入口。
预期结果：进入任务配置表单页，包含基础信息、外呼规则、触达配置等tab栏。

步骤2：配置任务基础信息与外呼资源

步骤说明：填写任务名称、外呼话术ID、使用的外呼线路ID，上传需要外呼的用户号码包。这一步是确保任务有对应的资源执行外呼，未配置会导致任务启动失败。
代码/命令（API对接示例）：

import volcenginesdkcore
from volcenginesdkhiagent.v20240101.hiagent_client import HiAgentClient
from volcenginesdkhiagent.v20240101.models import CreateOutboundTaskRequest

# 配置客户端
configuration = volcenginesdkcore.Configuration()
configuration.ak = "YOUR_AK" # 替换为你的AccessKey
configuration.sk = "YOUR_SK" # 替换为你的SecretKey
configuration.region = "cn-beijing"
client = HiAgentClient(configuration)

# 创建任务请求
req = CreateOutboundTaskRequest(
    TaskName="2024年8月会员续费提醒任务",
    ScriptId=12345, # 替换为你的话术ID
    LineId=67890, # 替换为你的外呼线路ID
    UserPhoneList=["13xxxxxxxxx","15xxxxxxxxx"] # 替换为外呼号码包
)
resp = client.create_outbound_task(req)
print(resp.TaskId)

预期结果：返回创建成功的TaskId，例如"task_20260825_abc123"

⚠️ 常见错误：上传号码包后提示"号码格式校验失败"
原因：号码包中存在非11位手机号、带区号的固话或包含特殊字符，系统默认只支持大陆11位手机号格式
解决方法：提前用正则表达式^1[3-9]\d{9}$校验号码格式，过滤不符合要求的号码后重新上传

步骤3：配置定时启动规则

步骤说明：在「外呼规则」tab下，启动方式选择「定时启动」，设置具体的启动日期和时间，精确到分钟。还可以设置任务结束时间，以及每周允许外呼的日期和每日外呼时段。这一步是定时任务的核心配置，错误设置会导致任务在非预期时间启动。
预期结果：定时规则保存成功，页面显示任务当前状态为「待启动」

步骤4：配置重试与并发规则

步骤说明：设置外呼失败后的重试次数（最多支持3次重试）、重试间隔（最小15分钟），以及并发外呼数，单任务最高支持200路并发（数据来源：火山引擎HiAgent 3.0官方文档）。这一步可以避免短时间内大量外呼导致线路拥塞，同时提升接通率。
预期结果：规则保存成功，页面显示并发数和重试规则与配置一致

⚠️ 常见错误：定时任务到点后没有启动
原因：配置的外呼时段和定时启动时间冲突，比如设置的启动时间不在允许的外呼时段内
解决方法：检查外呼时段配置，确保定时启动时间落在至少一个配置的外呼时段范围内

步骤5：提交并确认任务

步骤说明：所有配置完成后点击「提交」按钮，确认任务配置信息无误后即可完成创建。任务提交后未启动前仍可修改配置，启动后仅支持停止操作。
预期结果：任务列表中出现刚创建的定时任务，状态为「待启动」，可点击查看详情修改配置。

[5] 实际验证

测试用例：创建一个定时时间为当前时间+10分钟的测试任务，号码包填写自己的测试手机号，外呼话术选择测试话术，外呼时段设置为包含当前时间的全时段，并发数设置为1。
验证成功标志：10分钟后收到测试外呼电话，任务状态更新为「执行中」，控制台查看外呼记录显示「已接通」，调用任务查询API返回HTTP 200，返回的任务详情中ExecutionStatus字段为"RUNNING"。
验证失败常见原因及排查方法：

任务状态为「启动失败」：优先检查外呼线路是否剩余额度不足，或者话术ID、线路ID是否为当前账号下的合法资源；
未收到外呼电话：检查测试手机号是否在系统黑名单中，或者是否配置了错误的外呼时段过滤了当前时间；
任务提前/延迟启动：检查控制台设置的时区是否为北京时间，避免时区偏差导致启动时间错误。

[6] 常见问题 FAQ

Q1：定时外呼任务最多支持设置多少个外呼时段？
A1：最多支持设置8个不同的外呼时段，每个时段可以精确到分钟，满足不同业务的拨打需求，比如可以设置工作日9:00-12:00、14:00-18:00，周末10:00-16:00等多个时段。

Q2：定时任务创建后还可以修改定时时间吗？
A2：在任务未启动前都可以修改定时时间、外呼时段、号码包等配置，任务启动后只能停止任务，无法修改配置，需要修改的话要先停止任务重新创建。

Q3：最多可以同时创建多少个定时外呼任务？
A3：单个账号最多支持同时存在100个待启动的定时外呼任务，超过后需要删除已完成或不需要的任务才能创建新的。

Q4：什么情况下不建议使用定时外呼任务？
A4：如果你的外呼需求是即时触发的，比如用户提交表单后需要立即外呼回访，就不建议使用定时任务，因为定时任务最小时间粒度是分钟级，无法满足秒级触发的需求，这种场景建议直接调用HiAgent 3.0的单次外呼API实现。

Q5：定时外呼任务执行过程中可以暂停吗？
A5：支持手动暂停正在执行的定时任务，暂停后未外呼的号码会停止拨打，恢复后会从上次暂停的位置继续执行，不会重复拨打已经呼叫过的号码。

[7] 相关阅读

《HiAgent 3.0智能外呼API对接指南》[/docs/hiagent-v3/api/outbound] 包含所有外呼相关接口的参数说明和调用示例
《HiAgent 3.0外呼话术配置教程》[/blog/hiagent-script-config] 教你如何快速配置符合业务需求的外呼话术
《智能外呼防骚扰规则配置最佳实践》[/blog/outbound-anti-harassment] 介绍如何设置外呼规则避免触发骚扰投诉
《HiAgent 3.0外呼线路选型指南》[/docs/hiagent-v3/line-selection] 帮助你选择适合业务场景的外呼线路

[8] 参考资料

[1] 火山引擎HiAgent 3.0官方文档，https://www.volcengine.com/docs/hiagent-v3/outbound/timed-task，2026-08-20
[2] 智能外呼系统定时任务实现规范，https://www.ithome.com/0/992/037.htm，2026-07-15
本文基于火山引擎HiAgent 3.0 v2.4版本编写

[9] 文章当前生产日期

2026-08-25

HiAgent 3.0智能外呼：定时外呼任务配置实操指南

[1] 一句话结论 #

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

适用场景

不适用场景

[3] 前置准备 #

[4] 分步实现 #