3.1 升级前后对比

假设一个用户同时属于三家企业的客户，这三家企业分别授权了服务商A与服务商B的应用，升级之前，同一个服务商获取到同一个用户的external_userid一致，不同服务商不一致，具体如下：

升级之后，属于不同企业的同一个客户，同一服务商获取到的external_userid不一致，
不同服务商获取的external_userid也不一致，具体如下：

3.2 升级之后的接口变化

所有接口无论是入参，还是返回结果，涉及external_userid的字段名皆不变；所有回调事件，涉及external_userid的字段名皆不变。
例如，获取客户详情中，external_userid字段在升级之后依然保持字段名为external_userid。
例如，企业客户事件中，ExternalUserID字段依然保持字段名ExternalUserID。

【重要】从2021年11月17号开始，对于新授权的企业，将启用升级后的external_userid。第三方应用理论上代码不需要做任何调整，即可兼容升级之后的external_userid。

3.3 历史已授权企业的方案

【重要】对于历史已授权的企业，在2022年3月1号之前，所有接口与回调返回的external_userid仍然为旧的external_userid，从2022年3月1号0点开始，所有输入与返回的external_userid字段，将启用升级后的external_userid。所以服务商需要在此之前完成历史数据的迁移整改。由于涉及历史数据的迁移，需要企业管理员重新授权，具体流程如下：

2022年3月1号之前属于过渡期，仍然可使用旧的external_userid。

企业用户在进入第三方应用页面时，企业微信会弹出授权确认页。

如果企业管理员同意授权，企业微信会回调“同意授权转换external_userid事件”给服务商。

服务商可以为该企业开启迁移流程，调用“转换external_userid”把历史external_userid转换为新external_userid。

迁移完成后调用“设置迁移完成”将该企业设置状态为迁移成功。

设置后企业微信所有接口与回调将为该企业启用新的external_userid。

3.1 升级前后对比 - 3.3 历史已授权企业的方案