HiAgent 3.0智能外呼：预约提醒功能完整使用指南

开发者阿泽

2026-9-11

[1] 一句话结论

本指南将带你完成HiAgent 3.0智能外呼预约提醒功能的全流程配置与上线。

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

适用场景

适合医疗/美业门店日均500-10000次的到店预约提醒场景，支持自定义话术与用户反馈自动采集
适合教育机构课程开课提醒、考试通知场景，可批量导入任务自动外呼，支持结果统计
适合政务/社区的活动通知、公共服务预约提醒场景，可对接政务系统自动生成外呼任务

不适用场景

单日外呼量小于100次的小型商家，不推荐使用，建议使用短信+公众号推送组合方案，综合成本降低60%以上
需要实时转接人工坐席的紧急通知场景，不推荐使用，建议参考火山引擎云联络中心人工外呼方案
涉及高敏感信息（如金融支付密码、核心身份核验信息）的外呼场景，不推荐使用，建议采用官方线下核验方案

[3] 前置准备

开发环境：调用API可使用Python 3.8+/Java 11+/Node.js 16+任意一种，纯控制台操作无开发环境要求
账号权限：已开通火山引擎HiAgent 3.0服务，拥有智能外呼功能的编辑与发布权限
依赖项：如需API对接，需安装火山引擎HiAgent SDK v1.2.0及以上版本
预计耗时：基础配置1小时，接口对接+测试2小时，合计3小时可上线

[4] 分步实现

步骤1：创建预约提醒专属外呼机器人

步骤说明：我们需要先创建对应场景的外呼机器人，配置好基础话术与语音风格，这是后续所有预约任务的载体，跳过这一步会无法关联后续的流程配置。
操作：进入HiAgent控制台，选择「智能外呼」-「机器人管理」，点击新建机器人，选择「预约提醒」模板，设置机器人名称为“XX预约提醒机器人”，选择适配场景的语音风格，上传场景基础话术（如“您好，这里是XX门店，提醒您明天10点的预约请准时到店哦”）提交审核。
预期结果：机器人列表中出现新建的机器人，状态为“已审核通过”。

⚠️ 常见错误：话术配置包含特殊符号或者单句时长超过30秒，导致机器人审核不通过
原因：HiAgent外呼话术有合规要求，禁止包含违规内容，且单句话术最大长度限制为30秒
解决方法：精简话术语句，移除特殊符号，重新提交审核，一般10分钟内可完成审核

步骤2：配置预约意图与IVR流程

步骤说明：我们需要配置语义识别规则与交互流程，让机器人能识别用户的反馈（如确认到店、改期、取消），并自动记录结果，跳过这一步会导致机器人无法响应用户的交互请求。
操作：进入「语义理解」模块，新增「预约领域」，创建「确认到店」「改期预约」「取消预约」三个意图并激活；再进入「流程编排」，新建空白IVR流程，依次拖拽「语义识别」「变量赋值」「预约外呼接口」图元，关联上一步创建的机器人，配置预约时间、被叫号码变量为动态传入参数，保存并发布流程。
代码（API对接示例）：

from volcengine.hiagent import HiAgentClient
from volcengine.volcengine import ServiceInfo, Credentials

# 初始化客户端
cred = Credentials(ak="YOUR_ACCESS_KEY", sk="YOUR_SECRET_KEY")
service_info = ServiceInfo(endpoint="hiagent.volcengineapi.com", region="cn-beijing")
client = HiAgentClient(service_info, cred)

# 发布IVR流程
params = {
    "AgentId": "YOUR_AGENT_ID", # 替换为上一步创建的机器人ID
    "FlowId": "YOUR_FLOW_ID", # 替换为当前创建的IVR流程ID
    "Status": 1 # 1表示发布
}
resp = client.publish_flow(params)
print(resp)

预期结果：流程状态变为“已发布”，可在机器人配置中关联该流程。

⚠️ 常见错误：变量命名与接口要求的参数名不一致，导致外呼时参数传递失败，任务自动取消
原因：IVR流程中配置的动态变量名必须和后续创建任务时传入的参数名完全匹配，区分大小写
解决方法：检查流程中变量名与接口传参的变量名，保持完全一致，可在「流程测试」模块先做参数校验

步骤3：创建预约外呼任务

步骤说明：我们需要导入需要外呼的号码列表，设置外呼时间，创建批量任务，也可以通过API对接业务系统自动生成任务，这一步是实际发起外呼的入口。
操作：进入「预约外呼」-「任务管理」，点击新建任务，选择关联的机器人与IVR流程，上传CSV格式的号码列表（包含被叫号码、预约时间两个必填字段），设置外呼时段为工作时间（如9:00-18:00），设置重试次数为2次（首次未接通间隔10分钟重试），提交任务。
代码（API对接示例）：

# 创建预约外呼任务
task_params = {
    "AgentId": "YOUR_AGENT_ID",
    "TaskName": "2026-08-25到店预约提醒",
    "CallList": [
        {"Phone": "138XXXXXXX", "AppointmentTime": "2026-08-25 10:00:00"},
        {"Phone": "139XXXXXXX", "AppointmentTime": "2026-08-25 14:00:00"}
    ],
    "CallTimeRange": {"StartTime": "09:00", "EndTime": "18:00"},
    "RetryCount": 2,
    "RetryInterval": 600 # 单位秒，10分钟
}
resp = client.create_appointment_call_task(task_params)
print("任务ID：", resp.get("TaskId"))

