华为云用户手册

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 severity string False 规则级别一般规则和重要规则："normal" "critical" 1.2 rule_id string False 规则标识 1.3 score string False 规则分数 1.4 other object False 附加条件 1.4.1 call_end number False 呼叫开始时间：填写时间戳，单位秒 1.4.2 call_from number False 呼叫结束时间：填写时间戳，单位秒 1.5 min string False 对话逻辑至少要出现几个 1.6 method string False 取值范围： positive negative 1.7 rule_name string False 规则名称 1.8 flows array[object] False 规则使用到的对话逻辑 1.8.1 flow_id string False 对话逻辑标识 1.8.2 flow_name string False 对话逻辑名称 1.9 resultCode string False 返回码，0405000表示成功，其他表示失败 1.10 description string False 规则描述 1.11 completeness object False 规则完整度对象 1.11.1 hasConversationFlow boolean False 是否有对话逻辑 1.11.2 sentenceComplete boolean False 规则中句子是否设定完整 1.11.3 ruleComplete boolean False 规则是否完整，当其余三个项目都为true时，值为true 1.11.4 hasDescription boolean False 是否有规则描述 1.12 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 rule_id string True 规则标识

报文样例 场景描述：更新句子 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "category_id": "1070149256381206528", "sentence_name": "句子名称766", "tagDataList": [ { "tag_type": "dialogue_act", "pos_sentences": [ { "name": "11111111111222222222" }, { "id": "10162", "name": "同义语料585111111111111111" } ], "neg_sentences": [ { "name": "1111111111111111" }, { "id": "10040", "name": "反义语料461111111111111" } ] }, { "tag_type": "keyword", "pos_sentences": [ { "name": "222222222222222222222222" }, { "id": "10094", "name": "关键字9891111111111111111" }, { "id": "10093", "name": "关键字11111111111111111111" } ] } ], "sentence_id": "10863", "deleteTagDataList": [] } 响应参数: { "resultCode": "0403000", "id": "10863", "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 category_id string True 句子分类的唯一标识 1.2 sentence_name string True 句子名称 1.3 sentence_id string True 句子标识 1.4 tagDataList array[object] True 句子使用到的语义与关键词 1.4.1 tag_type string True 标签类型，取值范围： keyword：关键字 dialogue_act：语料 regular_exp：正则表达式 1.4.2 pos_sentences array[object] False 正向的语料，关键字和正则表达式 1.4.2.1 id string False 语料的唯一标识 1.4.2.2 name string False 语料内容 1.4.3 neg_sentences array[object] False 反向语料，与pos_sentences在同一个标签对象中不能同时存在 1.4.3.1 id string False 语料的唯一标识 1.4.3.2 name string False 语料内容

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

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string True 响应状态码 1.2 resultDesc string True 响应状态消息 1.3 call_uuid 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后有空格） 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 language string True 录音文件语言（zh_CN 代表中文，en_US 代表英文） 1.2 voiceFilePath string True 录音文件路径 1.3 agentId number True 座席人员工号 1.4 beginTime string True 通话开始时间，时间格式：yyyy-MM-dd HH:mm:ss 1.5 endTime string True 通话结束时间，时间格式：yyyy-MM-dd HH:mm:ss

报文样例 场景描述：创建质检任务 请求头: x-app-key:XXXXXXXXXXX Authorization:Bearer XXXXXXXXXXX 请求参数: { "language": "zh_CN", "voiceFilePath": "Y:\\27\\0\\20210201\\1118\\0951044.V3", "agentId": 1118, "beginTime": "2021-02-01 09:51:07", "endTime": "2021-02-01 09:57:57" } 响应参数: { "resultCode": "1010200", "call_uuid": "822bbf4d-c4f8-473a-9144-199058375be8", "resultDesc": "success" }

请求说明 表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 interposal_id string True 规则标识

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

报文样例 场景描述：根据ID查询抢插话规则。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "interposal_id": "922993405183660032" } 响应参数: { "resultCode": "0405000", "resultDesc": "操作成功", "setting": { "score": "-4", "seconds": "4", "times": "4", "other": { "call_end": 1623999504, "call_from": 1623913102 }, "interposal_id": "922993405183660032", "name": "test0613" } }

