# 新增话术
#### 场景描述
新增话术接口。
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/CCSQM/rest/ccisqm/v1/conversation-rules/addSentenceGroup，例如域名是service.besclouds.com
#### 请求说明
表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 | sg_name           | string          | False | 话术名称                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 1.6 | dialogue_flow_id  | string          | True  | 对话逻辑标识                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 1.7 | position_distance | number          | False | 句子的偏移量，取值范围：1\~9999                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   
#### 响应说明
- **响应状态码: 200**
表3响应体参数 
| 序号  | 名称         | 参数类型   | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|:---|
| 1.1 | sg_id      | string | False | 话术标识                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 1.2 | resultCode | string | False | 返回码 - 0405000 表示成功  - 其他表示失败   |
| 1.3 | resultDesc | string | False | 返回描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   
- **响应状态码: 400**
  错误的请求：请检查请求路径及参数。
  
- **响应状态码: 401**
  未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
  
- **响应状态码: 404**
  请求的内容未找到：请检查请求的路径。
  
- **响应状态码: 500**
  业务失败：请依次确认您请求中各参数的取值。
  
 
#### 错误码
无。
#### 报文样例
- 场景描述：新增话术 请求头:
  ```
  x-app-key:************************************  
  X-UserID:1611917095665261978  
  Authorization:Bearer ********************************
  ```
  请求参数:
  ```
  {
  "sentences": ["10877","10795","10795","10849","10870","10877","10877","10721","10877"],
  "role": "customer",
  "position": "set",
  "SGType": "must_say",
  "sg_name": "话术名称65",
  "dialogue_flow_id": "1068973778081419264",
  "position_distance": 2271
  }
  ```
  响应参数:
  ```
  {
      "sg_id": "1071513309271822336",
      "resultCode": "0405000",
      "resultDesc": "操作成功"
  }
  ```