催单

坐席对工单发起催单，提醒受理人尽快处理，用于对未完结工单执行催单操作。comment 和 attachments 不能同时为空；comment 非空时长度不能超过 3000 字符。同一坐席对同一工单的催单间隔不能小于 1 分钟。催单记录插入成功后会同步触发催单事件，通知受理人。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0 - 默认(SHA1)，1 - SHA256

请求体

名称	类型	必填	描述	示例值
ticketId	int64	是	工单 ID	123456
staffId	int64	是	催单坐席 ID	10001
comment	string	是	催单内容，最长 3000 字符	用户催得比较急，请优先跟进退款进度。
attachments	string	否	附件列表 JSON 字符串，每项：{type, payload, fileName}	[{"type":2,"payload":"openapi/attachments/2024/07/refund-proof.pdf","fileName":"退款凭证.pdf"}]

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	string	催单记录 ID（字符串格式）	789

错误码

状态码	描述
8814	工单不存在
8851	催单内容超过 3000 字符或为空
8852	comment 和 attachments 均为空
8853	催单间隔小于 1 分钟
14004	ticketId 或 staffId 为空；JSON 格式错误
14100	staffId 不存在或已停用
14500	服务内部异常

postEndpoint

/openapi/v2/ticket/reminder

curl -X POST "https://qiyukf.com/openapi/v2/ticket/reminder?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "ticketId": 123456,    "staffId": 10001,    "comment": "用户催得比较急，请优先跟进退款进度。"  }'

{
  "code": 200,
  "message": "789"
}

{
  "code": 8814,
  "message": "工单不存在"
}

{
  "code": 8851,
  "message": "催单内容超过 3000 字符或为空"
}

{
  "code": 8852,
  "message": "comment 和 attachments 均为空"
}

{
  "code": 8853,
  "message": "催单间隔小于 1 分钟"
}

{
  "code": 14004,
  "message": "ticketId 或 staffId 为空；JSON 格式错误"
}

{
  "code": 14100,
  "message": "staffId 不存在或已停用"
}

{
  "code": 14500,
  "message": "服务内部异常"
}