批量退回线索

最后更新: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 成功

results matching ""

    No results matching ""