外部联系人unionid转换

服务商为企业代开发微信小程序的场景,服务商可通过此接口,将微信客户的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 调用接口凭证
unionid 微信客户的unionid
openid 微信客户的openid

权限说明:

仅认证企业可调用
unionid(即微信开放平台账号主体)或者openid(即小程序账号主体)至少其中一个需要认证
unionid(unionid的主体为绑定了该小程序的微信开放平台账号主体)或者openid(即小程序账号主体)的主体需与当前企业的主体一致。
若传了openid,openid与unionid必须是在同一个小程序获取到的
该客户的跟进人必须在应用的可见范围之内

返回结果:

{
 "errcode":0,
 "errmsg":"ok",
 "external_userid":"ooAAAAAAAAAAA"
}

参数说明:

参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
external_userid 该企业的外部联系人ID
© 1998 - 2021 Tencent Inc. All Rights Reserved