基础技术
一、背景
根据工信部关于号码保护服务管理的最新要求，平台将对原11+4虚拟号格式进行升级，升级为700虚拟号格式，此次升级的700号段与原11+4号段号码格式不同，且拨打700号段虚拟号前必须先报备外呼主叫号码，开发者须在规定时间内完成方案升级。
升级时间：2025年12月17日-1月17日。
二、号段变更说明
对比维度 |
原11+4虚拟号 |
700号段虚拟号 |
说明 |
号码格式 |
有连接符，有分机号，11位主号+4位分机号（示例：13699999999-1234） |
没有连接符，没有分机号，位长15位（示例：700101234567890） |
“虚拟主号+分机号”变更为15位连续数字 |
虚拟号有效期 |
订单完成后7天内有效 |
订单完成后7天内有效 |
无变化 |
电联拨打 |
输入11位虚拟号主号后，根据提示音输入4位分机号，以#结束 |
700虚拟号拨打前必须上报主叫号码组，号码组之外的号码拨打不通 |
核心变化 |
短信发送 |
不支持直接发送短信 |
不支持直接发送短信 |
|
面单打印 |
官方电子面单：保持现状 非官方电子面单：保持现状 |
官方电子面单：平台内部改造即可，无需开发者改造 非官方电子面单：需协同物流公司改造 |
灰度期间需兼容两种面单格式 |
三、接口变更说明
1、接口出参变更
1）taobao.top.oaid.decrypt（OAID解密）
接口出参改造：mobile（收件人手机号绑定的虚拟号）字段格式发生改变。
原出参：
"mobile": "13200000001-9999"
现出参：
"mobile": "700507877719557"
2、新增接口
1）新增订单G组号码更新接口
接口描述：更新主叫号码组，一个订单通过此接口最多报备80个主叫号码，单次不超过20个，超出自行删除，按照实际情况按需报备，避免造成资源浪费。
接口名称：taobao.top.secret.group.update（报备/更新主叫(G组)号码组）
请求类型：POST
接口链接：https://open.taobao.com/api.htm?docId=73786&docType=2
接口入参：
入参 |
类型 |
是否必传 |
描述 |
样例 |
oaid |
String |
是 |
oaid |
|
operate_type |
String |
是 |
操作类型 |
ADD_GXB_GROUP：添加G组号码 DELETE_GXB_GROUP：删除G组号码 |
mobile_list |
List<String> |
是 |
手机号列表 |
13100000000,13100000001,13100000002 |
接口返回值：
字段名称 |
字段类型 |
参数描述 |
示例值 |
success |
Boolean |
是否请求成功 |
false |
errorCode |
String |
响应码 |
gxb-group-update-failed |
errorMsg |
String |
错误码 |
G组号池更新失败 |
2）新增订单G组号码查询接口
接口描述：查询订单关联的700号码绑定的G组号码列表。
接口名称：taobao.top.secret.group.query（查询G组号码列表）
请求类型：GET
接口地址：https://open.taobao.com/api.htm?docId=73785&docType=2
接口入参：
入参 |
类型 |
是否必传 |
描述 |
样例 |
oaid |
String |
是 |
oaid |
接口返回值：
字段名称 |
字段类型 |
参数描述 |
示例值 |
call_mobile |
List |
明文手机号列表 |
131****0000,131****0001,131****0002 |
success |
Boolean |
是否请求成功 |
false |
errorCode |
String |
响应码 |
gxb-group-query-error |
errorMsg |
String |
错误码 |
G组号池查询失败 |
四、补充
1.淘宝700虚拟号改造咨询钉钉群 群号：147045021493。
2.工业和信息化部关于开展号码保护服务业务试点的通知：https://www.gov.cn/zhengce/zhengceku/202507/content_7030611.htm。
3.灰度计划：将在2026年1月至3月进行灰度，灰度期间会同时存在11+4位虚拟号和700号段虚拟号。
五、FAQ
1、700虚拟号后（主叫号码要报备后能呼入成功），快递师傅怎么联系消费者？
平台会和快递公司对接，确保快递员可以联系上消费者
2、改地址等售后相关功能，是否也使用了700虚拟号？
是的，其余线上功能和现有虚拟号一致
3、主叫号码维护可以在商家后台吗
可以
4、千牛上报入口有截图吗？是订单号维度的报备还是店铺维度的报备
① 商家可以通过店铺维度维护主叫号码，此处维护的外呼主叫号码平台将会自动进行报备，对店铺内所有订单生效；
② 商家可以通过订单维度维护主叫号码，此处维护的外呼主叫号码仅对同一个700号码生效；
5、本次700号段改造范围是否包含端侧解密接口（taobao.top.oaid.client.decrypt）？
是的，包括端侧解密接口（taobao.top.oaid.client.decrypt）
6、wms那边需要传主叫号码过来如何处理？
wms如需上传主叫号码，则也进行G组接口接入改造
7、面单上打印出来的也是700 虚拟号吗？
是的
8、消费者更新手机号，是先更新oaid，再通过oaid解密获取新的虚拟号么
修改手机号/修改地址按照原链路不变，解密获取新的虚拟号即可
9、主叫号码可以是座机号码吗？
目前支持座机号码，平台会持续跟进政策
10、主叫号码是跟订单多对一关联的吗？
是的
11、主叫号码如何跟订单关联的？是用户下单后，我们ERP系统调用【订单G组号码更新接口】，维护上订单与主叫号码对应关系吗？还是平台端会自动分配？
用户下单后，平台会自动将千牛端店铺维度维护的外呼主叫号码（G组号码）绑定到对应的商家订单中，服务商可以在订单维度增加主叫报备页面供商家上传和删除。
12、如果是我们维护订单的主叫号码，是不是整个店铺的主叫号码没有数量限制？
① 店铺维度的主叫号码在千牛店铺-隐私保护-店铺外呼主叫处上传和删除，数量限制为40个；
② 订单维度的主叫号码在千牛订单详情页面或服务商订单页面上传和删除，数量限制为80个（包含以上店铺的号码）。
13、物流的号码怎么报备？快递公司能否区分是淘宝还是其他平台订单？
物流号码由淘天物流部和菜鸟对接快递公司进行上传报备；快递可区分是否为淘宝订单；
14、报备流程平台有要求吗？是打单的时候就通过G组号码更新接口把号码更新上去，还是需要的时候再去更新？
最好是需要的时候再更新
15、「报备/更新主叫(G组)号码组」提到一个订单通过此接口最多报备80个主叫号码，理解这句话是按照订单纬度报备的；但是接口传参还是按照oaid纬度吧？
是的，oaid维度
16、G组报备的入参的OAID，如果订单发生变更，OAID变化，需要重新G组报备吗？
需要
17、假如订单已报备70个主叫号码，通过接口报备20个：
场景1：其中8个是已报备的，12个未报备的；这个时候接口返回是超限，只是12个未报备，8个已报备是否会受影响？
场景2：其中12个是已报备的，8个未报备的；这个时候接口是会返回报备成功吗？
场景1，返回超限只是当次20个号码直接阻断了，之前8个已报备的不会做解绑
场景2，返回报备成功
18、通过oaid获取脱敏信息以及700虚拟号订单数据推给分销商，分销商自行选择快递公司打印电子面单发货，以及调用快递公司的接口取号发货（比如顺丰）的情况，可以打通吗？
平台会进行方案适配，快递侧通过700号码进行报备拨打
19、天猫前台就一个商品行，商家这边有奖品发放，但是主品和奖品不在一个运单号内，主品发货时把运单号推送给了平台，奖品发货的运单号是没有推送平台的，后续奖品发放时，快递员还能联系到消费者吗？（商家未对接菜鸟电子面单）
平台会进行方案适配，快递侧通过700号码进行报备拨打
20、有些仓库没对接平台脱敏方案，都是让上游（服务商）解密下发的单子，要品牌商家推他们改造，如何处理？
可以协助平台联系具体品牌商家推动和沟通
21、一个订单支持绑定80个主叫号码，包含店铺级别的40个；如果通过taobao.top.secret.group.update这个接口删除店铺级别的号码，会返回什么结果？店铺级别号码会受影响吗？
只是把这个订单对应的店铺级别的主叫号码删掉了，删掉之后不影响店铺级别号码
22、虚拟号是11+4的时候，调G组更新添加手机号会报错吗
会报错
23、线下单走菜鸟面单的话 是700虚拟号还是真实手机号呢？
此部分非淘宝订单，后期再考虑方案
24、如果是已经出库的订单要进行补发 那是不是也是获取到700虚拟号 这种的快递能报备上吗？原单补发得情况 是不是快递也能报备？
平台会进行方案适配，快递侧通过700号码进行报备拨打
25、商家仓（发货/安装/上门取件/鉴定）场景700升级，需要怎么对接？
可以添加群“【官方】700小号改造（快递侧Link对接专项）沟通大群”（群号： 164165000667）进行对接
26、taobao.top.secret.group.update 这个接口 删除未报备过主叫号码 接口也是返回成功，是对的吗？
空操作，会返回成功
27、taobao.top.secret.group.update 接口的校验逻辑是什么？
消费者号码：非空，纯数字，不能00开头，长度不超过15位。
G组号码：单个G组内不超过两百个，号码之间英文逗号分隔。单个号码校验非空，纯数字，不能00开头，长度不超过15位。