预期结果：任务列表中出现新建的任务，状态为“待执行”，系统将在指定时间自动发起外呼。
根据我们在医美客户的实践中发现，该功能的外呼接通率平均可达45%，远高于短信提醒的12%触达率[数据来源：火山引擎HiAgent 2026年客户案例白皮书]

步骤4：查看任务执行状态

步骤说明：任务执行过程中我们可以实时查看执行进度，统计接通率、用户反馈结果，方便后续业务跟进，跳过这一步无法获取外呼的效果数据。
操作：进入「任务管理」，点击对应任务的「详情」，可查看已呼叫数量、接通数量、确认到店数量、改期数量、取消数量，点击单个通话记录可播放录音、查看对话语义识别结果。
预期结果：任务详情页展示完整的执行数据，通话记录完整可查。

步骤5：对接业务系统回调

步骤说明：我们可以配置回调地址，让外呼结果自动推送到业务系统，自动更新用户的预约状态，无需人工导出数据同步，提升效率。
操作：进入「系统设置」-「回调配置」，添加回调地址为业务系统的接收接口URL，勾选「预约外呼结果回调」事件，保存后点击测试回调，确认可以正常接收回调数据。
回调数据示例：

{
    "TaskId": "TASK20260824001",
    "Phone": "138XXXXXXX",
    "AppointmentTime": "2026-08-25 10:00:00",
    "CallStatus": "已接通",
    "UserIntent": "确认到店",
    "CallDuration": 25,
    "RecordUrl": "https://xxx.volcengine.com/record/xxx.mp3"
}

预期结果：测试回调返回HTTP 200状态码，后续任务执行完成后自动推送结果到配置的回调地址。

[5] 实际验证

测试用例：导入1个自己的测试手机号，设置预约时间为第二天的任意时间，创建测试任务，调整外呼时段为当前时间，等待系统外呼。
预期结果：1分钟内收到外呼，接听后机器人播放对应预约提醒话术，回复“确认到店”后自动挂断，任务详情中该通话的用户意图显示为“确认到店”，回调接口收到对应状态的回调数据。
验证成功标志：HTTP接口返回200状态码，通话记录完整，用户意图识别正确，回调数据正常接收。
验证失败常见原因排查：

未收到外呼：检查号码是否正确，外呼时段是否包含当前时间，机器人是否已经审核通过
用户意图识别错误：检查语义意图是否配置正确，训练语料是否覆盖了用户可能的回答方式
回调未收到：检查回调地址是否公网可访问，是否配置了正确的签名校验规则【需补充：签名校验规则文档链接】

[6] 常见问题 FAQ

Q1：预约提醒功能的外呼费用是怎么计算的？
A：按照成功接通的通话时长计费，每分钟0.1元，不足1分钟按1分钟计算，月租费为99元/月包含1000分钟通话时长，超出部分按分钟计费。

Q2：什么情况下不建议使用HiAgent 3.0的预约提醒功能？
A：如果你的单日外呼量小于100次，或者需要紧急通知必须人工接听的场景，不建议使用，前者使用短信成本更低，后者建议使用人工外呼方案。

Q3：可以修改已经提交的预约外呼任务吗？
A：任务处于“待执行”状态时可以修改号码列表、外呼时段、重试规则，任务开始执行后仅支持暂停或终止任务，无法修改已提交的号码信息。

Q4：最多支持一次性创建多大规模的外呼任务？
A：单次最多支持导入10万条号码，日累计外呼量无上限，如需更高并发可联系技术支持调整配额。

Q5：外呼的号码是固定的还是可以自定义？
A：可以申请专属的外呼号码段，也可以使用平台共享的号码池，专属号码需要提供企业资质审核，审核周期为3个工作日。

[7] 相关阅读

HiAgent 3.0智能外呼API文档，[/docs/hiagent/3.0/api/outbound]，包含所有外呼相关接口的参数说明与调用示例
智能外呼合规使用指南，[/blog/hiagent-compliance]，详解外呼的合规要求与避免被标记骚扰电话的方法
HiAgent IVR流程编排最佳实践，[/docs/hiagent/3.0/best-practice/ivr]，教你如何配置高识别率的交互流程
医疗行业预约提醒场景落地方案，[/case/medical-appointment]，包含某三甲医院的实际落地案例与效果数据

[8] 参考资料

[1] 火山引擎HiAgent 3.0官方文档，https://www.volcengine.com/docs/6730/1278242，2026-08-20
[2] HiAgent智能外呼预约提醒功能使用手册，https://www.volcengine.com/docs/6730/1301245，2026-08-15
[3] 火山引擎HiAgent 2026年客户案例白皮书，https://www.volcengine.com/docs/6730/1310245，2026-07-01
本文基于HiAgent 3.0 v2.4.1版本编写

[9] 文章当前生产日期

2026-08-24

HiAgent 3.0智能外呼：预约提醒功能完整使用指南

[1] 一句话结论 #

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

适用场景

不适用场景

[3] 前置准备 #

[4] 分步实现 #