华为云用户手册

报文样例 场景描述：根据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"}}

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

报文样例 场景描述：更新对话规则。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"severity": "normal"，"rule_id": "923084039932350464"，"score": 1，"other": {}，"min": 1，"method": "positive"，"rule_name": "tesat3"，"flows": []，"resultCode": "0405000"，"description": "4"，"completeness": {"hasConversationFlow": false，"sentenceComplete": false，"ruleComplete": false，"hasDescription": true}，"resultDesc": "操作成功"，"score_type": "valid"} 响应参数: {"resultCode": "0405000"，"resultDesc": "操作成功"}

报文样例 场景描述：根据ID删除抢插话规则。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"interposal_id": "922993405183660032"} 响应参数: {"resultCode": "0405000"，"resultDesc": "操作成功"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 severity string True 规则级别一般规则和重要规则："normal" "critical" 1.2 rule_id string True 规则标识 1.3 score number True 规则分数 1.4 other object True 附加条件 1.4.1 call_end number False 呼叫开始时间 1.4.2 call_from number False 呼叫结束时间 1.5 min number True 对话逻辑至少要出现几个 1.6 method string True "positive" "negative" 规则是正面表列 or 负面表列 1.7 rule_name string False 规则名称 1.8 resultCode string False 返回码，0405000表示成功，其他表示失败 1.9 description string False 规则描述 1.10 resultDesc string False 返回的描述信息 1.11 score_type string True 规则分数类型

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 interposal_id string True 规则标识

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

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

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 limit number True 分页信息，每页记录数 1.2 page number False 分页信息，当前页数 1.3 keyword string(64) False 搜索关键字

报文样例 场景描述：查询所有的抢插话规则接口 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"limit": 10，"page": 1} 响应参数: {"data": [{"score": "-1"，"seconds": "2"，"times": "3"，"interposal_id": "894378242138443776"，"name": "抢插话规则名称1"}， {"score": "-4"，"seconds": "4"，"times": "4"，"interposal_id": "922992717770788864"，"name": "test0611"}， {"score": "-4"，"seconds": "4"，"times": "4"，"interposal_id": "922992795956809728"，"name": "test0612"}， {"score": "-4"，"seconds": "4"，"times": "4"，"interposal_id": "922993405183660032"，"name": "test0613"}]，"resultCode": "0405000"，"paging": {"total": 4}，"resultDesc": "操作成功"}

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

报文样例 场景描述：创建抢插话规则 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"other":{"call_from":1623913102，"call_end":1623999504}，"name":"test0611"，"score":4，"seconds":4，"times":4} 响应参数: {"interposal_id":"922992717770788864"，"resultCode":"0405000"，"resultDesc":"操作成功"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 name string(64) True 规则名称 1.2 score number True 规则分数 1.3 seconds number True 重叠秒数限制 1.4 times number True 重叠次数限制 1.5 other object True 质检条件 1.5.1 call_end number False 单通通话结束时间 1.5.2 call_from number False 单通通话开始时间

响应说明 响应状态码: 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 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：根据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"}}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 silence_id string True 静默规则标识

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 score number True 规则分数 1.2 seconds number True 重叠秒数限制 1.3 times number True 重叠次数限制 1.4 other object True 质检条件 1.4.1 call_end number False 单通通话结束时间 1.4.2 call_from number False 单通通话开始时间 1.5 interposal_id string True 抢插话规则ID 1.6 name string True 规则名称

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

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

报文样例 场景描述：新增静默规则 请求头: 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 True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 setting object False 静默规则基本信息 1.1.1 name string False 规则名称 1.1.2 score number False 规则分数 1.1.3 seconds number False 连续静默秒数 1.1.4 times number False 静默次数 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 座席说的句子标识集合

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 单通通话发话开始时间 父主题： 公共参数结构

报文样例 场景描述：根据ID删除静默规则 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"silence_id": "922988537635147776"} 响应参数: {"resultCode": "0405000"，"resultDesc": "操作成功"}

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

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 silence_id string True 静默规则标识

报文样例 场景描述：查询静默规则列表 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: {"page": 1，"limit": 10} 响应参数: {"data": [{"score": "-5"，"seconds": "3"，"times": "1"，"silence_id": "894378242029391872"，"name": "静默规则名称1"}， {"score": "-3"，"seconds": "4"，"times": "4"，"silence_id": "922671254081638400"，"name": "test3"}， {"score": "-5"，"seconds": "5"，"times": "5"，"silence_id": "922671488287379456"，"name": "tes4"}， {"score": "-4"，"seconds": "5"，"times": "4"，"silence_id": "922987647176019968"，"name": "test34"}， {"score": "-4"，"seconds": "5"，"times": "4"，"silence_id": "922988537635147776"，"name": "test35444"}]，"resultCode": "0405000"，"paging": {"total": 5}，"resultDesc": "操作成功"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 固定填 application/json; charset=UTF-8。 2 x-app-key string True appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 page number False 当前页数 1.2 limit number True 每页展示的数量 1.3 keyword string(64) False 搜索的关键词

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 data array[object] False 返回信息 1.1.1 score string False 规则分数 1.1.2 seconds string False 连续静默秒数 1.1.3 times string False 静默次数 1.1.4 silence_id string False 静默规则标识 1.1.5 name string False 规则名称 1.2 resultCode string False 返回码，0405000表示成功，其他表示失败 1.3 paging object False 分页信息 1.3.1 total number False 总数 1.4 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

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