FAQ - 企业微信 API

6月20日至6月28日灰度期间，如何确认授权的代开发应用帐号ID已升级？
答：灰度期间授权的代开发应用，ID体系默认不升级，即返回企业主体ID。服务商可调用设置迁移完成接口，将应用切换为升级后的ID模式。6月28日起授权的代开发应用均为升级后ID模式。

6月28日前，如何测试代开发升级后的ID方案？
答：如果已授权的代开发应用未升级，可以调用设置迁移完成接口迁移到升级后的模式。注意，迁移到升级完成是不可回退的，所以请使用测试企业进行测试。

代开发应用ID升级是企业维度还是应用维度？
答：应用维度。2022年6月28日23点后，新授权的代开发应用都将返回服务商主体加密的ID，且不返回UnionID。若客户企业取消历史授权的代开发应用后重新授权，则也返回升级后的ID。

代开发应用ID升级后，返回的服务商主体加密的ID与第三方应用是否一致？
答：一致。针对同一服务商名下所有第三方应用和代开发应用获取的加密ID，保持一致。

代开发应用如何获取员工的敏感信息？

答：按照代开发应用的授权时间：

从6月20日起所有新授权的代开发应用，企业管理员确认后，成员在登录应用时自主授权敏感信息。服务商可通过「获取访问用户敏感信息」接口获取。

6月20日前已授权的代开发应用，敏感信息获取方式不变，企业管理员确认后，调用通讯录接口获取员工敏感信息。

代开发帐号ID升级全量发布后，是否会影响到历史已有的代开发应用？

答：不会影响。代开发ID升级仅面向新授权的代开发应用，

不会影响历史授权的代开发应用。

历史已授权的代开发应用：

所有接口与回调返回的ID保持不变。服务商可调用设置迁移完成接口，将历史应用切换为升级后的ID模式。

敏感信息获取方式不变，可继续调用通讯录接口获取员工敏感信息。

代开发帐号ID升级后，企业内部应用如何与服务商应用对接？
答：企业内部开发时，通过会话内容存档、客户联系、自建应用等内部secret获取的ID与服务商ID不同。而企业的内部应用在一些场景下需要与第三方服务商的应用对接。为此，企业微信提供了「自建应用ID转换」接口，支持企业将第三方应用或代开发应用获取的userid和external_userid转换为企业主体对应的ID，以此实现应用对接。

历史已经开启的通讯录同步是否需要配置“企业可信IP”？

答：不需要，但是不允许新增的服务商IP调用接口。

6月20日前已经开启的通讯录同步，暂时无需配置“企业可信IP”，历史已访问过的IP可继续调用接口。但是不允许新增的服务商IP调用接口，调用时会报错，错误码为60020。

若6月20日关闭后重新开启，则需配置“企业可信IP”，且不可配置第三方服务商的IP。

员工敏感信息授权时，有效期内如何引导用户调整权限？
答：当通过oauth2发起员工敏感信息授权时，为避免打扰用户，在30天内仅会出现一次授权页。有效期内，可引导用户进入“应用详情页 – 个人敏感信息授权管理” 中重新勾选。

10.

调用jsapi时传入升级后的userid与external_userid，提示不合法，原因是什么？
答：首先确认用户的企业微信终端已更新到最新版本，其次确认调用该jsapi之前，是否有成功调用wx.agentConfig，部分旧的jsapi之前只需要调用wx.config即可，但wx.config之后没有应用身份，无法准确解出userid与external_userid，故ID升级之后要求调用wx.agentConfig.