TIP

# 创建客户标签接口

# 创建客户标签属性

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/cusLabel/v1/createCusLabel/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体：

{
    "trade_type": "1",
    "label_name": "标签",
    "color": "#38761d",
    "border_color": "#38761d",
    "background_color": "#38761d"
}

参数说明：

参数	类型	必填	说明
trade_type	VARCHAR(1)	是	客户分类，取值范围：1：客户；2：经销商；3：门店
label_name	VARCHAR(100)	是	标签名称（将要创建的客户标签的名称）
color	VARCHAR(100)	是	按钮颜色
border_color	VARCHAR(100)	是	边界颜色
background_color	VARCHAR(100)	是	背景颜色

返回结果：

{
     "return_code": 0, 
     "return_msg": "响应信息",
     "msg_id": "{ msg_id }"
}

# 查询客户标签接口

# 查询客户标签属性

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/cusLabel/v1/queryCusLabel/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体：

{
    "trade_type": "1",
    "label_name": "A_CUS013476"
}

参数说明：

参数	类型	必填	说明
trade_type	VARCHAR(100)	是	客户分类，取值范围：1：客户；2：经销商；3：门店
label_name	VARCHAR(100)	否	标签名称，如果该传入字段为空，则默认返回指定客户类型的所有标签。如果该传入字段不为空，则仅返回要查询的标签

返回结果：

{
     "return_code": 0, 
     "return_msg": "响应信息",
     "msg_id": "{ msg_id }",
     "response_data": "<<DATA>>"
}

数据DATA示例:


[
    {
        "trade_type":"1",
        "label_name":"test4",
        "label_id":8939187171037089569
    },
    {
        "trade_type":"1",
        "label_name":"test5",
        "label_id":8939187171123459265
    }
]

参数说明：

参数	类型	说明
trade_type	VARCHAR(1)	客户分类，取值范围：1：客户；2：经销商；3：门店
label_id	VARCHAR(100)	客户标签在365系统中的唯一标识
label_name	VARCHAR(100)	标签名称

# 批量客户打标签接口

# 批量客户打标签属性

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/cusLabel/v1/batchAddCusLabel/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体：

{
    "trade_type": "1",
    "lst_ids":  ["5761822370506262757","5761822370506262757"],
    "label_name": "标签",
    "label_id":"123456789"
}

参数说明：

参数	类型	必填	说明
trade_type	VARCHAR(1)	是	客户分类，取值范围：1：客户；2：经销商；3：门店
lst_ids	VARCHAR(100)	是	需要打标签的客户列表
label_name	VARCHAR(100)	否	标签名称,标签名称（优先读取标签id字段，如果标签id为空，则再读取标签名称字段）
label_id	VARCHAR(100)	否	标签id,客户标签在365系统中的唯一标识（如果该字段不为空，则不再读取标签名称字段值）

返回结果：

{
     "return_code": 0, 
     "return_msg": "响应信息",
     "msg_id": "{ msg_id }"
}

# 批量客户清空标签接口

# 批量客户清空标签属性

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/cusLabel/v1/batchClearCusLabel/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体：

{
    "trade_type": "1",
    "lst_ids": ["5761822370506262757","5761822370506262757"],
    "label_name": "标签",
    "label_id":"123456789"
}

参数说明：

参数	类型	必填	说明
trade_type	VARCHAR(1)	是	客户分类，取值范围：1：客户；2：经销商；3：门店
lst_ids	VARCHAR(100)	是	需要清空标签的客户列表
label_name	VARCHAR(100)	否	标签名称（优先读取标签id字段，如果标签id为空，则再读取标签名称字段，并对传入的所有客户，清空该字段对应的标签。如果标签id、标签名称均为空，则表示清空传入客户的所有标签）
label_id	VARCHAR(100)	否	标签id，客户标签在365系统中的唯一标识（如果该字段不为空，则不再读取标签名称字段值，并对传入的所有客户，清空该字段对应的标签）

返回结果：

{
     "return_code": 0, 
     "return_msg": "响应信息",
     "msg_id": "{ msg_id }"
}

# 删除客户标签接口

# 删除客户标签属性

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/cusLabel/v1/deleteCusLabel/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体：

{
    "trade_type": "1",
    "label_name": "标签",
    "label_id":"123456789"
}

参数说明：

参数	类型	必填	说明
trade_type	VARCHAR(1)	是	客户分类，取值范围：1：客户；2：经销商；3：门店
label_name	VARCHAR(100)	否	标签名称（优先读取标签id字段，如果标签id为空，则再读取标签名称字段）删除标签的同时，所有打上该标签的客户会自动删除该标签
label_id	VARCHAR(100)	否	客户标签在365系统中的唯一标识（如果该字段不为空，则不再读取标签名称字段值）删除标签的同时，所有打上该标签的客户会自动删除该标签

返回结果：

{
     "return_code": 0, 
     "return_msg": "响应信息",
     "msg_id": "{ msg_id }"
}

← 客户周边信息线索管理 →