为更好地保护企业与用户的数据，企业微信不允许第三方应用获取企业的明文userid与external_userid。而企业的自建应用在一些场景下需要与第三方服务商的应用对接，为此，企业微信提供了自建应用的转换接口，支持将第三方应用获取的userid、external_userid转换为企业主体对应的ID。

userid转换

将代开发应用或第三方应用获取的密文open_userid转换为明文userid。
请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/batch/openuserid_to_userid?access_token=ACCESS_TOKEN

请求参数：

{
  "open_userid_list":["xxx", "yyy"],
  "source_agentid":100001
}

参数说明：

权限说明：

需要使用自建应用的access_token
成员需要同时在access_token和source_agentid所对应应用的可见范围内

返回结果：

{
    "errcode": 0,
    "errmsg": "ok",
    "userid_list": [
        {
            "open_userid": "xxx",
            "userid": "aaa"
        }
    ],
    "invalid_open_userid_list":["yyy"]
}

参数说明：

external_userid转换

将代开发应用或第三方应用获取的externaluserid转换成自建应用的externaluserid。

请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/externalcontact/from_service_external_userid?access_token=ACCESS_TOKEN

请求参数：

{
  "external_userid":"aaa",
  "source_agentid":100001
}

参数说明：

权限说明：

需要使用自建应用的access_token
客户的跟进人，或者用户所在客户群的群主，需要同时在access_token和source_agentid所对应应用的可见范围内

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "external_userid":"xxx"
}

参数说明：