批量更新客户企业标签

POST

/open-api/tag/batch_update

openapi

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

错误码	说明
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 参数

access_token

string

调用接口凭证

必需

默认值:

Body 参数application/json

staff_id

string

可选

客户员工id（userid)，若不填则为所有员工打上标签，强烈建议填写

external_user_id

string

客户id

必需

add_tag_id_list

array[string]

可选

要添加的标签id列表，最大限制50个，和rm_tag_id_list二者必须填写一个

remove_tag_id_list

array[string]

可选

要删除的标签id列表，最大限制50个，和add_tag_id_list二者必须填写一个

示例

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

object {0}

示例

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

🟢200正常返回

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

获取标签列表

给客户添加企业标签