更新时间:2024-05-16 GMT+08:00
分享

新增话术

场景描述

新增话术接口。

接口方法

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": "操作成功"
    }
分享:

    相关文档

    相关产品