对象打标签&移除标签

POST

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

最后修改时间：2025-04-01 08:53:18

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

请求参数

Query 参数

access_token

string

必需

示例值:

Body 参数multipart/form-data

object

string

必需

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

customer_ids

string

必需

对象唯一标识，支持多个用,隔开【不同对象可通过对象基础信息接口获取】
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": []
}

修改于 2025-04-01 08:53:18

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

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