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

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

a、请求

  • HTTP请求方式：POST

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

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

  • 鉴权方式：接口鉴权

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

b、适用报表

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

c、时间查询

日报，月报

d、请求体

字段 是否必填 值
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：月报

e、响应体：

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

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

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

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

a、请求

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

b、请求体:

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

c、响应

响应体:

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

响应码:

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

d、返回示例:

{
  "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%"
  },
  // ...
  ]
}

3、会话数时间趋势报表

报表→在线客服报表→会话报表→会话数时间趋势报表

a.请求

  • 请求方式：POST

  • 请求URL：{HOST}/v20180426/reportIM/queryImSessionTimeReport/{ACCOUNTID}?sig=sig

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

  • 鉴权方式：接口鉴权

  • 频次限制：20次/每分钟

  • 请求示例：http://apis.7moor.com/v20180426/reportIM/queryImSessionTimeReport/N000000xxxxx?sig=DBD2D28F3D895AAD1572925AAE50AEA8

b.请求体

字段 是否必填 值
yearReport 是 2020
monthReport 是 查询月报必传（示例：查询1月报表可传'01'）
dayReport 是 查询日报必传（示例：查询1号报表可传'01'）
timeType 是 day：日报 month：月报
selectedAccessIdList 否 接入号id

c.返回值

字段 含义
code 响应码
message 响应信息
data 返回数据,JSON格式。sum：报表合计信息记录，description：报表表头信息描述，data：报表普通记录信息

d.请求体示例

{
      "yearReport":"2020",
      "monthReport":"08",
      "dayReport":"17",
      "timeType":"day",
      "selectedAccessIdList":["4fb75c90-b81d-11e9-b498-3531d7fbe0f8"]
}

4、坐席工作量报表

报表→在线客服报表→坐席报表→坐席工作量报表

a、请求

  • 请求方式：POST

  • 请求URL：{HOST}/v20180426/reportIM/queryImAgentReport/{ACCOUNTID}?sig=sig

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

  • 鉴权方式：接口鉴权

  • 频次限制：20次/每分钟

  • 请求示例：http://apis.7moor.com/v20180426/reportIM/queryImAgentReport/N000000xxxxx?sig=DBD2D28F3D895AAD1572925AAE50AEA8

b、请求体

字段 是否必填 值
yearReport 是 2020
monthReport 是 查询月报必传（示例：查询1月报表可传'01'）
dayReport 是 查询日报必传（示例：查询1号报表可传'01'）
timeType 是 day：日报 month：月报

c、返回值

字段 含义
code 响应码
message 响应信息
data 返回数据,JSON格式。sum：报表合计信息记录，description：报表表头信息描述，data：报表普通记录信息

d、请求体示例

{
    "yearReport":"2020",
    "monthReport":"08",
    "dayReport":"17",
    "timeType":"day"
}

5、客服响应统计报表

报表→在线客服报表→坐席报表→客服响应统计报表

a、请求

  • 请求方式：POST

  • 请求URL：{HOST}/v20180426/reportIM/queryImAgentResponseReport/{ACCOUNTID}?sig=sig

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

  • 鉴权方式：接口鉴权

  • 频次限制：20次/每分钟

  • 请求示例：http://apis.7moor.com/v20180426/reportIM/queryImAgentResponseReport/N000000xxxxx?sig=DBD2D28F3D895AAD1572925AAE50AEA8

b、请求体

字段 是否必填 值
yearReport 是 2020
monthReport 是 查询月报必传（示例：查询1月报表可传'01'）
dayReport 是 查询日报必传（示例：查询1号报表可传'01'）
timeType 是 day：日报 month：月报

c、返回值

字段 含义
code 响应码
message 响应信息
data 返回数据,JSON格式。sum：报表合计信息记录，description：报表表头信息描述，data：报表普通记录信息

d、请求体示例

{
    "yearReport":"2020",
    "monthReport":"08",
    "dayReport":"17",
    "timeType":"day"
}

6、坐席满意度报表

报表→在线客服报表→坐席报表→坐席满意度报表

a、请求

  • 请求方式：POST

  • 请求URL：{HOST}/v20180426/reportIM/queryImCsrReport/{ACCOUNTID}?sig=sig

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

  • 鉴权方式：接口鉴权

  • 频次限制：20次/每分钟

  • 请求示例：http://apis.7moor.com/v20180426/reportIM/queryImCsrReport/N000000xxxxx?sig=DBD2D28F3D895AAD1572925AAE50AEA8

b、请求体

字段 是否必填 值
yearReport 是 2020
monthReport 是 查询月报必传（示例：查询1月报表可传'01'）
dayReport 是 查询日报必传（示例：查询1号报表可传'01'）
timeType 是 day：日报 month：月报

c、返回值

字段 含义
code 响应码
message 响应信息
data 返回数据,JSON格式。sum：报表合计信息记录，description：报表表头信息描述，data：报表普通记录信息

d、请求体示例

{
    "yearReport":"2020",
    "monthReport":"08",
    "dayReport":"17",
    "timeType":"day"
}

在线接口报错返回

{
    "code":400,
    "message": "timeType_only_supports_month_or_day_query"
}

{
    "code": 400,
    "message": "query_monthly_report_need_year_and_month"
}