1.1 接口说明

查询通话报表->座席工作量报表；可通过is_all_agent字段筛选：选择全部座席，或仅展示有通话记录的座席

1.2 调用形式

https://ykf.uincall.com/openapi/report/call/agent/v1?tenant_id=acf528a2-d0e2-4a7b-8513-74cb399xxxxx&access_token=670253572927b24acffc41078ddxxxxx

1.3 调用方式

POST

1.4 传入参数

非必填参数，调用接口时请传递参数名，参数值可为空

序号 名称 类型 是否必填 说明
1 date String 是 日期类型 必须为yyyy-MM-dd格式
2 kind Integer 是 0 按天查询 1 按周查询 2 按月查询 3 按年查询 4 自定义日期查询
3 agents List 否 座席工号（agent_num）集合
4 is_all_agent String 否 为true时返回所有座席，为false时仅返回有通话的座席数据
5 start String 否 自定义查询开始时间（kind为4时，此参数为必填，且必须为yyyy-MM-dd HH:mm:ss格式）
6 end String 否 自定义查询结束时间（kind为4时，此参数为必填，且必须为”yyyy-MM-dd HH:mm:ss格式）

1.5 回应参数

序号 名称 类型 是否必填 说明
1 errcode Number 是 状态码：0成功，及其他非0错误码，详见错误码列表
2 errmsg String 是 状态说明
3 data Object数组 是 结果集（有数据时返回Object）
3.1 agent_id Integer 是 座席Id
3.2 agent_name Integer 是 座席名称
3.3 agent_num Integer 是 座席工号
3.4 call_in_total Integer 是 呼入总数
3.5 call_out_total Integer 是 外呼总数
3.6 call_out_success Integer 是 外呼成功数
3.7 call_out_fail Integer 是 外呼振铃未接听
3.8 call_in_alerting Integer 是 呼入振铃数
3.9 call_in_success Integer 是 呼入接通数
3.10 transfer_success Integer 是 转接电话接通数
3.11 transfer_fail Integer 是 转接电话未接通数
3.12 call_in_service_time Integer 是 呼入通话总时长（秒）
3.13 call_in_avg_service_time Integer 是 呼入通话平均时长（秒）
3.14 call_out_transfer_service_time Integer 是 外呼转接通话总时长（秒）
3.15 call_out_service_time Integer 是 外呼通话总时长（秒）
3.16 call_out_avg_service_time Integer 是 外呼通话平均时长（秒）
3.17 call_out_waiting_time Integer 是 外呼等待总时长（秒）
3.18 busy_time Integer 是 置忙总时长（秒）
3.19 manual_busy_time Integer 是 手动置忙总时长（秒）
3.20 ready_time Integer 是 置闲总时长（秒）
3.21 alerting_time Integer 是 振铃总时长（秒）
3.22 hold_time Integer 是 保持总时长（秒）
3.23 consult_time Integer 是 咨询总时长（秒）
3.24 third_time Integer 是 三方通话总时长（秒）
3.25 service_time Integer 是 通话总时长（秒）
3.26 transfer_time Integer 是 转接来电接听总时长（秒）
3.27 transfer_in_time Integer 是 呼入转接接听总时长（秒）
3.28 transfer_out_time Integer 是 外呼转接接听总时长（秒）
3.29 call_in_alerting_time Integer 是 呼入振铃总时长（秒）
3.30 call_out_alerting_time Integer 是 外呼等待总时长（秒）
3.31 max_service_time Integer 是 最大通话时长（秒）
3.32 hold_count Integer 是 保持数量
3.33 online_time Integer 是 在线总时长（秒）
3.34 h24 Integer 是 24小时重复来电
3.35 h48 Integer 是 48小时重复来电
3.36 transfer_success_total Integer 是 转出电话接通数
3.37 transfer_skill_success_total Integer 是 转出给技能组接通数
3.38 transfer_fail_total Integer 是 转出电话未接通数
3.39 transfer_total Integer 是 转接来电数
3.40 transfer_success_rate Integer 是 转接来电接通率（百分比 1 就是百分之百）
3.41 short_break_time Integer 是 小休置忙总时长
3.42 call_in_avg_alerting_time Integer 是 呼入振铃平均时长
3.43 send_third_call_total Integer 是 发起三方通话数
3.44 effective_connect_rate Integer 是 有效接通率
3.45 transfer_in_total_time Integer 是 转接来电接听总时长
3.46 transfer_out_count Integer 是 转出电话数
3.47 awc Integer 是 (呼入接通后处理时间+呼出接通后处理时间)/人工接通量=每通呼叫处理时间
3.48 effective_connect_rate Integer 是 有效接通率
3.49 call_out_success_rate Integer 是 外呼接通率
3.50 call_in_success_rate Integer 是 呼入接通率
4 totalRow Object数组 是 合计行数据。该字段包含当前 graph中所有数值指标的汇总值，用于展示各维度的总计情况。

注：未注明字段，暂不关注

1.6 使用样例

调用：

url：https://ykf.uincall.com/openapi/report/call/agent?tenant_id=acf528a2-d0e2-4a7b-8513-74cb39xxxxxx&access_token=9f6c4092c144362b36767a4160xxxxxx

按天查询：

{
"kind": 0,
"date": "2026-10-28",
"is_all_agent": false,
"agents": ["8014"]
}

按周查询：

    字段解释说明：
"date": "2022-04-29",    --日期类型必须为yyyy-MM-dd格式，所传日期为周的任意一天
"kind": 1,               --1代表按周查询
"agents":["1007"]        --只查询1007座席

    POST数据：
{
    "date": "2022-04-29",
    "is_all_agent": false,
    "kind": 1,
    "agents":["1007"]
}

按月查询：

    字段解释说明：
