客户标签ID的转换

POST

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

将企业主体下的客户标签ID转换成服务商主体下的客户标签ID。
权限说明：

应用需具有“企业客户权限->客户基础信息”权限

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/idconvert/external_tagid' \
--header 'Content-Type: application/json' \
--data-raw '{
  "external_tagid_list":["TAG_ID1","TAG_ID2","TAG_ID3","TAG_ID4"]
}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "items": [
    {
      "external_tagid": "TAG_ID1",
      "open_external_tagid": "OPEN_TAG_ID1"
    },
    {
      "external_tagid": "TAG_ID2",
      "open_external_tagid": "OPEN_TAG_ID2"
    }
  ],
  "invalid_external_tagid_list": [
    "TAG_ID3",
    "TAG_ID4"
  ]
}

请求参数

Query 参数

access_token

string

可选

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

示例值:

ACCESS_TOKEN

Body 参数application/json

external_tagid_list

array[string]

必需

企业主体下的客户标签ID列表，最多不超过1000个

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

items

array [object {2}]

客户标签转换结果

必需

external_tagid

string

必需

服务商主体下的客户标签ID，如果传入的external_tagid已经是服务商主体下的ID，则open_external_tagid与external_tagid相同。

open_external_tagid

string

必需

无法转换的客户标签ID列表

invalid_external_tagid_list

array[string]

必需

修改于 2022-12-05 10:29:22

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

微信客服ID的转换