座席维度实时接口-华为云

云客服-批量查询座席签入的技能队列:样例报文

样例报文请求头： Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数： { "ccId":1, "vdn":170, "agentIds":[1031,1099] } 响应参数： { "result": "0", "resultCode": "0100000", "resultDatas": [ { "skills": [ { "skillId": 2, "isLogin": 0 } ], "agentId": 1031 }, { "skills": [ { "skillId": 2, "isLogin": 0 }, { "skillId": 4, "isLogin": 0 } ], "agentId": 1099 } ], "resultDesc": [ { "skills": [ { "skillId": 2, "isLogin": 0 } ], "agentId": 1031 }, { "skills": [ { "skillId": 2, "isLogin": 0 }, { "skillId": 4, "isLogin": 0 } ], "agentId": 1099 } ] }

云客服座席维度实时接口

云客服-批量查询座席签入的技能队列:响应消息

响应消息表3 消息体参数说明序号名称参数类型说明 1 result String 查询结果。取值如下： 0：成功其他：失败失败的原因说明请参见错误码参考。说明：当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultCode string 查询结果。取值如下： "0100000"：成功其他：失败失败的原因说明请参见错误码参考。 3 resultDatas array 查询成功后，返回结果信息的对象数组。该数组中对象的参数说明请参见表4。说明：当前字段为兼容8.13及其之前版本接口响应参数使用。 3 resultDesc array 查询成功后，返回结果信息的对象数组。该数组中对象的参数说明请参见表4。表4 resultDesc/resultDatas对象参数说明序号名称参数类型说明 2.1 agentId int 座席工号。 2.2 skills array 座席的技能队列数组。该对象的参数说明请参见表5 表5 skills对象参数说明序号名称参数类型说明 2.2.1 skillId int 技能队列编号。 2.2.2 isLogin int 是否签入。 1：表示签入， 0：表示未签入

云客服座席维度实时接口

云客服-批量查询座席签入的技能队列:请求URL

请求URL https://ip:port/rest/cmsapp/v1/openapi/agentgroup/siteagentcallandskillinfobyagentids 其中，公有云环境请联系管理员获取，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 座席工号的数组，数组最大长度为6000。取值范围：101-59999

云客服座席维度实时接口

云客服-查询指定座席的私有呼叫:样例报文

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

云客服座席维度实时接口

云客服-查询指定座席的私有呼叫:场景描述

场景描述查询指定座席的私有呼叫。进入私有技能队列请参考以下方法：同时满足以下两个条件，系统会将呼叫转移到某座席的私有技能队列。当座席空闲时，会首先应答其私有队列中正在排队的呼叫。呼叫被指定转到该座席。通常在下列情况下呼叫会被指定到一个座席：当呼叫遇到特殊情况（排队超时、遇忙、无人上班、队列溢出、取消排队等）时，呼叫被指定转接到另一个座席。由于某个原因，呼叫被一个座席转移到另一个座席。当前该座席处于通话状态或者工作状态，无法应对呼叫。

云客服座席维度实时接口

云客服-查询指定座席的私有呼叫:请求说明

请求说明表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数组。

云客服座席维度实时接口

云客服-查询指定座席的当前呼叫ID:响应消息

响应消息表3 消息体参数说明序号名称参数类型说明 1 result String 查询结果。取值如下： 0：成功其他：失败失败的原因说明请参见错误码参考。说明：当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultCode string 查询结果。取值如下： "0100000"：成功其他：失败失败的原因说明请参见错误码参考。 3 resultDatas array 查询成功后，返回座席正在处理的呼叫callId数组。说明：当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultDesc array 查询成功后，返回座席正在处理的呼叫callId数组。

云客服座席维度实时接口

云客服-查询指定座席的当前呼叫ID:样例报文

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

云客服座席维度实时接口

云客服-查询指定座席的当前呼叫ID:请求说明

请求说明表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

云客服座席维度实时接口

云客服-查询座席休息信息:样例报文

