场景

品牌在公众号、小程序上的微信粉丝，可以跟经销商用企微添加的微信客户打通数据
实现效果：共享客户信息，完善客户画像，促进成交

准备工作

1. 品牌有自己主体（或isv主体）的公众号、小程序
2. 品牌创建上下游，经销商新建企业并加入上下游
3. 品牌共享应用给经销商
4. 经销商管理员授权应用获取「企业客户」权限

思路

针对经销商已用企微添加的微信客户（接口链接）
品牌通过以下接口把公众号、小程序粉丝的 unionid （从微信开放平台获取）转换成 external_userid

针对经销商还未用企微添加的微信客户（当前接口）

1. 品牌提前把公众号、小程序粉丝的 unionid （从微信开放平台获取）转换成 pending_id
2. 经销商用企微添加微信客户时，用 external_userid 查询 pending_id
3. unionid 和 external_userid 数据打通

pending_id的说明

• pending_id主要用于关联微信unionid与外部联系人external_userid，可理解为临时外部联系人ID；
• 上游企业可通过此接口将微信unionid转为pending_id，当微信用户成为下游企业客户后，可使用上下游external_userid转pending_id接口将下游external_userid转换为pending_id，建立unionid => pending_id => external_userid的映射关系；
• pending_id有效期90天，共享应用内唯一。

unionid查询pending_id

该接口有调用频率限制，按上游企业维度，限制为：10万次/小时、48万次/天、750万次/月。

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

请求参数：

{
    "unionid":"UNIONID",
    "openid":"OPENID"
}

参数说明：

权限说明：

1. 调用该接口的应用必须是上下游共享的自建应用或代开发应用
2. 应用需要具有客户联系权限
3. 当前授权企业必须已认证或已验证；若为代开发应用，服务商必须已认证
4. unionid（即微信开放平台账号主体）与openid（即小程序或服务号账号主体）需要认证，且主体名称需与上游企业的主体名称一致（查看由服务商代注册的开放平台账号认证流程）
5. openid与unionid必须是在同一个小程序获取到的
6. pending_id有效期90天

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "pending_id":"PENDINGID"
}

参数说明：

external_userid查询pending_id

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

请求参数：

{
  "chat_id":"xxxxxx",
  "external_userid":["oAAAAAAA", "oBBBBB"]
}

参数说明：

权限说明：

调用该接口的应用必须是上下游共享的自建应用或代开发应用
应用需要具有客户联系权限
该客户的跟进人或其所在客户群群主必须在应用的可见范围之内
上游应用须调用过unionid转pending_id接口
上游和下游企业须认证或验证；若为代开发应用，服务商必须已认证

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
	"result":[
		 {
			"external_userid":"oAAAAAAA",
			"pending_id":"pAAAAA"
		 },
		 {
			"external_userid":"oBBBBB",
			"pending_id":"pBBBBB"
		 }
	 ]
}

参数说明：