请求说明 表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 sentences array[string] False 话术使用的句子 1.2 role string True 话术对应的角色，取值如下： any：不限制 staff：坐席 customer：用户 1.3 position string True 通话的位置，取值如下： any：不限制位置 top：通话开头 bottom：通话结尾 set：设定距离 1.4 SGType string True 句子的逻辑关系运算符，取值如下： must：必须说出 if：如果说出 must_say：一定要说 must_not_say：一定不能说 then：再说出 and：还要说出 1.5 position_distance number False 句子的偏移量，取值范围：1~9999 1.6 sg_id string True 话术标识 1.7 sg_name string(128) False 话术名称 1.8 dialogue_flow_id string True 对话逻辑id

报文样例 场景描述：更新话术 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "sentences": ["14171"], "role": "any", "position": "any", "SGType": "must", "sg_id": "923004925930115072", "sg_name": "话术名称98", "dialogue_flow_id": "923004925523267584", "position_distance": 0 } 响应参数: { "resultCode": "0405000", "resultDesc": "操作成功" }

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码 0405000 表示成功 其他表示失败 1.2 resultDesc 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 业务失败：请依次确认您请求中各参数的取值。

请求说明 表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 ******************************** 请求参数: { "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 name string True 修改后的敏感词分类名称 1.2 category_id string True 需要修改的敏感词分类的唯一标识

报文样例 场景描述：更新敏感词分类的接口。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "name": "违禁语1", "category_id": "894378241379274752" } 响应参数: { "resultCode": "0401000", "id": "1071490109427159040", "resultDesc": "操作成功" }

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

报文样例 场景描述：修改质检结果。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "isGroup": false, "ruleType": 60, "taskId": "951849982538539011", "uuid": "6e587bea-d752-4cd7-8ce4-96b6e4c9258a", "ruleInfo": { "description": "5454", "revise": 1, "reviseId": "sentitiveWordRule735bd2f5-0037-4b22-8eb5-49e354e3bac9" } } 响应参数: { "resultCode": 0409000, "resultDesc": "success" }

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码 0409000 表示成功 其他表示失败 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 isGroup boolean True 是否在通话组 1.2 ruleType number True 规则类型 1.3 taskId string True 任务id 1.4 uuid string True 通话uuid 1.5 ruleInfo object True 规则信息 1.5.1 description string True 抽检备注 1.5.2 revise number True 抽检结果，1合规，0违规 1.5.3 reviseId number True 规则id

InterposalRule 表1 InterposalRule参数结构 序号 名称 参数类型 是否必选 说明 1.1 name string True 规则名称 1.2 score number True 规则扣分 1.3 seconds number True 重叠秒数限制 1.4 times number True 重叠次数限制 1.5 interposal_id string True 规则标识 1.6 other object False 质检条件 1.6.1 call_end number False 单通通话发话结束时间 1.6.2 call_from number False 单通通话发话开始时间 父主题： 公共参数结构

报文样例 场景描述：移动句子到指定分类 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "sentenceIds": "14161,14171", "category_id": "894378237264662528" } 响应参数: { "resultCode": "0403000", "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 sentenceIds string True 句子的唯一标识 1.2 category_id string True 分类的唯一标识

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

报文样例 场景描述：新增静默规则 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "setting": { "name": "test34", "score": 4, "seconds": 5, "times": 4, "other": { "call_from": 1623911884, "call_end": 1624430285 } }, "exception": { "before": { "staff": ["14161"], "customer": [] }, "after": {} } } 响应参数: { "silence_id": "922987647176019968", "resultCode": "0405000", "resultDesc": "操作成功" }

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 silence_id string False 静默规则标识 1.2 resultCode string False 返回码，0405000表示成功，其他表示失败 1.3 resultDesc string False 返回描述 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 409 规则名称重复 响应状态码: 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 setting object False 静默规则基本信息 1.1.1 name string True 规则名称 1.1.2 score number True 规则分数： 取值范围：1-100 1.1.3 seconds number True 连续静默秒数 取值范围：1-2147483647 1.1.4 times number True 静默次数 取值范围：1-2147483647 1.1.5 other object False 触发条件 1.1.5.1 call_from number False 单通通话开始时间：时间戳，单位秒 1.1.5.2 call_end number False 单通通话结束时间：时间戳，单位秒 1.2 exception object False 例外设定 1.2.1 before object False 静默之前的例外设定 1.2.1.1 staff array[string] False 座席说的句子标识集合 1.2.1.2 customer array[string] False 客户说的句子标识集合 1.2.2 after object False 静默之后的例外设定 1.2.2.1 staff array[string] False 座席说的句子标识集合