华为云用户手册

消息样例 场景描述：修改工单状态 URL：https:// 域名 /service/AICC__Case/1.0.0/openapi/status/update 请求头: { "Content-Type": "application/json", "access-token": "0000000000************7bm63KsRmEztTvyA="} 请求体： {"id": "c6m80000013uPdSDTGbY","status": "Completed","creatorId":"10gg000000sLj1ytR70C"} 响应头： { "connection": "keep-alive", "Content-Length": "16","Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数： {"resCode": "0","resMsg": "成功"}

消息样例 场景描述：取消工单 URL：https://域名/service/AICC__Case/1.0.0/openapi/case/cancel 请求头: { "Content-Type": "application/json", "access-token": "0000000000************7bm63KsRmEztTvyA="} 请求体： {"id": "c6m80000013LvTIsdeJU","creatorId":"10gg000000sLj1ytR70C"} 响应头： { "connection": "keep-alive", "Content-Length": "16","Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数： {"resCode": "0","resMsg": "成功"}

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码 0409000 表示成功 其他表示失败 1.2 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：指派人工复核任务。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"qualityTaskId": 954645333549048833,"setCountsType": 1,"isTakeEffect": 0,"setCounts": [{"personID": "1600226476732482572","count": 2}]} 响应参数: {"resultCode": "0409000","resultDesc": "操作成功"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 qualityTaskId number True 抽检任务ID 1.2 setCountsType number True 指派质检员类型，当前只支持1 1.3 isTakeEffect number True 是否立即生效，0、1 1.4 setCounts array[object] True 质检员列表 1.4.1 personID string True 质检员用户ID 1.4.2 count number False 指派任务数量，小于等于8位

报文样例 场景描述：查询人工复核任务。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"customColumns": [],"fixedColumns": {"fileName": "","creatOperator": "","reviewingOfficer": "","status": null,"planName": "","customerPhone": ""},"currentRole": "qualityDirector","startTimeMillis": 1623319872,"endTimeMillis": 1623924672,"callStartTimeMillis": null,"callEndTimeMillis": null,"page": 1,"rows": 10} 响应参数: {"total": 4,"data": [{"reviewFinishedCount": 0,"inspectFinishedCount": 0,"planName": "er32324","isManipulate": 0,"inspectTotalCount": 10,"planCode": "16239241148860783173","planCodeStr": "16239241148860783173","creatOperator": "zjzglong","createTime": 1623924115,"id": "16239241148860783173","personType": 1,"reviewTotalCount": 0,"status": "4"}, {"reviewFinishedCount": 0,"inspectFinishedCount": 0,"planName": "234","isManipulate": 0,"inspectTotalCount": 10,"planCode": "16239245027406915901","planCodeStr": "16239245027406915901","creatOperator": "zjzglong","createTime": 1623924503,"id": "16239245027406915901","personType": 0,"reviewTotalCount": 0,"status": "0"}, {"reviewFinishedCount": 0,"inspectFinishedCount": 0,"planName": "tes23","isManipulate": 0,"inspectTotalCount": 10,"planCode": "16238263488553287941","planCodeStr": "16238263488553287941","creatOperator": "zjzglong","createTime": 1623826349,"id": "16238263488553287941","personType": 1,"reviewTotalCount": 0,"effectiveDate": 1623913453,"status": "1"}, {"reviewFinishedCount": 0,"inspectFinishedCount": 0,"planName": "用例测试","isManipulate": 0,"inspectTotalCount": 2,"planCode": "16239128427437922220","planCodeStr": "16239128427437922220","creatOperator": "zjzglong","createTime": 1623912843,"id": "16239128427437922220","personType": 1,"reviewTotalCount": 0,"status": "1"}],"resultCode": "0409000","resultDesc": "操作成功"}

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 total number True 总条数 1.2 data array[object] True 抽检任务列表 1.2.1 id number False 抽检任务ID 1.2.2 planCode string True 抽检任务 1.2.3 planCodeStr string True 抽检任务 1.2.4 planName string True 抽检任务名称 1.2.5 createTime number True 抽检任务创建时间 1.2.6 creatOperator string True 创建人 1.2.7 callStart number False 发话开始时间 1.2.8 callEnd number False 发话结束时间 1.2.9 inspectTotalCount number True 质检通话总数 1.2.10 inspectFinishedCount number True 完成质检的通话数 1.2.11 reviewTotalCount number True 质检通话复核总数 1.2.12 reviewFinishedCount number True 质检通话复核完成数 1.2.13 status string True 生效状态 1.2.14 effectiveDate number False 生效时间 1.2.15 personType number True 是否是当前操作员创建 1.2.16 reviewingOfficer string False 复核人员userId 1.2.17 reviewingOfficerName string False 复核人员名称 1.2.18 isManipulate number True 是否可以操作当前质检任务 1.2.19 interactionType string false 交互类型。取值范围： 0：音频 2：文本 1.3 resultCode number True 接口成功标识 1.4 resultDesc string False 成功或失败信息 1.5 returnCode string False 返回码 0409000 表示成功 其他表示失败 1.6 returnDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码 0409000 表示成功 其他表示失败 1.2 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：更新人工复核任务。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "customColumns": null, "currentRole": "qualityDirector", "startTimeMillis": 1623834293, "endTimeMillis": 1623920692, "fixedColumns": { "maxNum": 1, "qualityCondition": 0, "qualityNum": 100, "qualityType": 1, "staffIds": [], "interactionType": 2 }, "qualityTask": { "planName": "css-1623920700092", "id": 16239207001133382753 }} 响应参数: {"resultCode": "0409000","resultDesc": "操作成功"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 currentRole string True 用户职位 1.2 startTimeMillis number False 通话起始时间 1.3 endTimeMillis number False 通话结束时间 1.4 fixedColumns object False 抽检详情 1.4.1 maxNum number False 最大抽检量，0-10000 1.4.2 qualityCondition number True 抽检状态，0、1、2 1.4.3 qualityNum number True 抽检数量 1.4.4 qualityType number True 抽检数量类型，1、2、3 1.4.5 durationStart number False 通话时长下限，0-100000000 1.4.6 durationEnd number False 通话时长上限，0-100000000 1.4.7 staffIds array[string] False 座席人员列表 1.4.8 scoreStart number False 机器分数下限，0-10000 1.4.9 scoreEnd number False 机器分数上限，0-10000 1.4.10 interactionType integer True 交互类型 0为语音 2为文本 1.5 qualityTask object False 抽检任务 1.5.1 planName string True 抽检任务名称，小于等于32位 1.5.2 id number True 抽检任务ID，同上述qualityTaskId

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码 0409000 表示成功 其他表示失败 1.2 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：生效人工复核任务。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"type": "1","reserveTime": "","qualityTaskId": 16239241148860783173} 响应参数: {"resultCode": "0409000","resultDesc": "操作成功"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 type string True 生效类型： 1：表示立即生效 2：表示预约时间生效 1.2 qualityTaskId number True 抽检任务ID 1.3 reserveTime string False 生效时间

消息样例 场景描述：查询工单详情 URL：https://域名/service/AICC__Case/1.0.0/openapi/case/{id} 请求头: { "Content-Type": "application/json", "access-token": "0000000000************7bm63KsRmEztTvyA="} 请求体： {"id": "c6m800000149ndrHRVNQ"} 响应头： { "connection": "keep-alive", "Content-Length": "16","Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数： {"resCode": "0", "resMsg": "成功", "result": [ { "caseInfo": { "AICC__IsCanced__ CS T": false, "AICC__IsSuspend__CST": false, "AICC__Origin__CST.name": "Email", "AICC__Priority__CST.name": "Critical", "AICC__Reason__CST.name": "", "AICC__State__CST.name": "Processing", "AICC__Status__CST.name": "y", "AICC__Type__CST.__objectType": "AICC__CaseType__CST", "AICC__Type__CST.name": "", "AICC__test1__CST": null, "attachment": "", "caseNo": "000000000000000000000000035013", "closedDate": null, "contactId": "ciIy0000012YLAA4Dulc", "contactPhone": null, "createdDate": "2023-06-16 16:25:22", "creatorId": "10gd000000rDybBRYkuu", "creatorName": "ServiceCloud", "description": "test", "dueDate": "2023-06-30 00:00:00", "extternalNo": null, "id": "c6m800000149ndrHRVNQ", "isUpgraded": false, "origin": "Email", "ownerId": "10gg000000sGyLvwHvOK", "ownerName": "ServiceCloud", "parentId": null, "priority": "Critical", "reason": null, "state": "Processing", "status": "y", "stayDate": null, "suspendAccumulatedTime": null, "suspendDate": null, "title": "test", "type": "cvmC00000149NzxF1ePA" }, "caseTrace": [ { "createdDate": "2023-06-16 16:25:22", "creatorId": "10gd000000rDybBRYkuu", "creatorName": "ServiceCloud", "description": null, "from": null, "fromName": null, "relatedId": null, "title": null, "toAddress": null, "type": "CreateCase" } ], "customerInfo": { "customerInfo": { "address": { "addressLine1": null, "addressLine2": null, "addressLine3": null, "addressLine4": null, "addressLine5": null, "addtionalAddress": "test", "area": null, "block": null, "buildingNo": null, "city": null, "country": null, "defaultBillingAddress": false, "defaultShippingAddress": false, "firstName": null, "id": "cw8O0000012YLAA6D6g4", "label": null, "lastName": null, "middleName": null, "phoneNumber1": null, "phoneNumber2": null, "province": null, "roomNo": null, "street": null, "subjectId": "ciIy0000012YLAA4Dulc", "title": null, "town": null, "zip": null }, "age": null, "bindAccount": [], "birthDay": null, "cellPhone1": "555555", "cellPhone2": null, "cellPhone3": null, "channel": null, "createdDate": "2023-04-17 18:13:53", "customFied": null, "customerName": "test5", "description": null, "email": "yh5@huawei.com", "email1": null, "email2": null, "fax": null, "firstName": null, "gender": "male", "id": "ciIy0000012YLAA4Dulc", "lastModifiedDate": "2023-04-17 18:14:51", "lastName": null, "level": null, "middleName": null, "name": null, "nickName": null, "organization": { "description": null, "email": null, "fax": null, "fixedPhone": null, "id": "cBbs0000012YLAA3eiVU", "industry": null, "logo": null, "organizationName": "test", "scale": null, "summary": null, "website": null }, "organizationId": "cBbs0000012YLAA3eiVU", "phone": null, "phone1": null, "phone2": null, "phone3": null, "picture": null, "remark": null, "status": null, "title": null, "userId": null, "website": null } }, "isFollower": false, "tasks": [] } ]}

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1 caseInfo object True 工单基本信息，该对象的参数说明请参见表4 caseInfo参数说明 2 caseTrace CaseTrace[] False 工单轨迹，该对象的参数说明请参见表5 CaseTrace参数说明 3 customerInfo object False 工单联系人信息，根据id调用联系人查询接口，参见表6 4 tasks object[] False 任务信息，该对象的参数说明请参见表4 5 isFollower boolean True 是否关注 表4 caseInfo参数说明 序号 名称 参数类型 是否必选 说明 1 id string True 工单id 2 caseNo string True 工单编号 3 status string True 工单当前流程节点 dataType : SingleSelect 枚举值： 0.Completed(默认值) 其他值业务自定义 4 title string False 工单标题 5 priority string False 优先级 dataType : SingleSelect 枚举值： Critical High Medium Low 6 parentId string False 父工单id 7 ownerId string True 处理人id 8 origin string True 优先级 dataType : SingleSelect 枚举值： Voice Whatsapp webchat Email 9 isUpgraded Boolean True 工单是否升级 10 extternalNo string True 外部工单编号 11 dueDate Datetime False 期望完成时间，时间格式为YYYY-MM-DD HH:mm:ss 12 description string True 工单描述 13 creatorId string True 工单处理者id 14 createdDate Datetime True 创建时间，时间格式为YYYY-MM-DD HH:mm:ss 15 contactId string False 联系人id 16 reason string True 工单原因分类 17 contactPhone string False 联系人电话 18 state string True 任务状态 dataType : SingleSelect 枚举值： Completed Pending Processing 19 stayDate string True 工单当前状态停留时间，时间格式为YYYY-MM-DD HH:mm:ss 20 suspendAccumulatedTime int True 工单停留时长，单位分钟，范围1~1439999 21 suspendDate string True 工单暂停时间，时间格式为YYYY-MM-DD HH:mm:ss 22 type string True 工单类型id，关联CaseType表 23 closedDate Datetime False 关闭时间 24 attachment string False 工单附件 25 creatorName string True 创建者名 26 ownerName string True 处理者名 表5 CaseTrace参数说明 序号 名称 参数类型 是否必选 说明 1 creatorId string True 工单处理者id 2 creatorName string True 工单处理者名称 3 type string True 处理类型： dataType : SingleSelect 枚举值： Iternal Email SMS CreateTask Social CreateCase 4 relatedId string False 关联记录id 5 title string False 标题 6 description string False 处理描述 7 from string False 发送人id 8 fromName string False 发送人姓名 9 toAddress string False 接收人地址 10 createdDate string False 轨迹处理时间 11 attachment string False 轨迹附件

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息正文的类型为JSON 2 access-token string True 用户访问租间token，参见调用鉴权接口 表2 请求体参数 序号 名称 参数类型 长度（字节） 是否必选 说明 1 id string 20 True 工单id 如果查询工单详情涉及的工单类别使用了自定义的工单模板，则工单模板上扩展的字段可继续在请求消息体中继续往后添加。

消息样例 场景描述：软件云调用接口查询客户信息 URL：/rest/oma/softwareconsole/tenant/querytenantbasic 请求头: { "X-Auth_Token":"0000000000srLl4pnoBc*************9DvgIB87KzYpxMdE9+vvzLZqYIw="} 响应头： { "connection": "keep-alive", "Content-Length": "16", "Content-Type": "application/json%3Bcharset=UTF-8"} 响应体： { "mobilePhone": "153****0991", "company":"华为XXXXXXXXX", "customerName":"zXXXXXX", "email":"sunk****@huawei.com", "vdn":"150", "createDate":1681203525000, "tenantSpaceStatus":"2", "portalUrl":"https://software.huawei.com/auth?client_id=xxxxx&redirect_uri=https://example.com/service-cloud/sm/login/portal.html"}

消息样例 场景描述：查询任务列表 URL：https://域名/service/AICC__Case/1.0.0/openapi/task/list 请求头: { "Content-Type": "application/json", "access-token": "0000000000************7bm63KsRmEztTvyA="} 请求体： { "limit": 1,"start": 0} 响应头： { "connection": "keep-alive", "Content-Length": "16","Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数： { "resCode": "0", "resMsg": "成功", "result": { "count": 1, "taskList": [ { "closedDate": null, "contactId": "ciIy0000013y7cC8T2rA", "createdDate": "2023-07-07T06:51:35.000Z", "creatorId": "10gg00000148QvgpaLAm", "creatorName": "liuhuqiong001", "description": "test001", "dueDate": "2023-07-08 00:00:00", "id": "ccqG0000014iXvGKONQO", "ownerId": "10gg00000148QvgpaLAm", "ownerName": "liuhuqiong001", "priority": "Low", "relateId": "c6m80000014iXKHqDw3c", "status": "Pending", "stayDate": null, "taskId": "ccqG0000014iXvGKONQO", "taskNo": "000000000000000000000000001002", "title": "show0612", "type": "Case" } ] }}

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1 taskList TaskList[] True 任务信息，该对象的参数说明请参见表4 2 count number True 符合条件的总数 表4 Tasklist参数说明 序号 名称 参数类型 是否必选 说明 1 taskId string True 任务id 2 taskNo string True 任务No 3 title string True 任务标题 4 ownerId string True 处理人id 5 priority string False 优先级 dataType : SingleSelect 枚举值： Critical High Medium Low 6 dueDate Datetime False 期望完成时间，时间格式为YYYY-MM-DD HH:mm:ss 7 status string True 任务状态 8 description string False 任务描述 9 creatorName string True 创建人名 10 ownerName string False 处理人名 11 creatorId string True 创建人id

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息正文的类型为JSON 2 access-token string True 用户访问租间token，参见调用鉴权接口 表2 请求体参数 序号 名称 参数类型 长度（字节） 是否必选 说明 1 title string 128 False 任务名称模糊查询 2 status string 128 False 任务状态 dataType : SingleSelect 枚举值： Completed Pending Processing 3 priority string 128 False 优先级 dataType : SingleSelect 枚举值： Critical High Medium Low 4 ownerId string 20 False 任务的责任人id 5 type string - False 关联类型： 取值： Case 6 relateId string 20 False 如果关联任务类型有值，这里也必须有值 7 start number - True 起始行数。（min:0） 8 limit number - True 本次查询要求返回的行数（min：1，max:100） 9 classification string 128 False 任务分类类型 （Todo；Processed；Created） 10 contactId string 20 False 联系人id 11 creatorId string 20 True 创建人id 12 startTime string - False 创建开始时间， 格式为YYYY-MM-DD HH:mm:ss 13 endTime string - False 创建结束时间， 格式为YYYY-MM-DD HH:mm:ss

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string False 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 qualityTaskId number True 抽检任务ID

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码 0409000 表示成功 其他表示失败 1.2 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：终止质检任务。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"qualityTaskId": "16239241148860783173"} 响应参数: {"resultCode": "0409000","resultDesc": "操作成功"}

