云服务器内容精选

  • 样例报文 请求头: 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 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数组。
  • 场景描述 查询指定座席的私有呼叫。进入私有技能队列请参考以下方法: 同时满足以下两个条件,系统会将呼叫转移到某座席的私有技能队列。当座席空闲时,会首先应答其私有队列中正在排队的呼叫。 呼叫被指定转到该座席。 通常在下列情况下呼叫会被指定到一个座席: 当呼叫遇到特殊情况(排队超时、遇忙、无人上班、队列溢出、取消排队等)时,呼叫被指定转接到另一个座席。 由于某个原因,呼叫被一个座席转移到另一个座席。 当前该座席处于通话状态或者工作状态,无法应对呼叫。
  • 请求说明 表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及其之前版本接口响应参数使用。 2 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" ] }
  • 样例报文 请求头: 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 签入队列休息人数已满。
  • 响应说明 表3 响应消息参数说明 参数名称 参数类型 说明 returnCode String 请求返回的结果码。 0:表示成功 其他:失败 description String 请求结果描述 data array 请求响应数据。 表4 响应消息data参数说明 参数名称 参数类型 说明 agentId number 座席工号 locationId number 所属分布式接入节点 CTI保留字段,无实际意义 currentState number 座席状态。 参数说明请参考CTI平台座席状态码参考 currentStateTime number 该状态持续时间,单位秒(s)
  • 报文样例 该接口的请求参数消息体举例如下: { "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"}