快速接入指南
概述
梓享通信服务平台提供集“黑名单防御 + 号码改写 + 智能风控”于一体的综合语音安全能力 ,帮助业务在接入初期即可获得合规、稳定、低风险的呼叫环境。
核心优势
- 高效号码风控:内置 12321 基础库 + 自建动态风险库,毫秒级检测。
- 灵活策略编排:支持多规则叠加、按 VOS/前缀/行业/时段/运营商颗粒化控制。
- AI 语义研判:深度分析呼叫关联语义与行为特征,提前识别潜在风险被叫。
- 统一接入接口:黑名单与改写使用统一检测入口,调用简单,扩展平滑。
一、平台预配置(梓享)
1. 加白 VOS 服务器 IP
访问后台 → 添加需要调用接口的 VOS 出口公网 IP。

提示
- IP 录入后不支持直接修改,如有错误需删除后重新添加。
- 停用的 VOS 请及时“取消启用”或删除,避免无效占用。
2. 接口地址
统一检测接口(黑名单 / 号码改写):
https://api.serverai.com.cn/vos/phoneIP 开放
服务器接入 IP 是:43.145.29.34,106.54.215.78
如果防火墙有限制,需要开放上述 IP 信息,否则会影响使用
3. 号码改写返回前缀(参考)
| 前缀 | 场景 | 触发来源 | 处理建议 |
|---|---|---|---|
| BLOCK | 命中系统黑名单 | 动态/基础库 | 直接拒绝或改写剥离 |
| BLOCK_USER | 用户自建黑名单 | 手工/导入 | 复核来源,必要时批量清理 |
| BLOCK_TIME | 命中禁呼时间段 | 规则策略 | 可提示“非服务时间” |
| BLOCK_OPERATOR | 受限运营商 | 运营商限制 | 检查运营商范围配置 |
| BLOCK_FANCY | 特殊(靓号)限制 | 靓号策略 | 评估是否放开部分号段 |
| BLOCK_PHONE | 号码格式错误 | 号码校验 | 记录原始输入,排查来源 |
| BLOCK_OC | 呼叫超频 | 频控组件 | 适当延迟后重试或限流 |
| ERROR | 其他内部异常 | 系统 | 关注日志堆栈,必要时联系支持 |
返回前缀含义
调试建议
测试阶段可临时记录完整返回内容(含前缀/标签/耗时),用于策略比对。
二、VOS 端设置
1. 配置对接地址
路径:系统管理 → 系统参数

提示
黑名单 与 号码改写为同一入口;按业务选择其一即可,系统自动识别检测模式。
2. 启用检测模式
A. 话机侧启用
路径:业务管理 → 话机业务 → 话机管理

配置规则:
- 勾选【外部黑名单】→ 启用黑名单检测模式。
- 选择【HTTP】→ 启用改写模式(号码将被加前缀或替换)。
B. 网关侧启用
路径:业务管理 → 网关业务 → 对接网关

规则同上:
- 勾选【外部黑名单】→ 黑名单检测。
- 选择【HTTP】→ 号码改写。