报文样例 场景描述：获取通话的状态及ASR结果接口 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"limit": 10,"page": 1,"call_types": [0, 2],"staff_id": null,"upload_from": 1621333149,"upload_to": 1623925149,"status": [2]} 响应参数: {"data": [{"calls": [{"staff_name": "*****","create_time": 1622633782,"left_speed": 241.552,"left_speech_ratio": 0.4613,"file_name": "Consultant","left_channel": "customer","right_speech_ratio": 0.3252,"call_time": 1622633782,"inspect_status": 0,"right_channel": "staff","complain_status": -1,"call_id": "3b9cd7a9-d38c-4aa0-a35d-77f6abb9f497","left_silence_time": 88.46,"duration": 164.22,"upload_time": 1622633782,"right_silence_time": 110.82,"right_speed": 165.169,"staff_id": "1600226440112042215","call_uuid": "3b9cd7a9-d38c-4aa0-a35d-77f6abb9f497","review_status": -1,"call_type": 0,"status": 2}],"call_group_id": "3b9cd7a9-d38c-4aa0-a35d-77f6abb9f497"}, {"calls": [{"staff_name": "*****","create_time": 1622554272,"left_speed": 307.127,"left_speech_ratio": 0.251,"file_name": "myvoice","left_channel": "customer","right_speech_ratio": 0.206,"call_time": 1622554272,"inspect_status": 0,"right_channel": "staff","complain_status": -1,"call_id": "2ef38e9b-36dd-4c1f-97cb-a665a2d9de3a","left_silence_time": 260.03,"duration": 347.16,"upload_time": 1622554272,"right_silence_time": 275.65,"right_speed": 318.837,"staff_id": "1600226440112042215","call_uuid": "2ef38e9b-36dd-4c1f-97cb-a665a2d9de3a","review_status": -1,"call_type": 0,"status": 2}],"call_group_id": "2ef38e9b-36dd-4c1f-97cb-a665a2d9de3a"}, {"calls": [{"staff_name": "*****","create_time": 1622552201,"left_speed": 305.061,"left_speech_ratio": 0.251,"file_name": "myvoice","left_channel": "customer","right_speech_ratio": 0.206,"call_time": 1622552201,"inspect_status": 0,"right_channel": "staff","complain_status": -1,"call_id": "4aca6bb8-13e6-4fd8-ac5b-0402fbb5bef4","left_silence_time": 260.03,"duration": 347.16,"upload_time": 1622552201,"right_silence_time": 275.65,"right_speed": 319.676,"staff_id": "1600226440112042215","call_uuid": "4aca6bb8-13e6-4fd8-ac5b-0402fbb5bef4","review_status": -1,"call_type": 0,"status": 2}],"call_group_id": "4aca6bb8-13e6-4fd8-ac5b-0402fbb5bef4"}, {"calls": [{"staff_name": "*****","create_time": 1622552093,"left_speed": 324.068,"left_speech_ratio": 0.6081,"file_name": "6335","left_channel": "customer","right_speech_ratio": 0.185,"call_time": 1622552093,"inspect_status": 0,"right_channel": "staff","complain_status": -1,"call_id": "4a8507ec-8519-46ab-9ca7-241556a6eb6c","left_silence_time": 40.8,"duration": 104.12,"upload_time": 1622552093,"right_silence_time": 84.86,"right_speed": 230.53,"staff_id": "1600226440112042215","call_uuid": "4a8507ec-8519-46ab-9ca7-241556a6eb6c","review_status": -1,"call_type": 0,"status": 2}],"call_group_id": "4a8507ec-8519-46ab-9ca7-241556a6eb6c"}, {"calls": [{"staff_name": "*****","create_time": 1622528466,"left_speed": 307.127,"left_speech_ratio": 0.251,"file_name": "myvoice","left_channel": "customer","right_speech_ratio": 0.206,"call_time": 1622528466,"inspect_status": 0,"right_channel": "staff","complain_status": -1,"call_id": "ead642de-fa23-4bc0-adf5-f2bac9614b01","left_silence_time": 260.03,"duration": 347.16,"upload_time": 1622528466,"right_silence_time": 275.65,"right_speed": 321.354,"staff_id": "1600226440112042215","call_uuid": "ead642de-fa23-4bc0-adf5-f2bac9614b01","review_status": -1,"call_type": 0,"status": 2}],"call_group_id": "ead642de-fa23-4bc0-adf5-f2bac9614b01"}, {"calls": [{"staff_name": "*****","create_time": 1622513361,"left_speed": 306.439,"left_speech_ratio": 0.251,"file_name": "20208650","left_channel": "customer","right_speech_ratio": 0.206,"call_time": 1622513361,"inspect_status": 0,"right_channel": "staff","complain_status": -1,"call_id": "1e158a1a-2f6d-44f6-ba44-b15d52e21651","left_silence_time": 260.03,"duration": 347.16,"upload_time": 1622513361,"right_silence_time": 275.65,"right_speed": 320.515,"staff_id": "1600226440112042215","call_uuid": "1e158a1a-2f6d-44f6-ba44-b15d52e21651","review_status": -1,"call_type": 0,"status": 2}],"call_group_id": "1e158a1a-2f6d-44f6-ba44-b15d52e21651"}],"paging": {"total": 6}}

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 paging object False 页码信息 1.1.1 total number False 通话总数量 1.2 data array[object] False 通话信息列表 1.2.1 calls array[object] False 多通通话信息 1.2.1.1 call_id string False 会话标识 1.2.1.2 call_time number False 通话时间 1.2.1.3 call_type number False 文件类型 1.2.1.4 call_uuid string False 会话uuid 1.2.1.5 deal number False 业务是否成交 1.2.1.6 duration number False 通话时长 1.2.1.7 file_name string False 文件名称 1.2.1.8 left_channel string False 渠道信息，标识客户或者座席 1.2.1.9 left_silence_time number False 静音时间 1.2.1.10 left_speech_ratio number False 左声道通话比例，发话方取决于left_channel字段。 1.2.1.11 left_speed number False 左声道语速 1.2.1.12 right_channel string False 渠道信息，标识客户或者座席 1.2.1.13 right_silence_time number False 静音时间 1.2.1.14 right_speech_ratio number False 右声道通话比例 1.2.1.15 right_speed number False 右声道语速 1.2.1.16 staff_id string False 座席人员的userId 可在登录后，进入座席管理页面，查看接口返回的accountId 1.2.1.17 status number False 状态 0：表示等待质检。 1：表示质检处理中。 2：表示处理成功。 3：表示ASR转写中。 9：表示质检失败，发生错误，质检音频总流量达到每日上限，质检文件数量达到每日上限。 31：表示ASR转写结果语音内容为空。 32：表示语音转文本失败。 33：表示上传语音文件至ASR失败。 34：表示科大ASR传输任务提交失败。 35：表示执行多媒体质检任务失败。 36：表示TUC质检失败。 37：表示ASR将语音文件转换为文本失败。 38：表示更新质检结果失败。 39：表示执行质检任务失败。 40：表示语音文件无效。 1.2.1.18 upload_time number False 通话上传时间 1.2.1.19 staff_name string False 座席姓名 1.2.2 call_group_id string False 呼叫组 ID 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 call_from number False 通话起始时间 ：时间戳，单位秒 1.2 call_to number False 通话结束时间 ：时间戳，单位秒 1.3 call_types array[integer] True 通话文件类型 0表示语音类型 2表示文本类型 1.4 limit integer True 每页查询总数 1.5 page integer True 查询页数 1.6 status array[integer] True 质检状态: 0：表示等待质检。 1：表示质检处理中。 2：表示处理成功。 3：表示ASR转写中。 9：表示质检失败，发生错误，质检音频总流量达到每日上限，质检文件数量达到每日上限。 31：表示ASR转写结果语音内容为空。 32：表示语音转文本失败。 33：表示上传语音文件至ASR失败。 34：表示科大ASR传输任务提交失败。 35：表示执行多媒体质检任务失败。 36：表示TUC质检失败。 37：表示ASR将语音文件转换为文本失败。 38：表示更新质检结果失败。 39：表示执行质检任务失败。 40：表示语音文件无效。 1.7 keyword string False 对话关键词 1.8 staff_id string False 座席人员的userId 可在登录后，进入座席管理页面，查看接口返回的accountId 1.9 staff_name string False 座席姓名 1.10 upload_from number True 通话上传起始时间 1.11 upload_to number True 通话上传结束时间 1.12 duration_min integer False 通话时长范围最小值 1.13 duration_max integer False 通话时长范围最大值

