SparkTG

登录 / 登出汇总报表 (v2) 文档

登录 / 登出汇总报表 (v2)

v2

登录 / 登出汇总报表 (v2)

每位坐席的空闲、通话、休息和登出时长

API v2v21 个端点

概述

计费说明:本 API 按返回的记录数量计费。具体价格请联系您的客户经理。以扁平报表形式返回汇总的登录/登出及休息时长,每位坐席一行(服务 ID、坐席、SIP、空闲、通话、休息时长、登出)。没有 SIP/分机号的坐席将被省略。时间窗口必须至少为 1 小时,否则请求返回 400。所有时长均以秒为单位。

可用端点

POST/api/v2/reports/loginout-summary

关键参数

svc_id(Integer)

要生成报表的服务。默认为令牌所属的服务。

start_time(Integer (epoch ms))

时间窗口起点。

end_time(Integer (epoch ms))

时间窗口终点。范围必须不少于 1 小时,否则返回 400。

agent_sip(String)

按坐席 SIP/分机号筛选,或使用逗号分隔的列表。省略或留空则包含所有坐席。

快速示例

使用简单的 cURL 命令试用此 API

基础 API 调用
curl -X POST 'https://telephonycloud.co.in/api/v2/reports/loginout-summary' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"svc_id": 3, "start_time": 1776277800000, "end_time": 1776364200000, "agent_sip": ""}'
💡 将 <YOUR_TOKEN> 替换为您的 API 令牌

响应预览

此 API 的示例响应

示例响应
[{"service_id":3,"agent_name":"Ravi Kumar","sip":"10101","idle":57026,"talk":1704,"logout":21356,"breaks":[{"status_code":1,"status_label":"Meal","duration":2977},{"status_code":9,"status_label":"ACW"...
在“响应”部分查看完整的响应格式