# 创建工单
#### 场景描述
创建工单机机接口。上传附件需要在openapi接口账号的权限配置列表页面【自定义对象权限】页签下，配置AICC__CASE__CST的创建、编辑和API读、写权限
#### 接口方法
POST
#### 接口URL
https://域名/service/AICC__Case/1.0.0/openapi/case，例如域名是service.besclouds.com。
#### 请求说明
表1请求头参数 
| 序号 | 名称           | 参数类型   | 是否必选 | 说明                                                                                                                                           |
|:---|:---|:---|:---|:---|
| 1  | Content-Type | string | True | 消息正文的类型为JSON                                                                                                                                 |
| 2  | access-token | string | True | 用户访问租间token，access-token获取参见[鉴权配置机机接口（AICC集成部署）](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0260.html#ZH-CN_TOPIC_0000002481273558) |
   
表2请求体参数 
| 序号 | 名称       | 参数类型   | 是否必选 | 说明                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|:---|
| 1  | caseInfo | Object | True | 工单信息，该对象的参数说明请参见[表3] caseInfo列出来的字段只是任意工单都需要的一些标准字段，其他字段是可以根据工单对应的模板动态扩展。 |
   
 表3caseInfo参数说明 
| 序号 | 名称             | 参数类型     | 长度（字节） | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|:---|:---|
| 1  | title          | string   | 128    | True  | 工单标题                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 2  | description    | string   | 20000  | False | 工单描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 3  | type           | string   | 20     | True  | 工单类型，工单类型id                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 4  | ownerId        | string   | 20     | False | 工单的责任人，工单自动分配时可以不填写，创建工单接口中根据分配逻辑自动分配责任人                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 5  | isAtuoAssigned | boolean  | -      | True  | 是否自动分配 枚举值： - True  - False                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 6  | priority       | string   | -      | False | 优先级，Low/Medium/High/Critical（即紧急状态）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 7  | origin         | string   | -      | False | 工单来源： 枚举值： - Voice：语音  - Whatsapp：WhatsApp  - webchat：网页  - Email：邮件  - Wechat：微信  - Facebook：Facebook  - Twitter：X (Twitter)  - LINE：LINE  - SMS：短信  - Others：其他渠道   |
| 8  | dueDate        | DateTime | -      | False | 期望完成时间，格式为YYYY-MM-DD HH:mm:ss                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 9  | contactId      | string   | 20     | False | 工单对应的联系人                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 10 | attachment     | object   | -      | False | 附件大小不能超过5M，数量不超过5个，支持jpg 、png 、pdf 、jpeg 、gif、doc、docx格式。详细字段参见[表4]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 11 | creatorId      | string   | 20     | True  | 创建人                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 12 | contactPhone   | string   | 20     | False | 联系人电话                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 13 | beId           | string   | 20     | False | CRM客户较多，beId用于区分客户大区                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   
表4attachment字段说明 
| 序号 | 名称                | 参数类型   | 是否必填  | 说明                                                                                                                            |
|:---|:---|:---|:---|:---|
| 1  | attachmentIds     | String | False | 上传附件ID，通过分号分隔，最多上传5个                                                                                                          |
| 2  | attachmentContent | object | False | 上传附件内容，详细字段参见[表5] |
   
 表5attachmentContent字段说明 
| 序号 | 名称         | 参数类型   | 是否必填 | 说明               |
|:---|:---|:---|:---|:---|
| 1  | fileName   | string | True | 文件名称，需要包含扩展名     |
| 2  | fileStream | string | True | 文件二进制码流，大小不能超过4M |
   
![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png)
如果创建工单涉及的工单类别使用了自定义的工单模板，则工单模板上扩展的字段可继续在请求消息体中继续往后添加。
#### 响应说明
- **响应状态码: 200**
表6响应体参数 
| 序号 | 名称       | 参数类型   | 是否必选  | 说明                                                      |
|:---|:---|:---|:---|:---|
| 1  | caseId   | string | True  | 工单记录id                                                  |
| 2  | showInfo | string | False | 给客户发送邮件/短信，返回的报错信息。发送成功返回空。openapi接口不支持选择发送邮件短信，默认返回为空。 |
   
#### 消息样例
场景描述：创建工单
URL：https://域名/service/AICC__Case/1.0.0/openapi/case
- 请求头:
```
{
 "Content-Type": "application/json",
 "access-token": "0000000000************7bm63KsRmEztTvyA="
}
```
- 请求体：
  ```
  {
      "caseInfo": {
          "description": "testOpenApi",
          "type": "cvmC0000014Oc9jgT7ZI",
          "origin": "Voice",
          "dueDate": "2023-07-30 00:00:00",
          "isAutoAssigned": true,
          "priority": "Low",
          "title": "test",
          "contactId": "ciIy0000013y7cC8T2rA",
          "creatorId": "10gg00000148PCjKVDAu",
          "contactPhone": "15151852650"
      }
  }
  ```
  

- 响应头：
```
{ "connection": "keep-alive",
 "Content-Length": "16",
"Content-Type": "application/json%3Bcharset=UTF-8"}
```
- 响应参数：
```
{
"resCode": "0",
  "resMsg": "成功",
  "result": {"caseId":"coiO0000014hmYpZIqYq"}
}
```