对象打标签&移除标签

POST

/tags/open-api/object-set-tag

最后修改时间：2025-05-24 01:27:31

对象打标签，目前支持市场线索，会员，粉丝打标签接口。
object字段为对象标识 leads_schema_data=市场线索对象，member=会员对象，user_wx_relation=粉丝对象，externalDataSource=外部数据源。
每次请求最多支持批量打标签人数为10人。

返回参数说明

参数名称	说明
code	返回码
msg	错误信息
data	数据集

返回码说明

参数名称	说明
-3	系统异常（%s）
-2	请求地址错误（404）
-1	失败
0	成功
1	未知状态码
2	不合法的访问令牌(%s)
3	接口访问权限校验不通过
10000	缺少参数(%s)
10001	无效参数(%s)
10002	错误的access_token
10003	access_token已过期
10004	此接口暂未授权，请联系客服进行开通后使用。
10005	接口访问次数超限
10006	org_id不能为空
10007	user_id不能为空
14001	未匹配到对应的主账号ID（main_id）
14002	请输入分组名称
14003	所属分组不存在
14004	超过最大分组层数限制
14005	标签分组名称重复
14006	请选择标签分组或输入要搜索的标签名称
14007	请输入标签名称
14008	请选择标签分组
14009	标签名称重复
14010	只能在末级分组添加标签
14011	标签ID为空
14012	请删除分组下标签后再操作
14013	请输入分组排序信息
14014	分组排序信息格式错误
14015	请删除下级分组后再操作
14016	请输入分组名称
14017	标签不能移动到不可编辑的分组中
14018	不可编辑分组下的标签不能移出
14019	标签不能添加到不可编辑的分组中
14020	子分组不能添加到不可编辑的分组中
14021	不可编辑分组不可操作
14022	请选择用户
14023	请选择标签
14024	请选择对象
14025	移除标签不支持批量移除
14026	操作频繁，请稍后点击更新，预计可点击更新按钮时间：%s
14027	标签不存在
14028	接口最大支持批量打标签人数为%s人

请求参数

Query 参数

access_token

string

必需

示例值:

Body 参数multipart/form-data

object

string

必需

对象类型， leads_schema_data=市场线索对象，member=会员对象，user_wx_relation=粉丝对象，externalDataSource=外部数据源，mochatLink=企微外部联系人。

customer_ids

string

必需

对象唯一标识，支持多个，（一次性最多10个，用,英文逗号隔开）【不同对象可通过对象基础信息接口获取】
1丶object=leads_schema_data时，此值输入线索的customer_id【可通过接口{线索->获取线索列表接口中的data.list.customer_id中取值}】。
2丶object=member时，此值输入会员的member_id【可通过接口{会员-获取基础信息接口中的data.id中取值}】。
3丶object=user_wx_relation时，此值输入粉丝的openid即可。
4丶当object=mochatLink企微外部联系人时，需指定数据源信息进行打标签（此值为外部联系人的唯一标识，通过获取客群列表数据-V2【返回的数组中data.list.identity_id字段获得】）

tag_name

string

标签名称

可选

nextId

string

可选

1丶当object=user_wx_relation粉丝对象时，需指定公众号信息进行打标签（此值为公众号唯一标识，从接口【应用中心->公众号管理->获取微信公众号列表接口的data.wx_id字段获得】）。
2丶当object=externalDataSource外部数据源时，需指定数据源信息进行打标签（此值为外部数据源表结构唯一标识，从接口【客群->获取客群列表接口->返回的数组中data.id字段获得】）
3丶当object=mochatLink企微外部联系人时，需指定数据源信息进行打标签（此值为外部数据源表结构唯一标识，通过获取客群对象列表，参数customersField=mochatLink获取，返回的数组中data.id字段获得）

示例值:

id_string

string

可选

标签唯一标识，支持多个，用,英文逗号隔开（如果传入，就会此值为准，不接收tag_name标签名称）

remove_id_string

string

可选

移除标签，标签唯一标识（移除标签仅限此参数），标签名称参数不支持批量

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://openapi.beschannels.com/tags/open-api/object-set-tag?access_token=uURA1lnYsBr22I6UYoLZH0s9y3HU2Xsn7UHA4dIDgHN_67Z5EZskh4YMcymD5enS4GGjWpOERwQtug3Y4AGwvbvLB_A3TwKBpb_J4z0MUm6oaNQmqA-3Ef9Q-PHbVPk3' \
--form 'object=""' \
--form 'customer_ids=""' \
--form 'tag_name=""' \
--form 'nextId="86"' \
--form 'id_string=""' \
--form 'remove_id_string=""'

返回响应

🟢200成功

application/json

Body

code

integer

必需

msg

string

必需

data

array[string]

必需

示例

{
    "code": 0,
    "msg": "成功",
    "data": []
}

标签管理-标签/编辑/移动

获取对象和对象标签（对象ID必传）

对象打标签&移除标签

返回参数说明#

返回码说明#

请求参数

示例代码

返回响应

返回参数说明

返回码说明