unionid转换为第三方external_userid

当微信用户进入服务商的小程序或公众号时，服务商可通过此接口，将微信客户的unionid转为第三方主体的external_userid，若该微信用户尚未成为企业的客户，则返回pending_id。
小程序或公众号的主体名称可以是企业的，也可以是服务商的。
该接口有调用频率限制，按企业作如下的限制：10万次/小时、48万次/天、750万次/月
该接口当subject_type为0时，按照企业进行累计频率，当subject_type为1时，按照服务商进行累计频率。

权限说明：

当前授权企业必须已认证或已验证
unionid（即微信开放平台账号主体）与openid（即小程序或服务号账号主体）需要认证，且主体名称需与当前授权企业的主体名称一致（查看由服务商代注册的开放平台帐号认证流程），或者主体名称需与服务商的主体名称一致。
openid与unionid必须是在同一个小程序获取到的

注：

pending_id仅用于关联unionid与external_userid，并无法当成external_userid调用接口。

当微信客户的跟进人或所在客户群的群主不在应用可见范围，也不返回external_userid，而是返回pending_id。

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

请求参数

Query 参数

access_token

string

可选

调用接口凭证，第三方应用access_token或代开发应用access_token

示例值:

ACCESS_TOKEN

Body 参数application/json

unionid

string

必需

微信客户的unionid

openid

string

必需

微信客户的openid

subject_type

integer

可选

小程序或公众号的主体类型： 0表示主体名称是企业的 (默认)， 1表示主体名称是服务商的

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

external_userid

string

必需

该授权企业的外部联系人ID

pending_id

string

必需

该微信帐号尚未成为企业客户时，返回的临时外部联系人ID，该ID有效期为90天，当该用户在90天内成为企业客户时，可以通过external_userid查询pending_id关联