文档首页/ 云客服/ API参考/ 呼叫中心配置类/ 座席管理/ 通过技能队列ID查询座席信息(queryAgentInfoBySkillId)
更新时间:2023-09-27 GMT+08:00

通过技能队列ID查询座席信息(queryAgentInfoBySkillId)

场景描述

根据技能队列ID查询该队列下的座席信息。

接口方法

POST

接口URI

https://域名/apiaccess/rest/cc-management/v1/agentAccount/queryAgentInfoBySkillId,例如域名是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

skillId

integer

True

技能队列ID

1.2

pageSize

integer

True

分页大小,最大值为100

1.3

pageNum

integer

True

分页页号,从0开始

响应说明

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

    序号

    名称

    参数类型

    是否必选

    说明

    1

    schema

    object

    True

    请求成功

    1.1

    data

    array[object]

    False

    返回数据

    1.1.1

    workNo

    number

    False

    座席工号

    1.1.2

    agentType

    number

    False

    座席类型:

    4:音频座席;

    11:视频座席

    5:多媒体座席;

    99:全能座席

    1.1.3

    agentWeight

    number

    False

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

    1.1.4

    accountName

    string

    False

    用户名称

    1.1.5

    sipAccount

    string

    False

    软电话号码

    1.1.6

    skillWeight

    number

    False

    技能队列权重,最低1

    1.1.7

    userAccount

    string

    False

    座席账号,同创建座席的座席账号

    1.2

    count

    integer

    False

    查询座席信息的数量

    1.3

    resultCode

    string

    False

    请求成功返回0 ,请求失败返回1,会携带resultMessage,具体错误原因

  • 响应状态码: 400

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

  • 响应状态码: 401

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

  • 响应状态码: 404

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

  • 响应状态码: 500

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

错误码

无。

报文样例

场景描述:根据技能队列ID查询座席信息

请求参数:

{
  "skillId":3,
   "pageSize":10,
  "pageNum":0
 }

响应参数:

{"data": [
     {
       "workNo": 107,
       "accountCode": "xxxxx",
       "agentType": 4,
       "agentWeight": 1,
       "accountName": "xxxxx",
       "sipAccount": "88880006",
       "skillWeight": 1
     }
   ],
   "count": 1,
   "resultCode": "0"
 }