黑/白名单管理

快速阅读

黑/白名单按客户号码限制呼入和外呼。黑名单是拦截，白名单是只放行。总开关在全局配置，号码库在黑名单 / 白名单两个列表。黑名单和白名单不能同时作为生效模式。

• 不开启：名单不参与呼叫限制。
• 开启黑名单：名单内号码呼入提示话务员全忙请稍后再拨；外呼被平台拦截。
• 开启白名单：只允许名单内号码呼入或外呼。
• 可按电话号码、城市区号、未知号码、号段添加；外呼可再限定预览、预测、主叫、WebCall、SIP 等类型。
• 有效期最短按 30 天处理；可批量导入 / 删除。

阅读地图

• 先搞清黑白互斥和呼入 / 外呼差异：读“三、核心概念”和“六、1 全局配置”。
• 要加号码或导入：读“六、2～3”。
• 要对接 OpenAPI：读“六、5”。
• 要验收：读“八”和“附录 C”。

一、文档说明

骚扰拦截、只对内部测试号外呼、按区号挡住一类来电，都靠本页。本文说明模式、呼叫类型、电话类型、有效期、导入删除和配错后的呼叫表现。

适用：运营、实施、需要同步名单的技术负责人。

本文主要说明租户级呼叫名单。测试白名单、话机 IP 白名单、风控投诉黑名单是其他对象，建议结合对应能力一起确认。

二、产品总览

名单是租户级规则：先选黑或白（或关闭），再维护号码，通话时按客户号码匹配。

黑名单是“这些号别打进来也别打出去”；白名单是“只跟这些号通话”。

页面三个页签：黑名单、白名单、全局配置。

三、核心概念

黑名单与白名单作为生效模式互斥。列表可以都有数据，真正拦呼叫的只有全局配置当前模式。

四、对象关系

全局配置：关闭 / 黑名单 / 白名单 × 呼入 / 外呼
        ↓
名单库：号码、区号、号段、未知号码 + 呼叫类型 + 有效期
        ↓
呼入或外呼时匹配客户号码
        ↓
放行 或 拦截（呼入提示话务员全忙；外呼平台拦截）

外呼任务、WebCall、SIP 是否命中，取决于该条的呼叫类型 / 外呼范围，不是只看号码本身。

五、能力地图

六、产品功能说明

6.1 全局配置

呼入黑名单拦截后，客户侧提示音：话务员全忙，请稍后再拨。 外呼黑名单由平台主动拦截，座席侧表现为外呼失败。

6.2 添加一条

保存后立即进入列表。是否立刻拦下一通，还取决于全局模式是否开启对应方向。

6.3 列表、筛选、导入、删除

列表字段：号码、呼叫类型、电话类型、添加时间、状态（有效 / 无效）、失效时间、备注、删除。

筛选：状态、呼叫类型（外呼可下钻到子类型）、号码 / 备注、添加时间范围。

批量导入：选呼叫类型，下载模板，上传 xls / xlsx，单文件最大 10MB。导入失败看文件格式和号码是否合法。

删除 / 批量删除后，该号码不再匹配。无效行仍展示，但过期后不参与限制。

6.4 生效与失败表现

未命中、模式关闭、条目标记无效、外呼子类型未勾选，都不会按该条拦截。

6.5 开放接口

OpenAPI 支持新增、批量新增、模板新增、查询、删除、批量删除。名单类型：1 黑名单，2 白名单。呼叫类型：1 呼入，2 外呼。电话类型与页面相同。有效期 0 或空为长期，小于 30 按 30 天。

外呼范围用位组合：预览 1、主叫 2、WebCall 4、预测 8，全开为 15。页面上的 SIP、WebCall 第二侧以当前控制台为准。

完整参数见 OpenAPI 黑白名单说明，本文不展开签名。

七、典型场景

• 投诉号码：开黑名单呼入，添加该客户号码，再打入应听到忙音提示。
• 只允许测试号外呼：开白名单外呼，只导入测试号，其他外呼应被拦。
• 整区拦截：电话类型选城市区号。
• 预测外呼不要打某批号：外呼类型只勾预测外呼。

八、上线准备与运营建议

1. 先定模式：黑、白或关闭，不要两边都当生效规则。
2. 呼入 / 外呼方向与业务一致。
3. 用一个命中号、一个未命中号各打一通。
4. 确认有效期和数量上限。
5. 需要对接时，用 OpenAPI 增删与页面抽查一致。
6. 客户号码加密时，先确认租户配置里的解密规则。

九、与周边能力的关系

十、FAQ

名单里有号为什么还能打进？
看全局是不是黑名单 + 呼入，条是不是有效，电话类型和号码格式是否一致。

白名单开了，常用客户都打不进？
白名单是只放行。先把客户号码导入，或改回黑名单 / 关闭。

有效期填 7 天为什么还是 30 天？
小于 30 天按 30 天处理。

未知号码是什么？
无法识别的号码归到 unknown_number，全租户只能有一条。

十一、总结

先选黑或白或关闭，再维护号码和方向。呼入黑名单给忙音提示，外呼由平台拦截。用命中 / 未命中两通验收。

附录 A：入口与权限

附录 B：关键字段口径

附录 C：实施检查清单

• 模式与呼入 / 外呼方向已保存
• 黑名单命中呼入听到忙音提示
• 黑名单命中外呼被拦
• 白名单未命中不能呼入 / 外呼
• 区号、号段、未知号码各测一条
• 过期后状态为无效且不再拦截
• 导入失败有文件原因可查

附录 D：常见问题速查