华为云用户手册

  • 请求说明 表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": "操作成功"}
  • 响应说明 响应状态码: 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 业务失败:请依次确认您请求中各参数的取值。
  • 报文样例 场景描述:获取通话的状态及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}}
  • 请求说明 表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": "成功"}
  • 消息样例 场景描述:查询工单类型详情 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" } }}
  • 响应说明 响应状态码: 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/list 请求头: { "Content-Type": "application/json", "access-token": "0000000000************7bm63KsRmEztTvyA="} 请求体: { "limit": 2,"start": 0} 响应头: { "connection": "keep-alive", "Content-Length": "16","Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数: { "resCode": "0", "resMsg": "成功", "result": { "caseTypes": [ { "caseStatus": "y,Completed", "contentTemplateId": null, "createdDate": "2023-06-16 10:46:37", "creatorName": "qianbin001", "description": "bbb", "id": "cvmC00000149PQzoNeq0", "isStrictOrder": false, "lastModifiedDate": "2023-06-16 10:46:58", "lastModifiedName": "10gd00000143C5ONGb0y", "parentId": null, "status": "Active", "templateId": "c7s800000149PO9VmEWu", "templateName": "bbbb", "typeName": "bbb" }, { "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", "templateName": "aaa", "typeName": "aaa" } ], "count": 65 }}
  • 响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1 caseTypes CaseTypes[] True 工单类型信息,参见表4。 2 count number True 符合条件的总数 表4 CaseTypes参数说明 序号 名称 参数类型 是否必选 说明 1 id string True 工单类型id 2 typeName string True 工单模板名称(唯一) 3 description string False 工单类型描述 4 status string True 类型状态 5 caseStatus string True 工单状态,多个用,分隔 6 templateId string True 关联的工单模板 7 templateName string True 关联的工单模板名称 8 contentTempalteId string False 关联的内容模板 9 parentId string False 父类型id 10 isStrictOrder boolean True 是否严格模式 11 creatorName string True 创建人名称 12 createdDate Datetime True 创建时间 13 lastModifiedName string True 最后修改人名称 14 lastModifiedDate Datetime True 最后修改时间
  • 请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息正文的类型为JSON 2 access-token string True 用户访问租间token 表2 请求体参数 序号 名称 参数类型 长度(字节) 是否必选 说明 1 typeName string 128 False 工单类型名称模糊查询 2 status string - False 类型状态,Active/Inactive 3 start number - True 起始行数。(min:0) 4 limit number - True 本次查询要求返回的行数(min:1,max:100)
  • 请求说明 请求头参数: 无。 请求体参数: 序号 名称 参数类型 是否必选 说明 1 callSerialNo string True 呼叫流水号 长度限制:string(50) 2 called string True 被叫号码 3 signature string False 签名。 当通过创建语音通知接口传入回调URL,并在回调url配置界面中“请输入共享密钥”配置了共享密钥,为必选。 4 timestamp string False 时间戳 当通过创建语音通知接口传入回调URL,并在回调url配置界面中“请输入共享密钥”配置了共享密钥,为必选。 5 nonce string False 随机数 当通过创建语音通知接口传入回调URL,并在回调url配置界面中“请输入共享密钥”配置了共享密钥,为必选。 6 callerPresent string False 主叫外显号码。 7 createCallTime string False 发起呼叫时间。例如:2022/02/17,13:10:06:836 8 alertingTime string False 用户振铃时间。 9 talkingTime string False 通话时间。 10 releaseTime string False 释放时间。 11 talkDuration string False 通话时长。 12 recordfile string False 录音路径。 13 locationId string False 录音节点。 14 releaseReason string False 释放原因码。 0: 呼通后,被叫挂机; 1: 呼通后,通知播完挂机; 4: 被叫拒接、被叫振铃后超时未接; 6: 振铃前呼叫失败; 8:无资源; 9:排队机超时; 10:呼叫受限; 999:UAP拉起录音会场失败;
  • 报文样例 请求参数: { "alertingTime": "2022/02/22,10:04:29:004", "callSerialNo": "1197765398201387012", "called": "88880067", "callerPresent": "960003", "createCallTime": "2022/02/22,10:04:28:823", "locationId": "0", "nonce": "-1482421808053124529", "recordfile": "Y:/2/mobileAgent/20220222/1645524268-824.wav", "releaseReason": "0", "releaseTime": "2022/02/22,10:04:36:318", "signature": "+lk************************50=", "talkDuration": "0", "talkingTime": "2022/02/22,10:04:30:418", "timestamp": "1645524163326"} 响应参数: { "retCode": "0", "retMsg": "success"}
  • 请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息正文的类型为JSON 2 access-token string True 用户访问租间token,access-token获取参见鉴权配置机机接口(SaaS集成) 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 caseInfo Object True 工单信息,该对象的参数说明请参见表3 caseInfo列出来的字段只是任意工单都需要的一些标准字段,其他字段是可以根据工单对应的模板动态扩展。 表3 caseInfo参数说明 序号 名称 参数类型 长度(字节) 是否必选 说明 1 title string 128 True 工单标题 2 description string 20000 True 工单描述 3 type string 20 True 工单类型,工单类型id 4 ownerId string 20 False 工单的责任人,工单自动分配时可以不填写,创建工单接口中根据分配逻辑自动分配责任人 5 isAtuoAssigned boolean - True 是否自动分配 6 priority string - False 优先级,Low/Medium/High/Critical 7 origin string - False 工单来源,Voice/Whatapp/webchat/Email 8 dueDate DateTime - False 期望完成时间,格式为YYYY-MM-DD HH:mm:ss 9 contactId string 20 True 工单对应的联系人 10 attachment string - False 附件大小不能超过5M,数量不超过5个,支持jpg 、png 、pdf 、jpeg 、gif、doc、docx格式 11 creatorId string 20 False 创建人 12 contactPhone string 20 False 联系人电话 13 beId string 20 False CRM客户较多,beId用于区分客户大区 如果创建工单涉及的工单类别使用了自定义的工单模板,则工单模板上扩展的字段可继续在请求消息体中继续往后添加。
  • 消息样例 场景描述:创建工单 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", "state": "Processing", "creatorId": "10gg00000148PCjKVDAu", "contactPhone": "15151852650" }} 响应头: { "connection": "keep-alive", "Content-Length": "16","Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数: {"resCode": "0", "resMsg": "成功", "result": {"caseId":"coiO0000014hmYpZIqYq"}}
  • 请求说明 表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 group_id string True 业务场景标识
  • 报文样例 场景描述:查询单个业务场景详情 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"group_id": "groupid_33bba990-c39e-4397-a649-1fdb46d54b17"} 响应参数: {"tenant_id": "202106114153","silence_rules": [{"rule_id": "920806740809748480","rule_name": "静默规则1"}],"other": {},"speed_rules": [],"interposal_rules": [],"create_time": 1624413549,"group_name": "业务场景1","group_id": "groupid_48450728-6b9d-4942-9884-2c5405e974d0","ignore_sensitive": 0,"is_enable": 0,"description": "","rules": []}
  • 响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 group_id string True 业务场景标识 1.2 group_name string False 业务场景名称 1.3 is_enable number True 是否正在被启用(0 代表不启用,1 代表启用) 1.4 other object False 业务场景触发条件 1.4.1 call_end number False 通话起始时间,时间戳毫秒 1.4.2 call_from number False 通话结束时间,时间戳毫秒 1.5 create_time number False 创建时间 1.6 description string False 业务场景描述 1.7 ignore_sensitive number False 是否计入敏感词分数(0 代表计入,1 代表不计入) 1.8 rules array[string] False 对话规则,多个规则值以逗号分隔 1.9 silence_rules array[string] False 静默规则,多个规则值以逗号分隔 1.10 speed_rules array[string] False 语速规则,多个规则值以逗号分隔 1.11 interposal_rules array[string] False 抢插话规则,多个规则值以逗号分隔 响应状态码: 400 错误的请求:请检查请求路径及参数。 响应状态码: 401 未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到:请检查请求的路径。 响应状态码: 500 业务失败:请依次确认您请求中各参数的取值。
  • 响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 call_uuid string False 通话任务id 响应状态码: 400 错误的请求:请检查请求路径及参数。 响应状态码: 401 未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到:请检查请求的路径。 响应状态码: 500 业务失败:请依次确认您请求中各参数的取值。
  • 报文样例 场景描述:创建质检任务。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"call_type": 0,"staff_name": "0","staff_id": "0","file_name": "helloworld123456"} 响应参数: {"call_uuid": "434l2j4242424jjl242"}
  • 请求说明 表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 call_time number False 通话时间 1.2 call_type number True 通话文件类型 1.3 file_name string True 上传文件名 1.4 staff_id string False 座席人员的userId 可在登录后,进入座席管理页面,查看接口返回的accountId 1.5 staff_name string False 座席姓名
  • 报文样例 场景描述:根据ID查询静默规则详情 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"silence_id": "922988537635147776"} 响应参数: {"exception": {"before": {"staff": [{"category_id": "894378237264662529","sentence_id": "14161","sentence_name": "意图名称demo1"}],"customer": []},"after": {"staff": []}},"resultCode": "0405000","resultDesc": "操作成功","setting": {"score": "-4","seconds": "5","times": "4","silence_id": "922988537635147776","other": {"call_end": 1624430285,"call_from": 1623911884},"name": "test35444"}}
  • 响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 exception object False 例外设定 1.1.1 before object False 静默之前的例外设定 1.1.1.1 staff array[object] False 座席说的句子标识集合 1.1.1.1.1 category_id string False 句子分类标识 1.1.1.1.2 sentence_id string False 句子标识 1.1.1.1.3 sentence_name string False 句子名称 1.1.1.2 customer array[object] False 客户说的句子标识集合 1.1.1.2.1 category_id string False 句子分类标识 1.1.1.2.2 sentence_id string False 句子标识 1.1.1.2.3 sentence_name string False 句子名称 1.1.2 after object False 静默之后的例外设定 1.1.2.1 staff array[object] False 座席说的句子标识集合 1.1.2.1.1 category_id string False 句子分类标识 1.1.2.1.2 sentence_id string False 句子标识 1.1.2.1.3 sentence_name string False 句子名称 1.2 resultCode string False 返回码,0405000表示成功,其他表示失败 1.3 resultDesc string False 返回描述 1.4 setting object False 静默规则基本信息 1.4.1 score string False 规则分数 1.4.2 seconds string False 连续静默秒数 1.4.3 times string False 静默次数 1.4.4 silence_id string False 静默规则标识 1.4.5 other object False 触发条件 1.4.5.1 call_end number False 单通通话开始时间:填写时间戳,单位秒 1.4.5.2 call_from number False 单通通话结束时间:填写时间戳,单位秒 1.4.6 name string False 规则名称 响应状态码: 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 False 操作员标识 可在登录后,进入员工管理页面,查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 silence_id string True 静默规则标识
  • 响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码 0408000 表示成功 其他表示失败 1.2 resultDesc string False 返回描述 响应状态码: 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 False 操作员标识 可在登录后,进入员工管理页面,查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 regularQualityTaskId number True 抽检任务ID,最大长度20位
  • 报文样例 场景描述:暂停定时抽检计划 请求头: Content-Type:application/json x-app-key:xxxx-xxxx-xxxx-xxxx-xxxx x-UserId:xxxx Authorization:Bearer ******************************** 请求参数: {"regularQualityTaskId": 954637368599307266} 响应头: Content-Type: application/json;charset=UTF-8 响应参数: {"resultCode": "0408000","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 False 操作员标识 可在登录后,进入员工管理页面,查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 group_id string True 业务场景标识 1.2 is_enable number True 该业务场景是否正在被启用(0 代表不启用,1 代表启用)
共100000条