external_userid查询pending_id

POST

https://qyapi.weixin.qq.com/cgi-bin/idconvert/batch/external_userid_to_pending_id

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

权限说明：

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

请求参数

Query 参数

Body 参数application/json

示例

{
  "chat_id":"xxxxxx",
  "external_userid":["oAAAAAAA", "oBBBBB"]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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"]
}'

返回响应

🟢200成功

application/json

Body

示例

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

修改于 2025-03-26 09:11:31

unionid转换为第三方external_userid

corpid的转换