删除客户的微伴个人标签
POST
/open-api/tag/internal/remove删除指定客户的微伴个人标签。删除标签时可以通过标签名删除,也可以通过标签id删除。
标签总是和客服相关,所以删除标签时同时需要提供客服的员工id。
调用此接口需购买基础席位。
错误码 | 说明 |
---|---|
20350 | external_user_id错误 |
20351 | external_user_unionid错误 |
20352 | 请提供external_user_id或external_user_unionid |
20353 | 找不到对应员工 |
注意:删除标签是「打标签」的逆操作,只会影响所选客户,并不会从所有客户中删除此标签。
请求参数
Body 参数application/json
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"
}
最后修改时间: 7 个月前