快速接入指南
概述
梓享通信服务平台提供集“黑名单防御 + 号码改写 + 智能风控”于一体的综合语音安全能力 ，帮助业务在接入初期即可获得合规、稳定、低风险的呼叫环境。
核心优势
- 高效号码风控：内置 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】→ 号码改写。