文档中心
及猫云 智能融合通信一体化开放API引领者

VOS系统对接说明

作者:小编 更新时间:2025-04-28 点击数:

VOS 系统对接说明

VOS 系统对接外部黑名单有以下两种方式,请根据实际情况选择,配置方式参考以下详细说明。
注意:

1.以下两种方式根据 VOS 版本不同而不同,请根据实际情况选择。

2.BASE_URL 联系业务经理获取。


1. VOS 外部号码转写

适用于 VOS2.1.4 及以上版本,请先确认 VOS 支持该功能,如有需要请联络您的 VOS 供应商
接口地址: ${BASE_URL}/vos/rewrite?appId=xxxx
对接原理: 拦截的号码自动添加前缀 hmdHhmdM 或者 hmdL(分别对应防护等级高、中、低),正常号码不转写,原样返回。
配置方法: 以下配置以 VOS2.1.4 为例,不同版本的配置界面可能存在细微差别。
1.进入 VOS 管理客户端并登录
2.双击【系统管理】->【系统参数】 设置 SERVER_EXTERNAL_REWRITE_HTTP 为接口网址 设置 SERVER_EXTERNAL_REWRITE_TIMEOUT 为 10000 (建议设置到最大防止出先网络波动导致的送检失败)
3.生效的范围可以选择:全局对接网关
  • 全局:【业务管理】->【软交换管理】->【补充设置】(编辑)->【系统参数】, 设置 SS_EXTERNAL_REWRITE_TYPEHTTP
  • 对接网关:【业务管理】->【对接网关】->【补充设置】(编辑)->【其它】,设置【外部改写号码方式】为 HTTP


2. VOS 外部黑名单

适用于 VOS2.1.8 及以上版本,请先确认 VOS 支持该功能,如有需要请联络您的 VOS 供应商
接口地址: ${BASE_URL}/vos/black?appId=xxxx
对接原理: 所有外呼号码进行外部过滤,判断拦截或放行。
配置方法: 以下配置以 VOS2.1.8 为例,不同版本的配置界面可能存在细微差别。
1.双击【系统管理】-【系统参数】。设置 SERVER_EXTERNAL_BLACK_LIST_HTTP 为接口网址;设置SERVER_EXTERNAL_BLACK_LIST_HTTP _TIMEOUT 为 10000 (建议设置到最大防止出先网络波动导致的送检失败)
2.生效的范围可以选择:对接网关话机
  • 对接网关:【业务管理】-【对接网关】-【补充设置】(编辑)-【其它】,设置外部黑白名单为勾选
  • 话机:【业务管理】-【话机管理】-【高级配置】-【其它】,设置外部黑白名单为勾选