文档首页/ 云客服/ API参考/ 呼叫中心配置类/ 座席管理/ 绑定座席和技能队列(addSkillsToAgent)
更新时间:2023-09-27 GMT+08:00

绑定座席和技能队列(addSkillsToAgent)

场景描述

根据技能ID和座席账号,给座席和技能队列添加绑定关系。

接口方法

POST

接口URI

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

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

x-app-key

string

False

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

2

Authorization

string

True

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

表2 请求体参数

序号

名称

参数类型

是否必选

说明

1.1

userAccounts

array

True

座席账号数组,字符串型,长度最多不超过50

1.2

skillId

integer

True

技能队列ID

1.3

agentWeight

integer

True

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

1.4

skillWeight

integer

True

技能队列权重,最低1

响应说明

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

    序号

    名称

    参数类型

    是否必选

    说明

    1.1

    resultCode

    string

    False

    修改成功返回0,失败返回1,失败时resultMessage会携带具体原因描述

    1.2

    resultMessage

    string

    False

    请求返回信息

  • 响应状态码: 400

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

  • 响应状态码: 401

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

  • 响应状态码: 404

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

  • 响应状态码: 500

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

错误码

无。

报文样例

请求头:

x-app-key: 68b*************6ec8e4
Content-Type: application/json
Authorization: Bearer xxx

请求参数:

{
    "userAccounts": [
        "x1",
        "x2"
    ],
    "skillId": 4,
    "agentWeight": 1,
    "skillWeight": 1
}

响应参数:

{
  "resultCode": "0",
  "resultMessage": "success"
}