"date": "2022-04-29",    --日期类型必须为yyyy-MM-dd格式，所传日期为月的任意一天
"kind": 2,               --2代表按月查询
"is_all_agent": false,
"agents":["1007"]        --只查询1007座席

    POST数据：
{
    "date": "2022-04-29",
    "is_all_agent": false,
    "kind": 2,
    "agents":["1007"]
}

按年查询：

    字段解释说明：
"date": "2022-04-29",    --日期类型必须为yyyy-MM-dd格式，所传日期为年的任意一天
"kind": 3,               --3代表按年查询
"is_all_agent": false,
"agents":["1007"]        --只查询1007座席

    POST数据：
{
    "date": "2022-04-29",
    "kind": 3,
    "is_all_agent": false,
    "agents":["1007"]
}

自定义日期查询：

    字段解释说明：
"start": "2022-05-01 00:00:00",    --自定义查询开始时间，日期类型必须为yyyy-MM-dd HH:mm:ss格式
"end": "2022-05-20 23:59:59",    --自定义查询结束时间，日期类型必须为yyyy-MM-dd HH:mm:ss格式
"kind": 4                        --4代表自定义日期查询
"is_all_agent": false

    POST数据：
{
    "start": "2022-05-01 00:00:00",
    "end": "2022-05-20 23:59:59",
    "is_all_agent": false,
    "kind": 4
}

响应：

{
    "errcode": 0,
    "errmsg": null,
    "data": {
            "totalRow": {
                    "agent_id": "total",
                    "agent_name": "合计",
                    "agent_num": "合计",
                    "call_in_total": 0,
                    "call_out_total": 5,
                    "call_out_success": 4,
                    "call_out_fail": 1,
                    "call_in_alerting": 0,
                    "call_in_success": 0,
                    "transfer_success": 0,
                    "transfer_fail": 0,
                    "call_in_service_time": 0,
                    "call_in_avg_service_time": 0,
                    "call_out_transfer_service_time": 0,
                    "call_out_service_time": 25,
                    "call_out_avg_service_time": 6,
                    "call_out_waiting_time": 10,
                    "busy_time": 62,
                    "manual_busy_time": 0,
                    "ready_time": 17714,
                    "offline_time": 0,
                    "no_connected_time": 0,
                    "total_time": 0,
                    "alerting_time": 15,
                    "hold_time": 0,
                    "consult_time": 0,
                    "third_time": 0,
                    "service_time": 25,
                    "transfer_in_total_time": 0,
                    "transfer_in_time": 0,
                    "transfer_out_time": 0,
                    "call_in_alerting_time": 0,
                    "call_in_avg_alerting_time": 0,
                    "call_out_alerting_time": 15,
                    "max_service_time": 9,
                    "hold_count": 0,
                    "online_time": 17776,
                    "h24": 0,
                    "h48": 0,
                    "transfer_out_count": 0,
                    "transfer_success_total": 0,
                    "transfer_skill_success_total": 0,
                    "transfer_fail_total": 0,
                    "transfer_total": 0,
                    "transfer_success_rate": 0,
                    "busy_after_time": 22,
                    "call_valid_total": 3,
                    "awc": 6,
                    "effective_connect_rate": 0.75,
                    "send_third_call_total": 0,
                    "short_break_time": 0,
                    "locked_time": 0,
                    "online_hold_time": 0,
                    "call_in_normal_success_rate": 0,
                    "call_out_success_rate": 0.8,
                    "call_in_success_rate": 0
            },
            "graph": [
                    {
                            "agent_id": "904970c00cb1ec7ee8c838562270d787",
                            "agent_name": "8014",
                            "agent_num": "8014",
                            "call_in_total": 0,
                            "call_out_total": 5,
                            "call_out_success": 4,
                            "call_out_fail": 1,
                            "call_in_alerting": 0,
                            "call_in_success": 0,
                            "transfer_success": 0,
                            "transfer_fail": 0,
                            "call_in_service_time": 0,
                            "call_in_avg_service_time": 0,
                            "call_out_transfer_service_time": 0,
                            "call_out_service_time": 25,
                            "call_out_avg_service_time": 6,
                            "call_out_waiting_time": 10,
                            "busy_time": 62,
                            "manual_busy_time": 0,
                            "ready_time": 17714,
                            "offline_time": null,
                            "no_connected_time": null,
                            "total_time": null,
                            "alerting_time": 15,
                            "hold_time": 0,
                            "consult_time": 0,
                            "third_time": 0,
                            "service_time": 25,
                            "transfer_in_total_time": 0,
                            "transfer_in_time": 0,
                            "transfer_out_time": 0,
                            "call_in_alerting_time": 0,
                            "call_in_avg_alerting_time": 0,
                            "call_out_alerting_time": 15,
                            "max_service_time": 9,
                            "hold_count": 0,
                            "online_time": 17776,
                            "h24": 0,
                            "h48": 0,
                            "transfer_out_count": 0,
                            "transfer_success_total": 0,
                            "transfer_skill_success_total": 0,
                            "transfer_fail_total": 0,
                            "transfer_total": 0,
                            "transfer_success_rate": 0,
                            "busy_after_time": 22,
                            "call_valid_total": 3,
                            "awc": 6,
                            "effective_connect_rate": 0.75,
                            "send_third_call_total": 0,
                            "short_break_time": 0,
                            "locked_time": null,
                            "online_hold_time": 0,
                            "call_in_normal_success_rate": 0,
                            "call_out_success_rate": 0.8,
                            "call_in_success_rate": 0
                    }
            ]
    }
}

其他异常响应：

{
"errcode": 140006,
"errmsg": "查询座席报表所传日期格式不正确"

}

文档更新时间: 2026-10-29 15:00   作者：admin