第三方应用开发 服务端API 客户联系 客户管理 外部联系人unionid转换
外部联系人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调用接口凭证 ,必须为第三方应用的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
上一篇
修改客户备注信息
下一篇
代开发应用external_userid转换