样例报文请求头： Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数： { "queryParam": { "ccId":1, "vdn":1, "offset":0, "limit":100 } } 响应参数： { "result": "0", "resultCode": "0100000", "resultDatas": { "allowRestNum": 101, "onRestNum": 1, "waitRestNum": 0, "agentsRestDetails": [ { "agentName": "z1", "workNo": 55001, "cantRestReason": 1, "beginTime": 2345, "restDuration": 22333 } ] }, "resultDesc": { "allowRestNum": 101, "onRestNum": 1, "waitRestNum": 0, "agentsRestDetails": [ { "agentName": "z1", "workNo": 55001, "cantRestReason": 1, "beginTime": 2345, "restDuration": 22333 } ] } }

云客服座席维度实时接口

云客服-查询座席休息信息:响应消息

响应消息表3 消息体参数说明序号名称参数类型说明 1 result String 查询结果。取值如下： 0：成功其他：失败失败的原因说明请参见错误码参考。说明：当前字段为兼容8.13及其之前版本接口响应参数使用。 2 resultCode string 查询结果。取值如下： "0100000"：成功其他：失败失败的原因说明请参见错误码参考。 3 resultDatas Object 查询成功后，返回结果信息的对象。该数组中对象的参数说明请参见表4。说明：当前字段为兼容8.13及其之前版本接口响应参数使用。 4 resultDesc Object 查询成功后，返回结果信息的对象。该对象的参数说明请参见表4。表4 resultDesc/resultDatas对象参数说明序号名称参数类型说明 2.1 allowRestNum int 已经允许休息人数，但是座席仍然未休息的座席人数 2.2 onRestNum int 正在休息的座席数 2.3 waitRestNum Int 申请休息的座席数 2.4 agentsRestDetails array VDN上休息座席的详情对象列表。该对象的参数说明请参见表5。表5 agentsrestdetails对象参数说明序号名称参数类型说明 2.4.1 agentName string 座席名称。 2.4.2 workNo int 座席工号。 2.4.3 cantRestReason int 座席不允许休息的原因，此参数仅对于等待休息的座席有效。该对象的参数说明请参见表6。 2.4.4 beginTime long 开始时间(正在休息指休息开始时间，还未休息指申请或批准休息开始时间) 时间格式：时间戳 2.4.5 restDuration long 请求休息时长，单位：秒。表6 不允许休息原因序号不允许休息原因值如何理解 2.4.3.1 0 等待批准 2.4.3.2 1 座席示忙 2.4.3.3 2 VDN 休息人数已满。 2.4.3.4 3 座席不接来话，未签入任何技能队列。 2.4.3.5 4 签入队列休息人数已满。

云客服座席维度实时接口

云客服-根据座席状态分页查询座席信息:报文样例

报文样例该接口的请求参数消息体举例如下： { "ccId": "1", "vdn": "66", "status": "0", "limit": 10, "offset": 0} 该接口的响应参数消息体举例如下： { "returnCode": "0", "data": [ { "agentId": 108, "locationId": 65535, "currentStateTime": 426849, "currentState": 0 }, { "agentId": 109, "locationId": 65535, "currentStateTime": 426849, "currentState": 0 } ], "description": "success"}

云客服座席维度实时接口

云客服-根据座席状态分页查询座席信息:响应说明

响应说明表3 响应消息参数说明参数名称参数类型说明 returnCode String 请求返回的结果码。 0：表示成功其他：失败 description String 请求结果描述 data array 请求响应数据。表4 响应消息data参数说明参数名称参数类型说明 agentId number 座席工号 locationId number 所属分布式接入节点 CTI保留字段，无实际意义 currentState number 座席状态。参数说明请参考CTI平台座席状态码参考 currentStateTime number 该状态持续时间，单位秒(s)

云客服座席维度实时接口

云服务器内容精选

座席维度实时接口

7*24

备案

专业服务

退订

建议反馈

售前咨询热线