微伴助手OpenAPI

批量更新客户企业标签

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

请求参数

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

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

object {0}

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

最后修改时间： 9 个月前