1、通话报表数据查询接口

注意:本接口的使用需要进行接口鉴权

1、请求

  • HTTP请求方式:POST

  • 请求url:{HOST}/v20180426/report/getReportData/{ACCOUNTID}?sig={SIG}

  • 请求时请将{HOST}换成对接数据查询中获取到的请求域名,{ACCOUNTID}替换为账户编号,{SIG}是根据鉴权规则生成的,请看鉴权文档,查看具体的生成规则

  • 鉴权方式:接口鉴权

  • 请求频次限制:1次/分钟

2、适用报表

通话报表-坐席报表-坐席工作量报表,工单整体分析报表,工单座席工作量报表,呼出时间趋势报表,技能组对比报表

3、时间查询

日报,月报

请求体

字段 是否必填
reportType call_report_agent:坐席工作量报表
call_report_callout_time:呼出时间趋势报表
business_report_analyse:工单整体分析报表
business_report_agent:工单坐席工作量报表
call_report_queue:技能组对比报表
yearReport 2020
monthReport 查询月报必传(示例:查询1月报表可传'01')
dayReport 查询日报必传(示例:查询1号报表可传'01')
timeType day:日报
month:月报

响应体:

{
        "success":true,
        "tableHeader": {}   // 报表表头字段说明
        "data":[]           //报表数据
   }

2、通话座席工作量报表日报详情查询接口

查询指定座席一天内的详细报表数据。

报表时间ReportTime表示[ReportTime, RportTime + 30分钟)这样一个时间段,即半小时时间段的开始时间。

请求

  • HTTP请求方式: POST
  • 请求url: {HOST}/v20180426/report/getAgentReportDetails/{ACCOUNTID}?sig={SIG}
  • 请求时请将{HOST}换成对接数据查询中获取到的请求域名,{ACCOUNTID}替换为账户编号,{SIG}是根据鉴权规则生成的,请看鉴权文档,查看具体的生成规则
  • 鉴权方式:接口鉴权
  • 请求频次限制: 1次/分钟

请求体:

参数 是否必填 类型 描述
agent 字符串 YYYY, 例如2020
year 字符串 座席ID或座席工号
month 字符串 MM, 例如08
day 字符串 DD, 例如01
zeroFill 布尔类型 是否按1天48个半小时时段补全数据

响应

响应体:

字段 含义
code 响应码
message 响应信息
success 是否成功
tableHeader 表头,包含了字段说明
data 报表数据

响应码:

代码 含义
200 请求成功
400 请求参数错误
401 鉴权错误
403 接口访问频次达到上限
500 服务器错误

返回示例:

{
  "success": true,
  "tableHeader": {
    "_id": "521aca13f16743b15374a1f1",
    "Account": "system",
    "Config": [
      {
        "name": "show_time",
        "displayname": "时间",
        "show": true,
        "order": "1"
      },
      {
        "name": "CallInAccessCount",
        "displayname": "呼入振铃数",
        "show": true,
        "order": "2"
      },
      {
        "name": "CallInAcceptCount",
        "displayname": "呼入接通数",
        "show": true,
        "order": "3"
      },
      // ...
    ],
  },
  "data": [
  {
    "ReportTime": "2020-08-26 00:00:00",
    "CallInAcceptCount": 0,
    "CallInAccessCount": 0,
    "CallOutAcceptCount": 0,
    "CallOutAccessCount": 0,
    "TransferAcceptCount": 0,
    "TransferUnacceptCount": 0,
    "RingingTimeLength": 0,
    "HoldTimeLength": 0,
    "ConsultTimeLength": 0,
    "ThreeWayCallTimeLength": 0,
    "CallInTimeLength": 0,
    "CallOutTimeLength": 0,
    "LOGIN_TIME_LENGTH": 0,
    "BUSY_TIME_LENGTH": 0,
    "IDLE_TIME_LENGTH": 0,
    "STATE2_TIME_LENGTH": 0,
    "STATE3_TIME_LENGTH": 0,
    "STATE4_TIME_LENGTH": 0,
    "STATE5_TIME_LENGTH": 0,
    "STATE6_TIME_LENGTH": 0,
    "STATE7_TIME_LENGTH": 0,
    "STATE8_TIME_LENGTH": 0,
    "STATE9_TIME_LENGTH": 0,
    "STATE99_TIME_LENGTH": 0,
    "NormalTransferTimeLength": 0,
    "DialTransferTimeLength": 0,
    "IncomingRingingTimeLength": 0,
    "OutgoingWaitingTimeLength": 0,
    "OutgoingAbandonCount": 0,
    "HoldSoftphoneCount": 0,
    "HoldSoftphoneTimeLength": 0,
    "RollOutCount": 0,
    "RepeatCallInBy24hCount": 0,
    "RepeatCallInBy48hCount": 0,
    "RedirectAgentDeal": 0,
    "RedirectAgentNotDeal": 0,
    "RedirectGroupDeal": 0,
    "RedirectGroupNotDeal": 0,
    "CallInAcceptRate": "0%",
    "IntegratedCallInAcceptRate": "0%",
    "CallInAverageTimeLength": 0,
    "CallOutAverageTimeLength": 0,
    "AverageHourCallCount": 0,
    "CallInNotDealCount": 0,
    "TransferTimeLength": 0,
    "TransferCount": 0,
    "TransferAcceptRate": "0%"
  },
  // ...
  ]
}