# 客户标签接口
# 创建客户标签属性
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/cusLabel/v1/createCusLabel/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 }"
}