华为云用户手册

  • 报文样例 请求头: { "x-app-key": ******************** "Authorization": Bearer ************************ } 请求参数: { "surveyId":"987654321", "questionId": "123456789", "isAnswered":true } 响应参数: { "score": 70, "oprRule": {}, "questionId": "123456789", "answerNo": 1, "resultCode": "1203000", "optionIdList": [], "resultDesc": "Opration Successful.", "questionType": "voice", "content": "为什么微信渠道不能充值部分金额话费?" }
  • 样例报文 请求头: Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数: { "ccId": "89", "vdn":92, "limit":10, "offset":0 } 响应参数: { "resultCode": "0100000", "resultDesc": { "count": 14, "tasks": [ { "beginDate": "2021-02-03", "taskType": "4", "endDate": "2021-02-04", "taskName": "1", "taskId": "1088825198", "status": "1" }, { "beginDate": "2021-02-04", "taskType": "4", "endDate": "2021-02-28", "taskName": "2", "taskId": "1312452402", "status": "1" } ....... ] } }
  • 响应消息 表3 消息体参数说明 参数名 数据类型 说明 resultCode string 查询结果。取值如下: "0100000":成功 其他:失败 失败的原因说明请参见错误码参考。 resultDesc array 查询成功后,返回结果信息的对象数组。 响应消息体参数请参考表4 表4 响应消息体参数说明 参数名 数据类型 说明 count int 任务总数。 tasks JSONArray 任务列表。 tasks对象参数说明请参考表5 表5 tasks对象参数说明 参数名 数据类型 说明 taskId String 任务Id。 taskName String 任务名称。 taskType String 任务类型。 1:智能外呼 2:预测外呼 3:自动外呼 4:人工外呼 5:预览外呼 beginDate String 开始时间,CC-iSales前台用户写入的时间 endDate String 结束时间,CC-iSales前台用户写入的时间 status String 任务状态。 2:执行中 3:暂停 4:完成
  • 报文样例 该接口的请求消息体举例如下: { "name": "test0827shwocase1", "description": "long0825", "strBeginTime": "2021-08-27 00:00:00", "strEndTime": "2021-08-28 23:59:59", "deviceType": 2, "callerNo": [ { "accessCode": "88889527", "priority": 3 } ], "maxAlertingTime": 20, "priority": 4, "scheduleParam": { "workdayBeginTime1": "00:00", "workdayEndTime1": "23:59", "workdayBeginTime2": "", "workdayEndTime2": "", "workdayBeginTime3": "", "workdayEndTime3": "", "holidayBeginTime1": "", "holidayEndTime1": "", "holidayBeginTime2": "", "holidayEndTime2": "", "holidayBeginTime3": "", "holidayEndTime3": "" }, "skillParam": { "skillId": 2, "skillName": "defaultAudioSkill", "outBoundType": 2, "predictParam": { "predictMethod": 1, "expPredictParam": { "maxAvgCallTime": 100, "minAvgCallTime": 50, "outBoundRate": 50 } } }, "retryPolicy": { "retryPolicyId": "163005925789859991571901887599", "policyType": 1, "policyJson": "[{'dataType':'SI','type':1,'policy':[{'result':2,'retryNumber':4,'callInterval':600}]}]", "busiPolicy": "[{'busiResultCode':'14376596','busiResultSubCode':'14963248','busiResultPolicy':1,'callInterval':300}]" }, "callPolicy": { "callPolicyId": "163005925791583092505770074569", "callType": 1, "chooseType": 0, "turns": [ { "turnType": "SI" } ] }, "initStatus": 0, "callBackUrl": "https://10.10.10.10/xxx/xxx/xxx" } 该接口的响应消息体举例如下: { "resultCode": "0200000", "resultDesc": "", "returnCode": "0200000", "returnDesc": "" }
  • 错误结果码 表22 错误原因码说明 序号 错误码 说明 1 0200001 参数异常,异常详情在resultDesc中描述。 2 0200002 外呼活动的开始时间早于今天凌晨。 3 0200005 外呼活动名称不能重复。 4 0200007 外呼活动已经不存在。 5 0200016 外呼活动已经结束。 6 0200017 技能队列ID不存在。 7 02000001 参数值为空 8 02000002 参数包含非法字符 9 02000003 参数长度不能大于规定长度 10 02000004 参数长度不能小于规定长度 11 02000005 参数长度需要介于规定长度之间 12 02000006 参数值类型不正确 13 02000007 参数值大小不正确 14 02000008 参数转换异常,请检查请求参数 15 02000009 参数组合不正确,请检查请求参数 16 02000010 hour和minute必须同时存在 17 02000011 参数个数不能大于规定个数
  • 接口URI https://ip:port/rest/isales/v2/openapi/campaigns/{vdnId}/{campaignId} 其中,ip为CC-iSales服务器地址,port为CC-iSales服务器的HTTPS端口号。 表1 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数,取值范围为1~9999。 2 campaignId int True 外呼任务的ID。
  • 报文样例 请求头: { "x-app-key": ******************** "Authorization": Bearer ************************ } 请求参数: { "surveyId":"123456789", "questionId":"987654321", "answerNo": 1, "surveyAnswerId": "123456666" } 响应参数: { "resultCode": "1203000", "questionAnswerId": "123456789", "resultDesc": "Opration Successful." }
  • 请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 2 Authorization String True 鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格) 3 x-app-key String True appKey字段,用户标识,请联系运营人员获取appKey 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1 questionId String True 题目ID 2 surveyAnswerId String True 答卷ID 3 surveyId String True 问卷ID 4 answerText String False 答案内容 5 voiceScore DECIMAL (11,2) False 语音得分 6 operScore DECIMAL (11,2) False 操作得分 7 optionId String False 选项ID
  • 响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1 resultCode String True 接口返回码 2 resultDesc String True 接口返回消息描述。 2 questionAnswerId String True 问题答案ID 响应状态码: 400 错误的请求:请检查请求路径及参数 响应状态码: 401 未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 403 鉴权失败 响应状态码: 404 请求的内容未找到:请检查请求的路径 响应状态码: 500 业务失败:请依次确认您请求中各参数的取值。
  • 响应消息 表3 消息体参数说明 参数名 数据类型 说明 result String 查询结果。取值如下: 0:成功 其他:失败 失败的原因说明请参见错误码参考。 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 resultCode string 查询结果。取值如下: "0100000":成功 其他:失败 失败的原因说明请参见错误码参考。 resultDatas List 查询成功后,返回结果信息的对象数组。 该数组中对象的参数说明请参见表4。 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 resultDesc List 查询成功后,返回结果信息的对象列表。 该数组中对象的参数说明请参见表4。 表4 resultDesc/resultDatas对象参数说明 参数名 数据类型 说明 id string 配置ID callId string 呼叫ID phoneNo string 座席电话号码或会议id subCcNo int 子系统号 currentAgentId int 业务代表的工号 currentSkillId int 处理呼叫的技能队列ID mediaType int 媒体类型,请参见表1 beginTime string 统计操作开始的时间,零时区 endTime string 统计操作结束的时间,零时区 vdn int 处理呼叫的虚拟呼叫中心编号 callType int 呼叫类型,请参见表1 serviceNo int 业务类型ID operateType int 操作类型,请参见表1 operateObject int 操作对象,请参见表1 operateCause int 操作原因,请参见表1 agentType int 座席类型,请参见表1 locationId int 分布式节点编号 logonSn string 签入序列号 skillInfoSn string 座席拥有技能列表的索引 当取值为空时,表示座席不拥有任务技能。例如:座席签入时,此字段则为空。
  • 样例报文 请求头: Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数: { "currentAgentId": 12, "operateType": 46, "beginTime": "2020-08-22 05:00:00", "endTime": "2020-08-23 05:00:00", "ccId": 1 } 响应参数: { "result": "0", "resultCode": "0100000", "resultDatas": [ { "id": "45648", "callId": "5", "phoneNo": "05276789", "operateType": 46, "operateObject": 23, "operateCause": 0, "agentType": 3, "beginTime": "2020-08-22T05:49:36.000+0000", "endTime": "2020-08-22T09:49:37.000+0000", "callType": 0, "vdn": 4, "serviceNo": 21, "subCcNo": 10, "currentAgentId": 12, "currentSkillId": 10, "mediaType": 10, "locationId": null, "logonSn": null, "skillInfoSn": null }, { "id": "45649", "callId": "5", "phoneNo": "05276789", "operateType": 46, "operateObject": 23, "operateCause": 0, "agentType": 3, "beginTime": "2020-08-22T05:49:36.000+0000", "endTime": "2020-08-22T09:49:37.000+0000", "callType": 0, "vdn": 4, "serviceNo": 21, "subCcNo": 10, "currentAgentId": 12, "currentSkillId": 10, "mediaType": 10, "locationId": null, "logonSn": null, "skillInfoSn": null } ], "resultDesc": [ { "id": "45648", "callId": "5", "phoneNo": "05276789", "operateType": 46, "operateObject": 23, "operateCause": 0, "agentType": 3, "beginTime": "2020-08-22T05:49:36.000+0000", "endTime": "2020-08-22T09:49:37.000+0000", "callType": 0, "vdn": 4, "serviceNo": 21, "subCcNo": 10, "currentAgentId": 12, "currentSkillId": 10, "mediaType": 10, "locationId": null, "logonSn": null, "skillInfoSn": null }, { "id": "45649", "callId": "5", "phoneNo": "05276789", "operateType": 46, "operateObject": 23, "operateCause": 0, "agentType": 3, "beginTime": "2020-08-22T05:49:36.000+0000", "endTime": "2020-08-22T09:49:37.000+0000", "callType": 0, "vdn": 4, "serviceNo": 21, "subCcNo": 10, "currentAgentId": 12, "currentSkillId": 10, "mediaType": 10, "locationId": null, "logonSn": null, "skillInfoSn": null } ] }
  • 样例报文 请求头: Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数: { "vdn": 222, "ccId":89, "taskId": "1176499974", "beginDayTime": "2021-01-21", "endDayTime": "2021-01-23" } 响应参数: { "resultCode": "0100000", "resultDesc": [ { "statDate": "2021-01-17", "totalCount": 200, "succCount": 101, "succRate": "50.5%" }, { "statDate": "2021-01-18", "totalCount": 320, "succCount": 248, "succRate": "77.5%" } ] }
  • 响应消息 表3 响应体参数说明 参数名 数据类型 说明 resultCode string 查询结果。取值如下: "0100000":成功 其他:失败 失败的原因说明请参见错误码参考。 resultDesc array 查询成功后,返回结果信息的对象数组。 该接口的响应消息体参数说明请参考表4 表4 响应消息体参数说明 参数名 数据类型 说明 statDate String 日结日期。 totalCount int 日外呼量。 succCount int 成功呼叫数(接通量)。 succRate String 成功率(接通率)。
  • 报文样例 消息头 Content-Type:application/json; charset=UTF-8 Guid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 { "callid":"1552524689-16797284", "userType":"agent" } 响应参数 { "message": "success", "retcode": "0", "result": { "userId": "坐席工号", "ctime": "过期时间", "channelId": "15945185-345", "appId": "8345234631", "ip": "xxx.xxx.xxx.xxx", "port": "6500", "role": "0", "signalingDomainIn": "https: //in.isdpdomain.com", "signalingDomainOut": "https: //out.isdpdomain.com", "locationId": "65535", "signature": "xxx", "appId": "sdcp0BPcVGymItWppGX6XqrZGTCYa13d" } }
  • 响应说明 表4 消息体参数说明 序号 名称 参数类型 说明 1 retcode string 消息发送结果。 0:成功 非0:失败 2 message string 描述 3 result object 查询成功后,返回连接信息对象。 该对象的参数说明请参见表5。 表5 result对象参数说明 序号 名称 参数类型 说明 1 userId string 坐席工号 2 ctime string 过期时间 3 channelId string 频道ID(房间ID) 4 role string 角色 5 ip string 媒体服务器接入点IP地址 6 port string 媒体服务器接入点端口 7 signalingDomainIn string 内侧信令domain; 格式:https:// 域名 :端口 8 signalingDomainOut string 外侧信令domain; 格式:https://域名:端口 9 locationId string 节点 10 signature string 签名 11 appId string 用户标识
  • 接口URI https://ip:port/agentgateway/resource/mediacall/{agentid}/getconnectinfo 其中,ip为CC-Gateway服务器地址,port为CC-Gateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号,取值范围:101~59999。
  • 请求说明 消息头 表2 请求头参数说明 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息主体编码方式,缺省值:application/json; charset=UTF-8 2 Guid string True 静态鉴权(AUTHMODE = 1)签入接口返回的Guid;动态鉴权(AUTHMODE = 2)轮询事件接口返回的Guid。 消息体 表3 消息体参数说明 序号 名称 参数类型 是否必选 说明 1 userType string True 用户类型。 默认为“agent”代表座席 2 callid string True 呼叫标识。
  • 报文样例 该接口的请求消息体举例如下: { "name": "中秋节", "type": 2, "week": null, "beginTime": "2018-09-22", "endTime": "2018-09-24" } 该接口的响应消息体举例如下: { "resultCode": "0200000", "resultDesc": "", "returnCode": "0200000", "returnDesc": "", "returnObject": { "id": 1318795089 } }
  • 请求说明 表2 请求消息头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表3 请求消息体参数说明 序号 参数名 参数类型 是否必选 说明 1 name String True 特殊日期名称。 名称不能重复,最大长度为30个字符。 2 type int True 特殊日期的类型。 取值范围: 1:按周设置 2:按日期设置 3:按日期重复 3 week String False 星期,特殊日期的类型为按周设置时为True。 取值范围: 1:星期一 2:星期二 3:星期三 4:星期四 5:星期五 6:星期六 7:星期天 同时选择多天时以逗号分隔,例如“6,7”表示星期六、星期天 4 beginTime String False 开始时间,特殊日期的类型为按日期设置或按日期重复时为True。 特殊日期的类型为2时,数据格式:yyyy-MM-dd 特殊日期的类型为3时,数据格式:MM-dd 5 endTime String False 结束时间,特殊日期的类型为按日期设置或按日期重复时为True。 特殊日期的类型为2时,数据格式:yyyy-MM-dd 特殊日期的类型为3时,数据格式:MM-dd
  • 错误结果码 表6 错误原因码说明 序号 错误码 说明 1 0200001 参数异常,异常详情在resultDesc中描述。 2 0200007 外呼活动不存在。 3 0200013 特殊日期名称已存在。 4 0200015 外呼活动的特殊日期数量已达上限。 5 0200030 时间格式不正确。 6 02000001 参数值为空 7 02000002 参数包含非法字符 8 02000003 参数长度不能大于规定长度 9 02000004 参数长度不能小于规定长度 10 02000005 参数长度需要介于规定长度之间 11 02000006 参数值类型不正确 12 02000007 参数值大小不正确 13 02000008 参数转换异常,请检查请求参数 14 02000009 参数组合不正确,请检查请求参数 15 02000010 hour和minute必须同时存在 16 02000011 参数个数不能大于规定个数
  • 接口URI https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/holiday/{campaignId} 其中,ip为CC-iSales服务器地址,port为CC-iSales服务器的HTTPS端口号。 表1 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数,取值范围为1~9999。 2 campaignId int True 外呼活动的ID。
  • 响应说明 表4 消息体参数说明 序号 参数名 参数类型 说明 1 resultCode String 原因码。0200000表示成功,其他表示失败。 具体见表6 2 resultDesc String 描述。 3 returnObject Object 参见表5。 4 returnCode String 原因码。0200000表示成功,其他表示失败。 具体见表6 5 returnDesc String 描述。 表5 returnObject参数说明 序号 参数名 参数类型 说明 1 id int 特殊日期id。
  • 样例报文 请求头: Content-Type: application/json;charset=UTF-8 Authorization: ****************** 请求参数: { "queryParam": { "callerNos": ["120002"], "beginLogDay": "2021-10-26", "endLogDay": "2021-10-26", "callTypes": [7], "skillIds": [1,6], "subCcNo": 1, "vdn": 32 } } 响应参数: { "result": "0", "resultCode": "0100000", "resultDatas": [ { "failTimeGt10": 0, "outSuccWaitAnsNum": 2, "callType": 7, "callerNo": "120002", "maxCallTime": 38, "callTimeLt60": 2, "preViewedTransferNum": 0, "failTimeLt10": 0, "succAckTimeGt10": 1, "minWaitAnsTime": 1, "autoCallSuccNum": 0, "hangUpNum": 0, "preOccupiedSuccNum": 0, "preAgentNum": 0, "zeroNum": 0, "subCcNo": 1, "ivrOnlyTime": 0, "succAckTimeLt30": 2, "serviceNo": 1, "maxWaitAnsTime": 15, "obsServiceNo": "-1", "failTimeLt5": 0, "reservedCol3": 2, "ivrOnlyNum": 0, "reservedCol2": 0, "failTimeLt3": 0, "reservedCol1": 0, "reservedCol7": 0, "reservedCol6": 0, "reservedCol5": 0, "reservedCol4": 0, "preOccupiedAgentSuccNum": 0, "autoCallNum": 0, "hangUpReleaseNum": 0, "preTotalTime": 0, "preFailQueueWaitTime": 0, "preAbortQueueWaitNum": 0, "failTimeGt60": 0, "orgCcNo": 1, "succWaitAnsTime": 16, "callTimeGt60": 0, "outVdnTime": 105, "callTimeLt5": 0, "callTimeLt3": 0, "succAckTimeLt5": 1, "ivrCallSuccNum": 0, "preCallNum": 0, "succAckTimeLt10": 1, "outCallSuccNum": 2, "succAckTimeLt3": 1, "callTimeGt10": 2, "vdn": 32, "preAgentSuccNum": 0, "reservedCol10": 0, "outOccupyNum": 2, "ivrOccupyNum": 0, "beginLogDay": "2021-10-26", "reservedCol18": 0, "reservedCol17": 0, "reservedCol16": 0, "reservedCol15": 0, "reservedCol14": 0, "reservedCol13": 0, "reservedCol12": 0, "failTimeLt60": 0, "reservedCol11": 0, "hangUpTime": 0, "preOccupiedSuccAckTime": 0, "ivrOnlySuccNum": 0, "reservedCol19": 0, "autoAnsTime": 0, "callTimeLt10": 0, "outWaitAnsTime": 16, "currentSkillId": 1, "failQueueWaitNum": 0, "reservedCol20": 0, "reservedCol9": 0, "reservedCol8": 0, "outCallCostMinute": 2, "currentAgentId": 40002, "succAckTimeGt60": 0, "agentHangUpLt3": 0, "preQueueWaitTime": 0, "preQueueWaitNum": 0, "preViewedCallSuccNum": 0, "minCallTime": 26, "preOccupiedCallNum": 0, "agentTransferNum": 1, "succAckTimeLt60": 2, "preTransferNum": 0, "preViewedSuccAckTime": 0, "preFailQueueWaitNum": 0, "endLogDay": "2021-10-26", "preNoAckNum": 0, "ivrCallTime": 0, "failTimeLt30": 0, "preViewedCallNum": 0, "callTimeLt30": 1, "serCcNo": 1, "preCallSuccNum": 0, "outCallTime": 64, "preOccupiedTransferNum": 0, "failQueueWaitTime": 0, "preOccupiedAgentSuccTime": 0, "outCallAllCostMinute": 1, "autoTransferNum": 0 }, {......} ], "resultDesc": [ { "failTimeGt10": 0, "outSuccWaitAnsNum": 2, "callType": 7, "callerNo": "120002", "maxCallTime": 38, "callTimeLt60": 2, "preViewedTransferNum": 0, "failTimeLt10": 0, "succAckTimeGt10": 1, "minWaitAnsTime": 1, "autoCallSuccNum": 0, "hangUpNum": 0, "preOccupiedSuccNum": 0, "preAgentNum": 0, "zeroNum": 0, "subCcNo": 1, "ivrOnlyTime": 0, "succAckTimeLt30": 2, "serviceNo": 1, "maxWaitAnsTime": 15, "obsServiceNo": "-1", "failTimeLt5": 0, "reservedCol3": 2, "ivrOnlyNum": 0, "reservedCol2": 0, "failTimeLt3": 0, "reservedCol1": 0, "reservedCol7": 0, "reservedCol6": 0, "reservedCol5": 0, "reservedCol4": 0, "preOccupiedAgentSuccNum": 0, "autoCallNum": 0, "hangUpReleaseNum": 0, "preTotalTime": 0, "preFailQueueWaitTime": 0, "preAbortQueueWaitNum": 0, "failTimeGt60": 0, "orgCcNo": 1, "succWaitAnsTime": 16, "callTimeGt60": 0, "outVdnTime": 105, "callTimeLt5": 0, "callTimeLt3": 0, "succAckTimeLt5": 1, "ivrCallSuccNum": 0, "preCallNum": 0, "succAckTimeLt10": 1, "outCallSuccNum": 2, "succAckTimeLt3": 1, "callTimeGt10": 2, "vdn": 32, "preAgentSuccNum": 0, "reservedCol10": 0, "outOccupyNum": 2, "ivrOccupyNum": 0, "beginLogDay": "2021-10-26", "reservedCol18": 0, "reservedCol17": 0, "reservedCol16": 0, "reservedCol15": 0, "reservedCol14": 0, "reservedCol13": 0, "reservedCol12": 0, "failTimeLt60": 0, "reservedCol11": 0, "hangUpTime": 0, "preOccupiedSuccAckTime": 0, "ivrOnlySuccNum": 0, "reservedCol19": 0, "autoAnsTime": 0, "callTimeLt10": 0, "outWaitAnsTime": 16, "currentSkillId": 1, "failQueueWaitNum": 0, "reservedCol20": 0, "reservedCol9": 0, "reservedCol8": 0, "outCallCostMinute": 2, "currentAgentId": 40002, "succAckTimeGt60": 0, "agentHangUpLt3": 0, "preQueueWaitTime": 0, "preQueueWaitNum": 0, "preViewedCallSuccNum": 0, "minCallTime": 26, "preOccupiedCallNum": 0, "agentTransferNum": 1, "succAckTimeLt60": 2, "preTransferNum": 0, "preViewedSuccAckTime": 0, "preFailQueueWaitNum": 0, "endLogDay": "2021-10-26", "preNoAckNum": 0, "ivrCallTime": 0, "failTimeLt30": 0, "preViewedCallNum": 0, "callTimeLt30": 1, "serCcNo": 1, "preCallSuccNum": 0, "outCallTime": 64, "preOccupiedTransferNum": 0, "failQueueWaitTime": 0, "preOccupiedAgentSuccTime": 0, "outCallAllCostMinute": 1, "autoTransferNum": 0 }, {......} ] }
  • 响应消息 表3 消息体参数说明 参数名 数据类型 说明 result String 查询结果。取值如下: 0:成功 其他:失败 失败的原因说明请参见错误码参考。 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 resultCode string 查询结果。取值如下: "0100000":成功 其他:失败 失败的原因说明请参见错误码参考。 resultDatas array 查询成功后,返回结果信息的对象数组。 该数组中对象的参数说明请参见表4。 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 resultDesc array 查询成功后,返回结果信息的对象。 该对象的参数说明请参见表4。 表4 resultDesc/resultDatas对象参数说明 参数名 数据类型 说明 beginLogDay string 统计的开始通话时间,与入参一致。 endLogDay string 统计的结束通话时间,与入参一致。 callerNo string 呼叫的主叫号码。 callType int 呼叫类型。 vdn int 虚拟呼叫中心编号。 serviceNo int 业务类型。 orgCcNo int 原始呼叫中心子系统号。 subCcNo int 子系统号。 serCcNo int 服务方的子系统号。 currentAgentId int 外呼座席工号。 一通呼叫的最后一条话单的外呼座席工号(指标结算时不建议使用) currentSkillId int 技能队列编号。 一通呼叫的最后一条话单的技能队列编号(指标结算时不建议使用) obsServiceNo string 外呼活动编号。 failQueueWaitNum int 呼损等待次数。 failQueueWaitTime int 呼损等待时长(秒)。 outOccupyNum int 人工呼出次数。 outSuccWaitAnsNum int 人工呼出应答次数。 outCallSuccNum int 人工呼出成功次数。 outWaitAnsTime int 呼出等待应答时长(秒)。 outCallTime int 呼出通话时长(秒)。 maxWaitAnsTime int 最大等待应答时长(秒)。 minWaitAnsTime int 最小等待应答时长(秒)。 maxCallTime int 最大通话时长(秒)。 minCallTime int 最小通话时长(秒)。 succAckTimeLt3 int 应答短于3秒的成功通话量。 callTimeLt3 int 通话时间短于3秒的成功通话量。 failTimeLt3 int 等待时长短于3秒的失败量。 succAckTimeLt5 int 应答短于5秒的成功通话量。 callTimeLt5 int 通话时间短于5秒的成功通话量。 failTimeLt5 int 等待时长短于5秒的失败量。 succAckTimeLt10 int 应答短于10秒的成功通话量。 callTimeLt10 int 通话时间短于10秒的成功通话量。 failTimeLt10 int 等待时长短于10秒的失败量。 succAckTimeLt30 int 应答短于30秒的成功通话量。 callTimeLt30 int 通话时间短于30秒的成功通话量。 failTimeLt30 int 等待时长短于30秒的失败量。 succAckTimeLt60 int 应答短于60秒的成功通话量。 callTimeLt60 int 通话时间短于60秒的成功通话量 failTimeLt60 int 等待时长短于60秒的失败量 succAckTimeGt10 int 应答大于10秒的成功通话量 callTimeGt10 int 通话时间大于10秒的成功通话量 failTimeGt10 int 等待时长大于10秒的失败量 succAckTimeGt60 int 应答大于60秒的成功通话量 callTimeGt60 int 通话时间大于60秒的成功通话量。 failTimeGt60 int 等待时长大于60秒的失败量。 agentHangUpLt3 int 短于3秒的主叫挂断通话量。 preAgentSuccNum int 预测外呼时转人工服务通话次数。 preViewedTransferNum int 预览外呼时座席转出次数。 hangUpTime int 人工转IVR总时间。 preOccupiedSuccAckTime int 预占外呼接通前等待时长(秒)。 autoAnsTime int 系统级IVR外呼振铃时长(秒)。 autoCallSuccNum int 系统级IVR外呼通话次数。 preOccupiedSuccNum int 预占外呼接通前等待时长(秒)。 hangUpNum int 人工转IVR次数。 preAgentNum int 预测呼出转人工服务次数。 zeroNum int 零话单数。 preQueueWaitTime int 预测外呼时排队等待时长(秒)。 preQueueWaitNum int 预测外呼时排队等待次数。 preViewedCallSuccNum int 预览外呼接通次数。 preOccupiedCallNum int 预占外呼总次数。 preOccupiedAgentSuccNum int 预占外呼人工通话数。 agentTransferNum int 人工外呼转出数。 autoCallNum int 系统级IVR外呼数。 hangUpReleaseNum int 人工转IVR挂机数。 preTransferNum int 预测外呼转出数。 preTotalTime int 预测外呼总时长(秒)。 preFailQueueWaitNum int 预测外呼呼损排队等待次数。 preViewedSuccAckTime int 预览外呼接通前等待时长(秒)。 preFailQueueWaitTime int 预测外呼呼损排队等待时长(秒) preAbortQueueWaitNum int 预测外呼呼叫释放排队等待次数。 preNoAckNum int 预测外呼用户摘机请求人工服务无应答次数。 succWaitAnsTime int 成功通话应答时长(秒)。 outVdnTime int 呼出呼叫占用VDN总时长(秒)。 preViewedCallNum int 预览外呼总次数。 preCallSuccNum int 预测外呼接通数。 preOccupiedTransferNum int 预占外呼时座席转出次数。 preCallNum int 预测外呼发起数。 preOccupiedAgentSuccTime int 预占外呼人工通话时长(秒)。 autoTransferNum int 系统级IVR外呼转出数。 outCallCostMinute int 人工通话计费时长(分钟) ivrCallSuccNum int IVR外呼通话次数 ivrCallTime int IVR外呼通话时长(秒) ivrOccupyNum int IVR外呼请求次数 ivrOnlyNum int IVR唯一呼出数 ivrOnlySuccNum int IVR唯一接通数 ivrOnlyTime int IVR唯一呼出时长(秒) outCallAllCostMinute int 每通通话计费总时长(分钟),包括人工通话计费时长和IVR通话计费时长。 reserved_col1-reserved_col20 int 预留字段,业务含义根据表t_cms_custom_indicator_config配置确定 ;默认预留字段3为呼出通话时长大于等于15秒的呼出数。
  • 主席变更事件 标示符 AgentConf_PresidentChanged 作用 表示当前座席被变更为会议主席。 附带信息 confId表示会议ID。 示例: {"message":"","retcode":"0","event":{"eventType":"AgentConf_PresidentChanged","workNo":"154","content":{"confId":1031168}} 父主题: 座席会议事件
  • 接口URI https://ip:port/agentgateway/resource/onlineagent/{agentid}/agentstatus 其中,ip为CC-Gateway服务器地址,port为CC-Gateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号,取值范围:101~59999。
  • 响应说明 表3 消息体参数说明 序号 名称 参数类型 说明 1 message string 描述 2 retcode string 错误码。取值如下: 0:成功 非0:失败 3 result array 请参考表4 表4 座席状态信息 序号 名称 参数类型 说明 3.1 agentState int 座席状态。请参考表1 3.2 isWorking boolean false表示没有正在通话。 true表示正在通话。
  • 报文样例 消息头 Content-Type:application/json; charset=UTF-8 Guid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 无 响应参数 { "message": "", "retcode": "0", "result": { "agentState": 4, "isWorking": false } }
  • 错误结果码 表4 错误原因码说明 序号 错误码 说明 1 0200001 参数异常,异常详情在resultDesc中描述。 2 0200007 外呼活动不存在。 3 0200014 特殊日期不存在。 4 02000001 参数值为空 5 02000002 参数包含非法字符 6 02000003 参数长度不能大于规定长度 7 02000004 参数长度不能小于规定长度 8 02000005 参数长度需要介于规定长度之间 9 02000006 参数值类型不正确 10 02000007 参数值大小不正确 11 02000008 参数转换异常,请检查请求参数 12 02000009 参数组合不正确,请检查请求参数 13 02000010 hour和minute必须同时存在 14 02000011 参数个数不能大于规定个数
  • 接口URI https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/holiday/{campaignId}/{holidayId} 其中,ip为CC-iSales服务器地址,port为CC-iSales服务器的HTTPS端口号。 表1 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数,取值范围为1~9999。 2 campaignId int True 外呼活动的ID。 3 holidayId int True 特殊日期ID。
共100000条