当微信用户在微信中使用第三方应用的小程序或公众号时,第三方可将获取到的unionid与openid,调用此接口转换为企业客户或学生家长的external_userid。该接口调用频次有限,每个服务商每小时仅可调用5万次,每天仅可调用24万次,应由用户的主动行为来触发查询,严禁批量进行ID转换,如有发现违规行为,将封禁服务商的接口调用权限。同时建议服务商的小程序路径或公众号页面链接带上corpid参数,如此可明确地转换出该企业对应的external_userid,以获得更好的性能。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/service/externalcontact/unionid_to_external_userid_3rd?suite_access_token=ACCESS_TOKEN
请求参数:
{
"unionid":"xxxxx",
"openid":"xxxxx",
"corpid":"xxxxx", //建议尽可能传入corpid参数,可获得更好的性能
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
suite_access_token | 是 | 第三方应用access_token |
unionid | 是 | 微信用户的unionid |
openid | 是 | 微信用户的openid |
corpid | 否 | 需要换取的企业corpid,不填则拉取所有企业 |
权限说明:
1. 该企业授权了该服务商第三方应用
2. 调用频率最大为5万次/小时,24万次/天
3. unionid和openid的主体需与服务商的主体一致
4. openid与unionid必须是在同一个小程序或同一个公众号获取到的
5. 相应外部成员跟进人在应用可见范围内 或 相应外部成员所属外联群群主在应用可见范围内。
6. 当微信用户为家长时,仅返回应用的可见范围内的家长。
7. 外联群场景中,本接口corpid为必填项。
8. 微信客服场景中,仅返回48小时内客服会话的external_userid。
返回结果:
{
"errcode":0,
"errmsg":"ok",
"external_userid_info":[
{
"corpid":"AAAAA",
"external_userid":"BBBB"
},
{
"corpid":"CCCCC",
"external_userid":"DDDDD"
}
]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
external_userid_info | 该unionid对应的外部联系人信息 |
external_userid_info.corpid | 所属企业id |
external_userid_info.external_userid | 外部联系人id |