请求说明 表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 如果工单处理涉及的工单类别使用了自定义的工单模板，则工单模板上扩展的字段可继续在请求消息体中继续往后添加。

消息样例 场景描述：工单处理 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": "成功"}

响应说明 响应状态码: 200 序号 名称 参数类型 是否必选 说明 1 caseTypeInfo CaseTypes True 工单类型详情，字段对象属性介绍见表3 CaseTypes工单类型参数说明。 表3 CaseTypes工单类型参数说明 序号 名称 参数类型 是否必选 说明 1 id string True 工单类型id 2 typeName string True 工单模板名称（唯一） 3 description string False 工单类型描述 4 status string True 类型状态 5 caseStatus string True 工单状态，多个用,分隔 6 tempalteId string True 关联的工单模板 7 contentTempalteId string False 关联的内容模板 8 parentId string False 父类型id 9 isStrctOrder boolean True 是否严格模式 10 creatorName string True 创建人名称 11 createdDate Datetime True 创建时间 12 lastModifiedName string True 最后修改人名称 13 lastModifiedDate Datetime True 最后修改时间

消息样例 场景描述：查询工单类型详情 URL：https://域名/service/AICC__Case/1.0.0/openapi/caseType/{id} 请求头: { "Content-Type": "application/json", "access-token": "0000000000************7bm63KsRmEztTvyA="} 请求体： {"id": "cvmC00000149NzxF1ePA"} 响应头： { "connection": "keep-alive", "Content-Length": "16","Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数： { "resCode": "0", "resMsg": "成功", "result": { "caseTypeInfo": { "caseStatus": "y,Completed", "contentTemplateId": null, "createdDate": "2023-06-16 10:26:31", "creatorName": "qianbin001", "description": "aaa", "id": "cvmC00000149NzxF1ePA", "isStrictOrder": false, "lastModifiedDate": "2023-06-16 10:26:50", "lastModifiedName": "10gd00000143C5ONGb0y", "parentId": null, "status": "Active", "templateId": "c7s800000149NtKyh4me", "typeName": "aaa" } }}