external_userid查询pending_id

该接口可用于当一个微信用户成为企业客户前已经使用过服务商服务（服务商侧曾经调用过unionid转换为第三方external_userid）的场景。本接口获取到的pending_id可以维持unionid和external_userid的关联关系。pending_id有效期为90天，超过有效期之后，将无法通过该接口将external_userid换取对应的pending_id。

权限说明：

仅认证企业可调用
该客户的跟进人或其所在客户群群主必须在应用的可见范围之内

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/idconvert/batch/external_userid_to_pending_id' \ --header 'Content-Type: application/json' \ --data-raw '{ "chat_id":"xxxxxx", "external_userid":["oAAAAAAA", "oBBBBB"] }'

{ "errcode": 0, "errmsg": "ok", "result": [ { "external_userid": "oAAAAAAA", "pending_id": "pAAAAA" }, { "external_userid": "oBBBBB", "pending_id": "pBBBBB" } ] }

请求参数

Query 参数

access_token

string

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

chat_id

string

可选

群id，如果有传入该参数，则只检查群主是否在可见范围，同时会忽略在该群以外的external_userid。如果不传入该参数，则只检查客户跟进人是否在可见范围内。

external_userid

array[string]

必需

该企业的外部联系人ID

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

result

array [object {2}]

转换结果

必需

external_userid

string

必需

该企业的外部联系人ID

pending_id

string

必需

该微信账号还未成为企业客户时，返回的临时外部联系人ID