external_userid的转换-转换客户群成员external_userid

POST

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

转换客户external_userid接口不支持客户群的场景，如果需要转换客户群中无好友关系的群成员external_userid，需要调用本接口，调用时需要传入客户群的chat_id。

权限说明：

仅代开发自建应用或第三方应用可调用
客户群的群主需要在应用可见范围内
若是第三方应用且已设置externaluserid迁移完成，禁止调用本接口

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

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

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

请求参数

Query 参数

access_token

string

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

chat_id

string

客户群ID

必需

external_userid_list

array[string]

必需

企业主体下的external_userid列表，建议200个，最多不超过1000个

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

items

array [object {2}]

必需

external_userid

string

必需

new_external_userid

string

必需

服务商主体下的external_userid

修改于 2022-12-05 03:54:50

external_userid的转换-转换客户external_userid

unionid与external_userid的关联