工单系统
重开(重新激活)工单
将已完结工单重新激活,重新分配给坐席或组进入处理中状态。targetStaff 和 targetGroup 必须传一个且只能传一个;comment 必填且不超过 35000 字符,超出或为空直接报错。重开前会校验工单是否已被删除;成功后工单重新进入处理流程。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳(秒) | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0 - 默认(SHA1),1 - SHA256 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ticketId | int64 | 是 | 工单 ID | 123456 |
| staffId | int64 | 是 | 操作坐席 ID | 10001 |
| comment | string | 是 | 重开原因,最长 35000 字符 | 用户表示退款仍未到账,请重新跟进处理。 |
| targetStaff | int64 | 否 | 目标坐席 ID(与 targetGroup 二选一) | 10002 |
| targetGroup | int64 | 否 | 目标客服组 ID(与 targetStaff 二选一) | 20001 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| message | string | 提示信息:成功时为业务数据,失败时为错误描述 | true |
错误码
| 状态码 | 描述 |
|---|---|
| 14004 | ticketId/staffId/comment 为空;targetStaff 与 targetGroup 均为空;comment 超过 35000 字符;JSON 格式错误 |
| 14100 | staffId 不存在或已停用 |
| 14106 | 工单已被删除 |
| 14500 | 服务内部异常 |
postEndpoint
/openapi/v2/ticket/reopencurl -X POST "https://qiyukf.com/openapi/v2/ticket/reopen?appKey=string&time=0&checksum=string" \ -H "Content-Type: application/json" \ -d '{ "ticketId": 123456, "staffId": 10001, "comment": "用户表示退款仍未到账,请重新跟进处理。" }'{
"code": 200,
"message": "true"
}{
"code": 14004,
"message": "ticketId/staffId/comment 为空;targetStaff 与 targetGroup 均为空;comment 超过 35000 字符;JSON 格式错误"
}{
"code": 14100,
"message": "staffId 不存在或已停用"
}{
"code": 14106,
"message": "工单已被删除"
}{
"code": 14500,
"message": "服务内部异常"
}这篇文档有帮助吗?