批量更新客户企业标签

POST

/open-api/tag/batch_update

批量增加和删除标签，调用此接口需购买基础席位。

错误码	说明
20350	add_tag_id_list和rm_tag_id_list不可同时为空
20351	最多允许批量添加或删除50个标签
20352	客户不存在或没有添加客服
20353	批量打标签失败
20354	add_tag_id_list中存在非法tag_id:{tag_ext_id},请检查并确保标签合法
20355	remove_tag_id_list中存在非法tag_id:{tag_ext_id},请检查并确保标签合法
40096	企业微信api调用失败，客户id非法，请参考https://open.work.weixin.qq.com/devtool/query?e=40096
40003	企业微信api调用失败，员工id非法，请参考https://open.work.weixin.qq.com/devtool/query?e=40003
40068	企业微信api调用失败，标签id非法，请参考https://open.work.weixin.qq.com/devtool/query?e=40068

请求参数

Query 参数

Body 参数application/json

示例

{
    "staff_id":"WuJaYun",
    "external_user_id":"wm8xjUCxxxxxxxxxxxxJR9CCBb2g",
    "add_tag_id_list":["et8xjUCAAAxxxxxxxxxxx3UA","et8xjUCAAxxxxxxxxxxxxxzS67Wxru9A"],
    "remove_tag_id_list":["et8xjUCAAxxxxxxxxxxxcc-P60GQ"]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.weibanzhushou.com/open-api/tag/batch_update?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "staff_id":"WuJaYun",
    "external_user_id":"wm8xjUCxxxxxxxxxxxxJR9CCBb2g",
    "add_tag_id_list":["et8xjUCAAAxxxxxxxxxxx3UA","et8xjUCAAxxxxxxxxxxxxxzS67Wxru9A"],
    "remove_tag_id_list":["et8xjUCAAxxxxxxxxxxxcc-P60GQ"]
}'

返回响应

🟢200成功

application/json

Body

示例

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

🟢200正常返回

修改于 2024-03-26 05:10:29

获取标签列表

给客户添加企业标签