更新时间:2023-12-19 GMT+08:00

查询指定座席的私有呼叫

场景描述

查询指定座席的私有呼叫。进入私有技能队列请参考以下方法:

同时满足以下两个条件,系统会将呼叫转移到某座席的私有技能队列。当座席空闲时,会首先应答其私有队列中正在排队的呼叫。

  • 呼叫被指定转到该座席。

    通常在下列情况下呼叫会被指定到一个座席:

    • 当呼叫遇到特殊情况(排队超时、遇忙、无人上班、队列溢出、取消排队等)时,呼叫被指定转接到另一个座席。
    • 由于某个原因,呼叫被一个座席转移到另一个座席。
  • 当前该座席处于通话状态或者工作状态,无法应对呼叫。

接口方法

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

内部封装接口

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

请求URL

https://ip:port/rest/cmsapp/v1/openapi/agent/agentprivatecall

其中,公有云环境请联系管理员获取,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

agentId

int

True

座席工号。

取值范围:101-59999

响应消息

表3 消息体参数说明

序号

名称

参数类型

说明

1

result

String

查询结果。取值如下:

  • 0:成功
  • 其他:失败

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

说明:

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

2

resultCode

string

查询结果。取值如下:

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

3

resultDatas

array

查询成功后,返回座席私有呼叫callId数组。

说明:

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

4

resultDesc

array

查询成功后,返回座席私有呼叫callId数组。

样例报文

  • 请求头:
    Content-Type: application/json;charset=UTF-8
    Authorization: ******************
  • 请求参数:
    {
        "ccId":1,
        "vdn":170,
        "agentId":1099
    }
  • 响应参数:
    {
        "result": "0",
        "resultCode": "0100000",
        "resultDatas": [
            "1605492949-1447"
        ],
        "resultDesc": [
            "1605492949-1447"
        ]
    }