文档首页/ 云客服/ API参考/ 质检/监控/统计类/ 智能质检/ 人工抽检任务接口 (regularQualityTask)/ POST /CCSQM/rest/ccisqm/v1/regularqualitytask/addQualityTask
更新时间:2023-09-27 GMT+08:00

POST /CCSQM/rest/ccisqm/v1/regularqualitytask/addQualityTask

场景描述

新增定时抽检计划

接口方法

POST

接口URI

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

appointQuality

object

True

指派质检员

1.1.1

setCounts

array[object]

True

设置质检员

1.1.1.1

count

number

False

数量,最大长度8位

  • setCountsType!=2时,count必填。
  • setCountsType==2时,setCounts中所有count总和为100。

1.1.1.2

personID

string

True

质检员ID,最大长度64位

1.1.2

setCountsType

integer

True

设置数量的类别:0-平均分配,2-百分比

1.2

cronStructure

object

True

设置周期

1.2.1

qiqtCycleType

string

True

重复方式: 1,每天,2.每周,3.每月

1.2.2

qiqtEndTime

integer

False

结束时间:当qiqtEndType 为2 时有效,秒级,最大长度10位

1.2.3

qiqtEndType

string

True

结束条件: 1.次数 2.时间

1.2.4

qiqtStartTime

integer

True

开始时间,秒级,最大长度10位

1.2.5

qiqtTotalTimes

integer

False

定时任务执行次数,最大长度8位。

qiqtEndType==1时,qiqtTotalTimes必填。

1.3

currentRole

string

False

用户角色

1.4

extractionRange

object

True

设定抽检范围

1.4.1

currentRole

string

False

用户角色

1.4.2

fixedColumns

object

True

抽检范围条件设定

1.4.2.1

qualityType

integer

True

抽检类型:1.通话范围 2.座席抽检数量类型 3.座席抽检百分比类型

1.4.2.2

durationStart

integer

False

通话最短时间,毫秒级,最大长度11位

1.4.2.3

qualityNum

string

True

抽检数量,最大长度8位

1.4.2.4

qualityCondition

integer

True

抽检状态:0.不限制 1.未抽检 2.已抽检

1.4.2.5

durationEnd

string

False

通话最长时间,毫秒级,最大长度11位

1.4.2.6

maxNum

string

False

最大抽检量,最大长度8位。

qualityType!=2时,maxNum参数必填且参数值大于等于1。

1.4.2.7

scoreEnd

string

False

最高分数,最大分数10000

1.4.2.8

scoreStart

string

False

最低分数,最大分数10000

1.4.2.9

staffIds

array[string]

False

座席人员

1.4.2.10

interactionType

integer

True

交互类型。取值范围:

  • 0:录音
  • 1:文本

1.4.3

userId

string

False

用户ID

1.5

qiqtName

string

True

计划名称,最大长度64位

1.6

userId

string

False

用户ID

响应说明

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

序号

名称

参数类型

是否必选

说明

1.1

objId

string

False

抽检计划唯一标识

1.2

resultCode

string

False

返回码

  • 0408000 表示成功
  • 其他表示失败

1.3

resultDesc

string

False

返回描述

  • 响应状态码: 400

    错误的请求:请检查请求路径及参数。

  • 响应状态码: 401

    未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。

  • 响应状态码: 404

    请求的内容未找到:请检查请求的路径。

  • 响应状态码: 500

    业务失败:请依次确认您请求中各参数的取值。

错误码

无。

报文样例

  • 场景描述:新增定时抽检计划

    请求头:

    Content-Type:application/json  
    x-app-key:xxxx-xxxx-xxx-xxxx  
    x-UserId:xxxxxxxxx  
    Authorization:Bearer ********************************

    请求参数:

    {
    "extractionRange": {
    		"customColumns": null,
    		"fixedColumns": {
    			"durationEnd": "100",
    			"durationStart": 1,
    			"interactionType": 0,
    			"maxNum": "10",
    			"qualityCondition": 2,
    			"qualityNum": "100",
    			"qualityType": 1,
    			"staffIds": [],
    			"scoreStart": "0",
    			"scoreEnd": "100"
    		},
    		"currentRole": "qualityDirector"
    	},
    	"appointQuality": {
    		"setCounts": [{
    			"personID": "1679888547924121791",
    			"count": 0
    		}],
    		"setCountsType": 0
    	},
    	"cronStructure": {
    		"qiqtCycleType": "1",
    		"qiqtStartTime": 1692171720,
    		"qiqtEndType": "2",
    		"qiqtTotalTimes": 1,
    		"qiqtEndTime": 1692258120
    	},
    	"qiqtName": "test082101",
    	"currentRole": "qualityDirector"
    }

    响应头:

    Content-Type: application/json;charset=UTF-8

    响应参数:

    {
    	"objId": "954637368599307266",
    	"resultCode": 0,
    	"resultDesc": "success"
    }