开发者中心
首页
教程
接口
社区
工具
企业内部开发
快速入门 服务端API 客户端API 附录 更新日志 联系我们
企业内部开发 服务端API 客户联系 客户标签管理 管理企业规则组下的客户标签
管理企业规则组下的客户标签
最后更新：2023/12/01
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
管理企业规则组下的客户标签
最后更新：2023/12/01

目录

  • 获取指定规则组下的企业客户标签
  • 为指定规则组创建企业客户标签
  • 编辑指定规则组下的企业客户标签
  • 删除指定规则组下的企业客户标签

    • 企业规则组下的客户标签仅可被该规则组管理范围内的企业成员使用。

    权限说明:
    调用的应用需要满足如下的权限

    应用类型权限要求
    自建应用配置到「客户联系 可调用接口的应用」中
    代开发应用具有「管理客户联系规则组」权限
    第三方应用具有「管理客户联系规则组」权限
    提示
    应用仅能获取和管理由本应用创建的规则组标签

     

    注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情

     

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

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

     

    请求方式: POST(HTTP)

    请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_strategy_tag_list?access_token=ACCESS_TOKEN

    请求示例:

    {
	"strategy_id":1,
	"tag_id":
	[
		"etXXXXXXXXXX",
		"etYYYYYYYYYY"
	],
	"group_id":
	[
		"etZZZZZZZZZZZZZ",
		"etYYYYYYYYYYYYY"
	]
}

     

    参数说明:

    参数必须说明
    access_token是调用接口凭证
    strategy_id否规则组id
    tag_id否要查询的标签id
    group_id否要查询的标签组id，返回该标签组以及其下的所有标签信息
    若tag_id和group_id均为空，则返回所有标签。
    同时传递tag_id和group_id时，忽略tag_id，仅以group_id作为过滤条件。

     

    返回结果:

    {
	"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
			}
		]
	}]
}

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    tag_group标签组列表
    tag_group.group_id标签组id
    tag_group.group_name标签组名称
    tag_group.create_time标签组创建时间
    tag_group.order标签组排序的次序值，order值大的排序靠前。有效的值范围是[0, 2^32)
    tag_group.strategy_id标签组所属的规则组id
    tag_group.tag标签组内的标签列表
    tag_group.tag.id标签id
    tag_group.tag.name标签名称
    tag_group.tag.create_time标签创建时间
    tag_group.tag.order标签排序的次序值，order值大的排序靠前。有效的值范围是[0, 2^32)

     

    为指定规则组创建企业客户标签

    企业可通过此接口向规则组中添加新的标签组和标签，每个企业的企业标签和规则组标签合计最多可配置10000个。注意，仅可在一级规则组下添加标签。

     

    请求方式: POST(HTTP)

    请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_strategy_tag?access_token=ACCESS_TOKEN

    请求示例:

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

    参数说明:

    参数必须说明
    access_token是调用接口凭证
    strategy_id是规则组id
    group_id否标签组id
    group_name否标签组名称，最长为30个字符
    order否标签组次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
    tag.name是添加的标签名称，最长为30个字符
    tag.order否标签次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
    注意:
    如果填写了group_id参数，则group_name和标签组的order参数会被忽略。
    如果填写的group_name和此规则组下的其他标签组同名，则会将相关标签加入已存在的同名标签组下
    不支持创建空标签组。
    标签组内的标签不可同名，如果传入多个同名标签，则只会创建一个。

     

    返回结果:

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

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    tag_group.group_id标签组id
    tag_group.group_name标签组名称
    tag_group.create_time标签组创建时间
    tag_group.order标签组次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
    tag_group.tag标签组内的标签列表
    tag_group.tag.id新建标签id
    tag_group.tag.name新建标签名称
    tag_group.tag.create_time标签创建时间
    tag_group.tag.order标签次序值。order值大的排序靠前。有效的值范围是[0, 2^32)

    编辑指定规则组下的企业客户标签

    企业可通过此接口编辑指定规则组下的客户标签/标签组的名称或次序值，但不可重新指定标签/标签组所属规则组。

     

    请求方式: POST(HTTP)

    请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/edit_strategy_tag?access_token=ACCESS_TOKEN

    请求示例:

    {
	"id": "TAG_ID",
	"name": "NEW_TAG_NAME",
	"order": 1,
	
}

    参数说明:

    参数必须说明
    access_token是调用接口凭证
    id是标签或标签组的id
    name否新的标签或标签组名称，最长为30个字符
    order否标签/标签组的次序值。order值大的排序靠前。有效的值范围是[0, 2^32)

     

    注意:修改后的标签组不能和已有的标签组重名，标签也不能和同一标签组下的其他标签重名。

     

    返回结果:

    {
    "errcode": 0,
    "errmsg": "ok"
}

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容

     

    删除指定规则组下的企业客户标签

    企业可通过此接口删除某个规则组下的标签，或删除整个标签组。

    请求方式: POST(HTTP)

    请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/del_strategy_tag?access_token=ACCESS_TOKEN

    请求示例:

    {
	"tag_id": [
		"TAG_ID_1",
		"TAG_ID_2"
	],
	"group_id": [
		"GROUP_ID_1",
		"GROUP_ID_2"
	],
}

    参数说明:

    参数必须说明
    access_token是调用接口凭证
    tag_id否标签的id列表
    group_id否标签组的id列表

     

    tag_id和group_id不可同时为空。
    如果一个标签组下所有的标签均被删除，则标签组会被自动删除。

     

    返回结果:

    {
    "errcode": 0,
    "errmsg": "ok"
}

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容

     

    上一篇
    管理企业标签
    下一篇
    编辑客户企业标签