3.2.1 转换external_userid

POST

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

用于将企业主体的external_userid转换为服务商主体加密的external_userid，服务商可通过第三方应用和代开发应用调用该接口。

权限说明：

仅代开发自建应用或第三方应用可调用
客户联系和家校场景中，external_userid对应的跟进人需要在应用可见范围内
微信客服场景中，仅支持48小时内客服会话的external_userid

如果传入了新的external_userid，则原样返回。

请求参数

Query 参数

Body 参数application/json

示例

{
  "external_userid_list":["xxxxx","yyyyyy"]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_new_external_userid' \
--header 'Content-Type: application/json' \
--data-raw '{
  "external_userid_list":["xxxxx","yyyyyy"]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "items": [
        {
            "external_userid": "xxxxx",
            "new_external_userid": "AAAA"
        },
        {
            "external_userid": "yyyyy",
            "new_external_userid": "BBBB"
        }
    ]
}

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

3.1 升级前后对比-3.2 升级之后的接口变化

3.2.2 转换客户群成员external_userid