更新时间:2024-08-02 GMT+08:00

批量查询所有座席的呼叫信息

场景描述

批量查询所有座席的实时呼叫信息。

接口方法

设置成“POST”。该接口仅支持POST方法,不支持PUT、GET和DELTE等方法。

内部封装接口

BMS接口:/ccbms/ws/monitor/queryagentCalls

请求URL

https://ip:port/rest/cmsapp/v1/openapi/agentgroup/queryagentcalls

其中,公有云环境请联系管理员获取,ip为CC-CMS服务器地址,port为CC-CMS服务器的HTTPS端口号。

非公有云环境如果配置了NSLB服务,ip请填写NSLB的服务器地址,port为CC-CMS服务在NSLB映射的HTTPS端口号。

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

String

True

固定填 application/json; charset=UTF-8。

2

Authorization

String

True

生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式

表2 消息体参数说明

序号

名称

参数类型

是否必选

说明

1

ccId

int

True

呼叫中心编号。

取值范围:1~65535

2

vdn

int

True

虚拟呼叫中心编号。

取值范围:1~5000

3

agentIds

array

True

座席工号的数组,数组最大长度为3000。

取值范围:101-59999

响应消息

表3 消息体参数说明

序号

名称

参数类型

说明

1

result

String

查询结果。取值如下:

  • 0:成功
  • 其他:失败

失败的原因说明请参见错误码参考

说明:

当前字段为兼容8.13及其之前版本接口响应参数使用。

2

resultCode

string

查询结果。取值如下:

  • "0100000":成功
  • 其他:失败
  • 失败的原因说明请参见错误码参考

3

resultDatas

array

查询成功后,返回结果信息的对象数组。

该数组中对象的参数说明请参见表4

说明:

当前字段为兼容8.13及其之前版本接口响应参数使用。

4

resultDesc

array

查询成功后,返回结果信息的对象数组。

该数组中对象的参数说明请参见表4

表4 resultDesc/resultDatas对象参数说明

序号

名称

参数类型

说明

2.1

agentId

int

座席工号。

2.2

callList

array

呼叫信息数组。

该对象的参数说明请参见表5

表5 callList对象参数说明

序号

名称

参数类型

说明

2.2.1

callId

string

呼叫ID。

2.2.2

callStatus

int

呼叫状态,表6

2.2.3

callInOut

int

呼入与呼出的标记。

0:表示呼入,1:表示呼出

2.2.4

mediaType

int

媒体类型,表1

表6 呼叫状态

编号

呼叫类型

描述

0

IDLE

呼叫对象空闲(无呼叫)

1

OCCUPY

呼叫对象被占用

2

QUEUE

呼叫在技能队列排队

3

PRIVATE_QUEUE

呼叫在私有队列排队

4

ALERTING

呼叫振铃等待应答

5

TALK

呼叫各方在通话或交互中

6

HOLD

呼叫保持

7

SUSPEND

呼叫挂起

8

MUTE

呼叫被静音

9

TRITALK

三方通话

样例报文

  • 请求头:
    Content-Type: application/json;charset=UTF-8
    Authorization: ******************
  • 请求参数:
    {
        "ccId":1,
        "vdn":170,
        "agentIds":[1031,1099]
    }
  • 响应参数:
    {
        "result": "0",
        "resultCode": "0100000",
        "resultDatas": [
            {
                "agentId": 1034,
                "callList": []
            },
            {
                "agentId": 1099,
                "callList": [
                    {
                        "callId": "1605494261-1449",
                        "callStatus": 5,
                        "callInOut": 0,
                        "mediaType": 5
                    }
                ]
            }
        ],
        "resultDesc": [
            {
                "agentId": 1034,
                "callList": []
            },
            {
                "agentId": 1099,
                "callList": [
                    {
                        "callId": "1605494261-1449",
                        "callStatus": 5,
                        "callInOut": 0,
                        "mediaType": 5
                    }
                ]
            }
        ]
    }