文档首页/ 云客服/ API参考/ Case2.0接口参考/ 工单处理接口(V2.0)/ 工单处理
更新时间：2025-03-07 GMT+08:00
查看PDF
分享

工单处理

描述

工单处理接口，工单责任人和管理员可以进行工单处理，工单处理时可以发送内部记录、邮件、即时消息。

接口方法

POST

接口URI

https://域名/service/AICC__Case/1.0.0/openapi/case/process，例如域名是service.besclouds.com。

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

string

True

消息正文的类型为JSON

2

access-token

string

True

用户访问租间token，参见调用鉴权接口
表2 请求体参数

序号

名称

参数类型

长度（字节）

是否必选

说明

1

caseId

string

20

True

工单id

2

processInfo

ProcessInfo

-

True

处理信息，该对象的参数说明请参见表3 ProcessInfo参数说明

3

creatorId

string

20

True

创建人id
表3 ProcessInfo参数说明

序号

名称

参数类型

长度（字节）

是否必选

说明

1

type

string

-

True

处理类型：

dataType : SingleSelect

枚举值：

0.Iternal

1.Email

2.SMS

2

title

string

128

True

标题

3

description

string

20000

True

处理描述

4

from

string

20

False

发送人id

5

fromName

string

80

False

发送人姓名

6

toAddress

string

2000

False

接收人地址

7

creatorId

string

20

False

操作处理人id

如果工单处理涉及的工单类别使用了自定义的工单模板，则工单模板上扩展的字段可继续在请求消息体中继续往后添加。

响应说明

  • 响应状态码: 200

无

消息样例

场景描述：工单处理

URL：https://域名/service/AICC__Case/1.0.0/openapi/case/process

  • 请求头:
{
 "Content-Type": "application/json"，
 "access-token": "0000000000************7bm63KsRmEztTvyA="
}
  • 请求体： 
    {
    "caseId": "c6m80000013ByxfHLVxo",
    "creatorId": "10gg000000sLj1ytR70C",
    "processInfo": {
        "type": "Iternal",
        "title": "123",
        "description": "456",
        "attachment": ""
    }
}
  • 响应头：
{ "connection": "keep-alive",
 "Content-Length": "16",
"Content-Type": "application/json%3Bcharset=UTF-8"}
  • 响应参数：
{"resCode": "0","resMsg": "成功"}