管理企业标签-添加企业客户标签

POST

http://127.0.0.1/cgi-bin/externalcontact/add_corp_tag

最后修改时间：2022-08-30 03:03:37

责任人：未设置

企业可通过此接口向客户标签库中添加新的标签组和标签，每个企业最多可配置3000个企业标签。
注意:
如果要向指定的标签组下添加标签，需要填写group_id参数；如果要创建一个全新的标签组以及标签，则需要通过group_name参数指定新标签组名称，如果填写的groupname已经存在，则会在此标签组下新建标签。
如果填写了group_id参数，则group_name和标签组的order参数会被忽略。
不支持创建空标签组。
标签组内的标签不可同名，如果传入多个同名标签，则只会创建一个。

文档ID: 17298
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/92117
https://open.work.weixin.qq.com/api/doc/90001/90143/92696

请求参数

Query 参数

Body 参数application/json

示例

{
    "group_id": "GROUP_ID",
    "group_name": "GROUP_NAME",
    "order": 1,
    "tag": [
        {
            "name": "TAG_NAME_1",
            "order": 1
        },
        {
            "name": "TAG_NAME_2",
            "order": 2
        }
    ],
    "agentid": 1000014
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/externalcontact/add_corp_tag?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "group_id": "GROUP_ID",
    "group_name": "GROUP_NAME",
    "order": 1,
    "tag": [
        {
            "name": "TAG_NAME_1",
            "order": 1
        },
        {
            "name": "TAG_NAME_2",
            "order": 2
        }
    ],
    "agentid": 1000014
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "errmsg": "string",
    "tag_group": {
        "create_time": 0,
        "group_id": "string",
        "group_name": "string",
        "tag": [
            {
                "create_time": 0,
                "name": "string",
                "id": "string",
                "order": 0
            }
        ],
        "order": 0
    }
}

修改于 2022-08-30 03:03:37

管理企业标签-获取企业标签库

管理企业标签-编辑企业客户标签