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"
}