更新时间:2023-09-27 GMT+08:00

POST /CCSQM/rest/ccisqm/v1/conversation-rules/addRule

场景描述

创建对话规则。

接口方法

POST

接口URI

https://域名/apiaccess/CCSQM/rest/ccisqm/v1/conversation-rules/addRule,例如域名是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

True

操作员标识

可在登陆后,进入员工管理页面,查看接口返回的userId

表2 请求体参数

序号

名称

参数类型

是否必选

说明

1.1

rule_name

string

True

规则名称

1.2

description

string(1,024)

False

规则描述

1.3

severity

string

True

规则级别一般规则和重要规则:"normal" "critical"

1.4

score_type

string

True

分数类型:

  • valid
  • invalid

1.5

score

number

True

规则分数

1.6

method

string

True

取值范围:

  • positive
  • negative

1.7

min

number

True

对话逻辑至少要出现几个

1.8

other

object

True

其他内容

1.8.1

call_from

number

False

呼叫开始时间:填写时间戳,单位秒

1.8.2

call_end

number

False

呼叫结束时间:填写时间戳,单位秒

响应说明

  • 响应状态码: 200
表3 响应体参数

序号

名称

参数类型

是否必选

说明

1.1

rule_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 ********************************

    请求参数:

    {
    	"severity": "normal",
    	"score_type": "valid",
    	"method": "positive",
    	"score": 1,
    	"min": 1,
    	"other": {},
    	"rule_name": "aseew",
    	"description": "3"
    }

    响应参数:

    {
    	"rule_id": "923084345118298112",
    	"resultCode": "0405000",
    	"resultDesc": "操作成功"
    }