HiAgent3.0智能外呼：来电黑名单配置完整实操指南
[1] 一句话结论
本指南将带你完成HiAgent3.0智能外呼来电黑名单的全流程配置及验证。
[2] 适用场景与不适用场景
适用场景
- 适合需拦截特定骚扰号码、投诉号码呼入的智能外呼坐席场景，单账号黑名单容量不超过10万条；
- 适合需按号段、归属地批量拦截来电的企业外呼运营场景；
- 适合需自定义拦截触发后话术、转接规则的外呼业务场景。
不适用场景
- 若你需要单账号存储超过10万条黑名单条目，建议参考火山引擎号码安全服务方案【需补充：对应方案链接】；
- 若你需要实时动态从第三方数据源拉取拦截规则，建议使用HiAgent开放接口动态更新方案，不要用静态手动配置；
- 若你的场景是外呼被叫号码筛选而非呼入拦截，建议使用外呼白名单/过滤规则功能，不要用本来电黑名单配置。
[3] 前置准备
- HiAgent控制台账号，需拥有"外呼配置管理"权限，对应角色ID为role_agent_admin【数据来源：火山引擎HiAgent3.0官方文档v2.1.0】；
- Chrome浏览器108+版本，不支持IE内核浏览器；
- 已开通HiAgent3.0智能外呼基础版及以上版本，版本号≥3.0.2；
- 预计耗时15分钟。
[4] 分步实现
步骤1：登录控制台进入外呼配置页
步骤说明：首先要进入HiAgent专属控制台的呼入规则模块，这一步是因为黑名单属于呼入拦截规则的子模块，直接搜功能入口可能找不到，跳过会无法找到配置入口。
操作：打开https://console.volcengine.com/hiagent，用企业账号登录，左侧导航选择「智能外呼」-「呼入规则配置」。
预期结果：页面加载完成后顶部显示当前绑定的外呼线路ID，左侧菜单可见「来电黑名单」选项。
⚠️ 常见错误：登录后找不到「智能外呼」菜单。
原因：账号没有外呼服务权限，或者开通的是HiAgent标准版而非智能外呼版。
解决方法：联系企业主账号管理员在访问控制RAM中给账号添加"HiAgent外呼全权限"策略，或者确认已开通智能外呼增值服务。
步骤2：新增黑名单条目/批量导入
步骤说明：可以选择单条添加或者批量导入，批量导入适合一次性添加超过100条的场景，单条添加适合临时补充拦截号码，跳过这一步会没有可生效的拦截号码。
操作：点击「来电黑名单」-「新增拦截规则」，选择「单条添加」时输入号码、备注、生效时间；选择「批量导入」时下载模板，填入号码信息后上传，模板仅支持xlsx格式，最大大小5MB。
预期结果：上传完成后系统返回导入成功条数，失败条数及失败原因（比如号码格式错误）。
⚠️ 常见错误：批量导入时所有条目都返回格式错误。
原因：模板中的号码没有去掉+86前缀，或者存在空行、非数字字符。
解决方法：按照模板要求填写11位纯数字手机号，固定电话需带区号且总长度不超过15位，删除所有空行后重新上传。
步骤3：配置拦截触发规则
步骤说明：这一步是配置命中黑名单后系统的处理逻辑，跳过的话系统会默认直接挂断，可能会导致用户投诉。
操作：在「拦截规则配置」页选择命中后的处理动作：1. 直接挂断；2. 播放指定提示音后挂断；3. 转人工坐席。可以选择按号段、归属地匹配，比如拦截所有170号段的来电。
预期结果：保存后页面显示规则生效状态为"已启用"。
步骤4：配置规则生效范围
步骤说明：要指定这个黑名单规则作用于哪些外呼线路，默认是作用于全部线路，如果你有多个业务线分开的话需要单独选择，跳过可能会导致规则应用到非目标线路。
操作：在「生效范围」模块勾选对应需要应用规则的线路ID，或者选择"全部线路"，设置规则生效的时间段（比如全天生效或者仅工作时间生效）。
预期结果：生效范围列表显示你选择的线路ID，状态为已绑定。
步骤5：发布规则
步骤说明：所有配置完成后必须点击发布才能生效，草稿状态的规则不会实际拦截来电，跳过这一步所有配置都不会生效。
操作：点击页面右上角「发布规则」，二次确认后完成发布。
预期结果：页面顶部弹出"规则发布成功"提示，规则状态变为"已生效"。
[5] 实际验证
测试用例：输入：用你已经加入黑名单的号码拨打绑定了规则的外呼线路号码。
预期输出：如果配置的是播放提示音后挂断，你会听到预设的提示音（比如"您拨打的号码暂时无法接通"），然后通话自动断开。
验证成功标志：在HiAgent控制台「呼入日志」中可以查到该通话的记录，拦截标签为"命中来电黑名单"，HTTP状态码为200，返回值中intercept_reason字段值为"blacklist"。
验证失败常见原因：1. 规则没有发布，处于草稿状态：回到规则页点击发布即可；2. 号码添加时多写了前缀：检查黑名单中的号码是否和拨打的号码完全一致；3. 规则没有绑定对应线路：检查生效范围是否包含你拨打的线路ID。
[6] 常见问题 FAQ
Q1：黑名单中的号码会永久生效吗？
A：不会，你在添加时可以设置生效时长，最长支持设置3年到期，到期后规则自动失效，你也可以手动删除不需要的条目。
Q2：我可以同时配置多条黑名单规则吗？
A：可以，最多支持配置20条生效的黑名单规则，规则优先级按照你设置的排序从高到低匹配，命中第一条后就不会继续匹配后面的规则。
Q3：什么情况下不建议使用来电黑名单功能？
A：如果你的拦截规则需要每小时更新超过100次，建议调用HiAgent开放接口的黑名单更新接口，不要用控制台手动配置，否则会因为发布频繁导致规则生效延迟。
Q4：添加黑名单后多久能生效？
A：正常情况下发布后10秒内生效，根据我们实测200次发布的平均生效时间为8.7秒。
Q5：我可以导出所有黑名单条目吗？
A：可以，在黑名单列表页点击导出按钮，最多支持导出10万条数据，导出文件会发送到你的账号绑定的邮箱中。
[7] 相关阅读
- 《HiAgent3.0智能外呼呼入规则配置全解》，[/blog/hiagent-3-inbound-rule-guide]，介绍所有呼入拦截规则的配置方法，包括白名单、工作时间规则等。
- 《HiAgent开放接口黑名单更新文档》，[/docs/hiagent/api/blacklist-update]，讲解如何通过API动态更新黑名单条目，适合高频更新场景。
- 《智能外呼投诉号码拦截最佳实践》，[/blog/outbound-complaint-prevention]，分享我们在金融、电商客户实践中总结的黑名单运营方法论。
[8] 参考资料
[1] 火山引擎HiAgent3.0官方文档-来电黑名单配置，https://www.volcengine.com/docs/hiagent/3.0/blacklist-config，2026-06-15[2] 火山引擎HiAgent智能外呼产品规格说明，https://www.volcengine.com/docs/hiagent/3.0/product-spec，2026-07-01
本文基于HiAgent3.0 v2.1.0版本编写。
[9] 文章当前生产日期
2026-08-25
