第三方应用开发 服务端API 客户联系 客户管理 第三方主体unionid转换为第三方external_userid
第三方主体unionid转换为第三方external_userid
最后更新:2022/06/20
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
第三方主体unionid转换为第三方external_userid
最后更新:2022/06/20

当微信用户在微信中使用第三方应用的小程序或公众号时,第三方可将获取到的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
上一篇
企业主体unionid转换为第三方external_userid
下一篇
代开发应用external_userid转换