4.2 unionid查询external_userid

当微信用户在微信中使用第三方应用的小程序或公众号时，第三方可将获取到的unionid与openid，调用此接口转换为企业客户或学生家长的external_userid。该接口调用频次有限，每个服务商每小时仅可调用5万次，每天仅可调用24万次，应由用户的主动行为来触发查询（例如用户进入小程序时触发），严禁批量进行ID转换，如有发现违规行为，将封禁服务商的接口调用权限。同时建议服务商的小程序路径或公众号页面链接带上corpid参数，如此可明确地转换出该企业对应的external_userid，以获得更好的性能。

权限说明：

\1. 该企业授权了该服务商第三方应用
\2. 调用频率最大为5万次/小时，24万次/天
\3. unionid和openid的主体需与服务商的主体一致
\4. openid与unionid必须是在同一个小程序或同一个公众号获取到的
\5. 相应外部成员跟进人在应用可见范围内或相应外部成员所属外联群群主在应用可见范围内。
\6. 当微信用户为家长时，仅返回应用的可见范围内的家长。
\7. 外联群场景中，本接口corpid为必填项。
\8. 微信客服场景中，仅返回48小时内客服会话的external_userid。

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/service/externalcontact/unionid_to_external_userid_3rd' \ --header 'Content-Type: application/json' \ --data-raw '{ "unionid":"xxxxx", "openid":"xxxxx", "corpid":"xxxxx", //建议尽可能传入corpid参数，可获得更好的性能 }'

{ "errcode": 0, "errmsg": "ok", "external_userid_info": [ { "corpid": "AAAAA", "external_userid": "BBBB" }, { "corpid": "CCCCC", "external_userid": "DDDDD" } ] }

请求参数

Query 参数

suite_access_token

string

可选

第三方应用access_token

示例值:

ACCESS_TOKEN

Body 参数application/json

unionid

string

必需

微信用户的unionid

openid

string

必需

微信用户的openid

corpid

string

必需

建议尽可能传入corpid参数，可获得更好的性能

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

external_userid_info

array [object {2}]

必需

该unionid对应的外部联系人信息

corpid

string

所属企业id

必需

external_userid

string

外部联系人id

必需