管理企业规则组下的客户标签-获取指定规则组下的企业客户标签

POST

/cgi-bin/externalcontact/get_strategy_tag_list

服务端API企业内部开发

权限说明:

仅可使用“客户联系”secret获取的accesstoken来调用（accesstoken如何获取？）

企业可通过此接口获取某个规则组内的企业客户标签详情

若tag_id和group_id均为空，则返回所有标签。
同时传递tag_id和group_id时，忽略tag_id，仅以group_id作为过滤条件。

文档ID: 32022
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/94882

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_strategy_tag_list?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"strategy_id":1,"tag_id":["etXXXXXXXXXX","etYYYYYYYYYY"],"group_id":["etZZZZZZZZZZZZZ","etYYYYYYYYYYYYY"]}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "tag_group": [
    {
      "group_id": "TAG_GROUPID1",
      "group_name": "GOURP_NAME",
      "create_time": 1557838797,
      "order": 1,
      "strategy_id": 1,
      "tag": [
        {
          "id": "TAG_ID1",
          "name": "NAME1",
          "create_time": 1557838797,
          "order": 1
        },
        {
          "id": "TAG_ID2",
          "name": "NAME2",
          "create_time": 1557838797,
          "order": 2
        }
      ]
    }
  ]
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

group_id

array[string]

可选

要查询的标签组id，返回该标签组以及其下的所有标签信息

strategy_id

integer <int32>

规则组id

可选

tag_id

array[string]

要查询的标签id

可选

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

tag_group

array [object {6}]

标签组列表

可选

create_time

integer <int32>

可选

group_id

string

可选

group_name

string

可选

strategy_id

integer <int32>

可选

tag

array [object {4}]

可选

order

integer <int32>

可选

管理企业标签-删除企业客户标签

管理企业规则组下的客户标签-为指定规则组创建企业客户标签