针对服务商为企业代开发微信小程序的场景,服务商可通过此接口,将微信客户的unionid转为external_userid。
服务商代开发小程序指企业使用的小程序为企业主体的,非服务商主体的小程序。
场景:企业客户在微信端从企业主体的小程序(非服务商应用)登录,同时企业在企业微信安装了服务商的第三方应用或代开发应用,服务商可以调用该接口将登录用户的unionid转换为服务商全局唯一的外部联系人id
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/unionid_to_external_userid?access_token=ACCESS_TOKEN
请求参数:
{
"unionid":"oAAAAAAA",
"openid":"oBBBB"
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 ,第三方应用或代开发应用的access_token |
unionid | 是 | 微信客户的unionid |
openid | 是 | 微信客户的openid |
权限说明:
仅认证企业可调用
unionid(即微信开放平台账号主体)与openid(即小程序账号主体)需要认证
unionid(unionid的主体为绑定了该小程序的微信开放平台账号主体)与openid(即小程序账号主体)的主体需与当前企业的主体一致。
openid与unionid必须是在同一个小程序获取到的
该客户的跟进人或其所在客户群群主必须在应用的可见范围之内
返回结果:
{
"errcode":0,
"errmsg":"ok",
"external_userid":"ooAAAAAAAAAAA"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
external_userid | 该企业的外部联系人ID |