# 设置客户好友标签

[异步回调] 设置客户好友标签

说明:

该接口可针对单个客户设置可设置客户标签

同一个客户支持设置多个标签

企业标签同一标签组的标签支持多选。

请求方式:POST

请求地址:https://api.aquanliang.com/gateway/qopen/SetCustomerByRobotTags

body参数

{
    "robot_id": "机器人id",
    "contact_id": "客户id",
    "set_type": 1,
    "tag_id_list": ["标签id"]
}
字段 类型 必填 说明
robot_id string 机器人id
contact_id string 客户id
set_type int 操作类型:1新增标签,2移除标签
tag_id_list array 标签id,注:标签编号最多支持传入50个

返回值:

{
    "data": {
        "serial_no": "操作序列号"
    },
    "errcode": 0,
    "errmsg": ""
}

返回说明

字段 类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
serial_no string 操作序列号

处理结果,异步返回值:

{
    "event_type": 702005,
    "serial_no": "操作序列号",
    "robot_id": "机器人id",
    "err_code": 0,
    "err_msg": "success",
    "data": {
        "contact_id": "客户id",
        "tag_id_list": [
            "标签id"
        ],
        "failed_tag_id_list": [
            "标签id"
        ],
        "set_type": 1
    }
}

返回说明

字段 类型 说明
event_type int 事件类型,702005
serial_no string 操作序列号
err_code int 状态码,0为正常,非0代表错误
err_msg string 错误信息
robot_id string 机器人id
data object 返回数据
data.contact_id string 客户id
data.tag_id_list array 设置成功的标签列表
data.failed_tag_id_list array 设置失败的标签列表
data.set_type int 操作类型:1新增标签,2移除标签

完整请求示例:

curl -X POST https://api.aquanliang.com/gateway/qopen/SetCustomerByRobotTags \
     -H 'Content-Type: application/json; charset=UTF-8' \
     -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
     -d '{
            "robot_id": "机器人id",
            "tag_id": "标签id"
         }'