一、调整背景

为提升平台对用户隐私保护能力与服务质量，规范商家在售后场景下的联系用户行为，平台上线「售后单兑换虚拟号」接口能力。该能力允许商家通过虚拟号码与用户进行联系，致力于更好保护用户真实联系方式。

为此，平台计划自2026年01月19日起对「获取售后单」和「获取纠纷单」接口进行调整，停止在售后单/纠纷单信息中返回用户的真实联系方式。请相关开发者（特别是已通过API接口处理售后业务的商家/服务商）及时关注并完成适配改造。

二、调整内容及影响

2.1 调整范围

（1）主体类型：微信小店商家、第三方服务商（以下也合称“你”）

（2）场景：商家使用《获取售后单 | 微信开放文档》以及《获取纠纷单 | 微信开放文档》接口获取用户联系方式进行售后沟通

2.2 调整要求

2.2.1 「获取售后单」接口变更

变更内容：自2026年01月19日起，「获取售后单」接口Res.after_sale_order.details中返回的用户联系方式字段（tel_number）将不再返回用户的真实手机号

2.2.2 「获取纠纷单」接口变更

变更内容：自2026年01月19日起，「获取纠纷单」接口Res.history中返回的用户联系方式字段（phone_number）将不再返回用户的真实手机号

2.2.3 新增「售后单兑换虚拟号」接口

你需通过调用「售后单兑换虚拟号」接口获取虚拟号码来联系用户。该接口允许你根据售后单号（after_sale_order_id）兑换一个临时的虚拟号码（virtual_tel_number）用于售后处理期间联系用户。

（1）接口文档：《售后单兑换虚拟号 | 微信开放文档》

（2）使用规范：兑换的虚拟号码在售后发起后30天内有效，失效后不支持再次申请

a. 兑换的虚拟号码在售后单完结时会立即失效，失效后不支持再次申请

b. 兑换的虚拟号码在用户更新联系号码时会被失效，失效后支持再次申请

c. 应运营商要求，在拨打虚拟号前，主叫号码需前往运营商完成实名认证，认证后方可拨打。未认证将呼叫失败。详情见《微信小店「虚拟号」主叫号码实名认证指引》。

同时，采用虚拟号服务时，请务必适配认证的相关接口：《获取短信验证码 | 微信开放文档》，《添加待认证的手机号 | 微信开放文档》，《获取小店手机号认证状态 | 微信开放文档》。

2.3 调整实施后的影响

本次调整生效后，继续调用「获取售后单」「获取纠纷单」接口将无法再获取用户真实联系方式（Res.after_sale_order.details中的tel_number，Res.history中的phone_number字段为空或不返回）。若你此前单独依赖获取用户真实联系方式直接与用户进行售后沟通的，可能受到影响。请留意，调整生效后需要以电话方式联系用户处理售后单及纠纷单的，应通过「售后单兑换虚拟号」接口获取虚拟号码且完成主叫号码认证方可通过虚拟号码与用户取得联系，请你及时完整相关适配性改造及对应工作流程的调整等避免因此影响售后处理。

三、调整节奏

自本通知发布之日至2026年01月18日为过渡期，你应在过渡期内完成代码开发、内部测试及参数配置，确保改造内容符合平台要求。过渡期内你仍可通过「获取售后单」「获取纠纷单」接口获取用户真实联系方式，过渡期届满后（即2026年01月19日起），平台将严格执行按照本通知要求执行相关调整规则，你将无法继续通过「获取售后单」「获取纠纷单」接口获取用户联系方式处理售后。

你针对本调整的实施有问题或相关建议的，皆可在微信小店交流专区 | 微信开放社区发表标题包含 「售后虚拟号」 关键词的帖子反馈。

深圳市腾讯计算机系统有限公司

2025年12月08日