第三方应用开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
第三方应用开发
服务端API
客户联系
客户管理
企业主体unionid转换为第三方external_userid
企业主体unionid转换为第三方external_userid
最后更新:2022/06/29

针对服务商为企业代开发微信小程序的场景,服务商可通过此接口,将微信客户的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
上一篇修改客户备注信息
下一篇第三方主体unionid转换为第三方external_userid
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们