给客户添加标签
最后更新:2022/10/25给指定客户添加客户标签(企业标签或业务标签)。
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/customer/tag/add?access_token=x
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
userid | string | 否 | 当客户添加的员工超过10人时,该参数为必填项; 不超过10人时,将一次性把标签打在所有的好友关系上 |
external_user_id | string | 是 | 外部联系人 |
type | int | 是 | 0:添加(新添加指定标签)1:覆盖(完全覆盖原标签)2:清除(移除对应标签类型下全部标签)3:剔除(剔除指定标签)4:添加及剔除(添加指定标签同时剔除指定标签) |
tag_type | int | 否 | 0:企业标签,1:业务标签,2:内部标签,tag_type默认:企业标签。 |
tag_list | string[] | 否 | 标签id集合(type为0,1,4时必传) |
remove_tag_list | string[] | 否 | 剔除标签id集合(type为3,4时必传) |
参数示例:
{
"userid": "YunHanceshi",
"external_user_id": "wmJYSuBgAAFyDEU2SLeCVZbblxaxzX4w",
"type": 0,
"tag_type": 0,
"tag_list": [
"TAG_ID1",
"TAG_ID2"
],
"remove_tag_list": [
"TAG_ID1",
"TAG_ID2"
]
}
返回值:
{
"code": 0,
"msg": "请求成功",
"data": true
}
返回说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 出错返回码,为0表示成功,非0表示调用失败 |
msg | string | 返回码描述 |
data | bool | 是否操作成功 |