文档首页/ 云客服/ API参考/ 呼叫中心配置类/ 座席管理/ 单个创建座席业务账号(agentAccount/create)
更新时间:2023-09-27 GMT+08:00

单个创建座席业务账号(agentAccount/create)

场景描述

单个创建座席业务账号,其中skills参数与技能队列相关,请通过查询技能队列的接口获取技能队列相关信息。

接口方法

POST

接口URI

https://域名/apiaccess/rest/cc-management/v1/agentAccount/create,例如域名是service.besclouds.com

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

x-app-key

string

False

appKey字段,用户标识,请联系运营人员获取appKey

2

Authorization

string

True

鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格)

表2 请求体参数

序号

名称

参数类型

是否必选

说明

1

requestParam

object

True

请求参数对象

1.1

userAccount

string

True

座席业务账号,长度6-50位,支持四种:大写字母、小写字母、数字和特殊字符。

特殊字符是指@.-_

1.2

userName

string

True

座席业务账号用户名,最大长度为20字符,不含"[]'&()=;<>,特殊字符。

1.3

password

string

True

座席业务账号密码,长度8位(默认密码规则组),默认需要提供四种:大写字母、小写字母、数字和特殊字符。

特殊字符是指~`!@#$%^*()-+_=\¦,./<>?;':"[]{}\&,密码有效时长90天,请在90天内更新密码。

1.4

email

string

True

邮箱地址,(符合RFC 2882)

localPart最大长度不超过64,domainPart长度不超过255,其中domainPart dot前面部分最长为63位

1.5

agentType

integer

True

座席类型:

4:音频座席;

11:视频座席

5:多媒体座席;

99:全能座席

1.6

ccRoleId

integer

True

座席角色id:

2:话务员;

3:质检员;

4:外呼座席

1.7

skills

array[object]

False

技能参数组,设置的技能队列类型需要与agenttype保持一致

1.7.1

skillId

integer

False

技能队列Id,通过查询技能队列接口 querySkills获取

1.7.2

agentWeight

integer

False

座席权重,权重越高,越优先分配该座席,最低1

1.7.3

skillWeight

integer

False

技能队列权重,最低1

1.8

phone

string

False

电话号码,选填,长度不超过25位

响应说明

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

    序号

    名称

    参数类型

    是否必选

    说明

    1

    schema

    object

    True

    请求成功

    1.1

    resultCode

    string

    True

    字符串,0成功,1失败

    1.2

    resultMessage

    string

    True

    相关消息

    1.3

    workNo

    integer

    False

    座席工号。

  • 响应状态码: 400

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

  • 响应状态码: 401

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

  • 响应状态码: 404

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

  • 响应状态码: 500

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

错误码

无。

报文样例

  • 场景描述:创建座席业务账号
    URL:见文档
    x-app-key: XXXXXXXXXXXXXXXXXXXXXXX 
    Content-Type: application/json 
    Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXX

    请求参数:

    {
        "userAccount":"test123456",
        "userName":"test111",
        "password":"Te****34",
        "email":"t**@****.com",
    
        "agentType":11,
        "ccRoleId":2,
        "skills":[{
    	"skillId":3,
    	"agentWeight":1,
          "skillWeight":1
    		},
    						 {
    	"skillId":2,
    	"agentWeight":1,
          "skillWeight":2
    		}]
    }

    响应参数:

    {
      "resultCode": "0",
      "resultMessage": "create agent account success",
      "workNo": 108
    }