给联系人打标签 - 尘锋SCRM开放平台

编辑联系人好友标签和联系人标签，通过该接口新增和移除联系人的好友标签和联系人标签

POST https://qw-openapi-tx.dustess.com/open-integration-api/customer/v1/updateTags?accessToken=

Content-Type: application/json

接口限制：单次最多操作500个联系人，每分钟调用300次；

Params:

字段	类型	描述	是否必须
accessToken	`String`	accessToken	true

请求参数

请求参数名	类型	说明	是否必须
list	`Object[]`	更新数据列表，最多500条	true
list.customerId	`String`	联系人id	true
list.tags	`Object`	更新的好友标签信息（与联系人标签不能同时为空）	false
list.tags.add	`String[]`	添加的好友标签id列表	false
list.tags.remove	`String[]`	移除的好友标签id列表	false
list.bizTags	`Object`	更新的联系人标签信息（与好友标签不能同时为空）	false
list.bizTags.add	`String[]`	添加的联系人标签id列表	false
list.bizTags.remove	`String[]`	移除的联系人标签id列表	false

请求参数示例
json - Request-Example1:

{
    "list": [{
        "customerId": "b5a48cc7-d94d-11eb-8a97-ee6659fc100f",
        "tags": {
            "add": ["bc8aea7c-6fc5-11ed-bdab-1e80c02e3484"],
            "remove": []
        },
        "bizTags": {
            "add": [],
            "remove": ["bc8aea7c-6fc5-11ed-bdab-1e80c02e3484"]
        }
    }]
}

成功响应

响应参数名	类型	说明
code	`Int`	响应码 0:成功
msg	`String`	消息提示
success	`Bool`	请求成功与否
data	`Object[]`	数据信息
data.id	`String`	联系人id
data.code	`String`	操作结果码 0:成功
data.msg	`String`	操作结果提示

成功响应示例

{
    "code": 0,
    "success":true,
    "msg":"",
    "data":[
        {
            "id":"5f61784904a7059c9c111111",
            "code":0,
            "msg":"success"
        },
        {
            "id":"5f61784904a7059c9c111112",
            "code":20070408,
            "msg":"联系人好友标签不存在"
        }
    ]
}

错误响应示例

 {
    "success": false,
    "code": 10001,
    "msg": "system unknown error",
    "data": null
}