批量退回线索
最后更新:2025/07/09企业可通过此接口批量退回线索
●默认将线索退回 到 原来所在的线索池
●退回线索操作遵循SCRM后台线索设置的锁定配置; 若不锁定,则线索状态变更为待分配,有锁定期,则线索状态为已锁定,锁定期到后自动解锁(遵循SCRM)。
●退回后,线索回收次数 +1
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/crm/clue/batch/return?access_token=x
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"ids": [
1930511983321342722,
1930511983350702850
],
"user_id": "user_id",
"recovery_remark_type": "1",
"recovery_remark": "备注原因"
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
ids | long[] | 是 | 线索ids |
user_id | string | 是 | 操作人 |
recovery_remark_type | string | 否 | 退回原因,多级退回原因已,号分隔,如:"3407f1c1,f079702c,b2eee341" |
recovery_remark | string | 否 | 备注原因 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"success": 1,
"failed": 1,
"result_items": [
{
"clue_id": "1930511983082267393",
"reason": "",
"success": 1
},
{
"clue_id": "1930511983115821825",
"reason": "线索不存在",
"success": 0
}
]
},
"sub_code": "00000"
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 |
msg | string | 对返回码的文本描述内容 |
sub_code | string | 业务异常码 |
data | bool | 是否成功 |
success | int | 成功条数 |
failed | int | 失败条数 |
result_items | array | 失败列表 |
clue_id | string | 失败的线索ID |
reason | array | 失败原因 |
success | int | 成功,败标识:0 失败,1 成功 |