企业主体unionid转换为第三方external_userid

POST

https://qyapi.weixin.qq.com/cgi-bin/externalcontact/unionid_to_external_userid

服务端API第三方应用开发

针对服务商为企业代开发微信小程序的场景，服务商可通过此接口，将微信客户的unionid转为external_userid。

服务商代开发小程序指企业使用的小程序为企业主体的，非服务商主体的小程序。
场景：企业客户在微信端从企业主体的小程序（非服务商应用）登录，同时企业在企业微信安装了服务商的第三方应用或代开发应用，服务商可以调用该接口将登录用户的unionid转换为服务商全局唯一的外部联系人id

权限说明：

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

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/unionid_to_external_userid?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
  "unionid":"oAAAAAAA",
  "openid":"oBBBB"
}'

响应示例

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

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

unionid

string

必需

微信客户的unionid

openid

string

必需

微信客户的openid

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

external_userid

string

可选

该企业的外部联系人ID

errmsg

string

可选

对返回码的文本描述内容

修改于 2022-12-06 08:13:31

修改客户备注信息

第三方主体unionid转换为第三方external_userid