微伴助手OpenAPI

删除客户的微伴个人标签

POST/open-api/tag/internal/remove

删除指定客户的微伴个人标签。删除标签时可以通过标签名删除，也可以通过标签id删除。

标签总是和客服相关，所以删除标签时同时需要提供客服的员工id。
调用此接口需购买基础席位。

错误码	说明
20350	external_user_id错误
20351	external_user_unionid错误
20352	请提供external_user_id或external_user_unionid
20353	找不到对应员工

注意：删除标签是「打标签」的逆操作，只会影响所选客户，并不会从所有客户中删除此标签。

请求参数

staff_id

string

客服员工id

必需

external_user_id

string

可选

客户id。external_user_id 和 external_user_unionid 必须选择一个填写

external_user_unionid

string

可选

客户unionid。external_user_id 和 external_user_unionid 必须选择一个填写

external_user_openid

string

可选

客户openid。密文企业选择 external_user_unionid 时需填写

tag_name

string

希望删除的标签名称

必需

{
  "staff_id": "zhangsan",
  // external_user_id 和 external_user_unionid 只需填写一个
  "external_user_id": "wo8xjUCAAAGfqRyM0CGqryOsaKOYgEZE",
  "external_user_unionid": "oz9xvw_jfkmHMGWVSn5CatKSTOMU",
  "tag_name": "标签1"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

errcode

integer

必需

状态码，0为正常，非0代表错误。

errmsg

string

必需

错误信息，成功时为'ok'，错误时会以中文方式显示错误原因

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

最后修改时间： 10 个月前