1.1 接口说明

查询通话报表->座席工作量报表

1.2 调用形式

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

1.3 调用方式

POST

1.4 传入参数

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

序号 名称 类型 是否必填 说明
1 date String 是 日期类型 必须为yyyy-MM-dd格式
2 kind Integer 是 0 按天查询 1 按周查询 2 按月查询 3 按年查询 4 自定义日期查询
3 agents List 否 座席工号（agent_num）集合
3 start String 否 自定义查询开始时间（kind为4时，此参数为必填，且必须为yyyy-MM-dd HH:mm:ss格式）
3 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 就是百分之百）

1.6 使用样例

调用：

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

按天查询：

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

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

响应：

{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "graph": [
            {
                "agent_id": "a9d61bec32c7ad62c5054b6db2402109",
                "agent_name": "不知道为什么这么样子这么可爱一123qq",
                "agent_num": "1007",
                "call_in_total": 0,
                "call_out_total": 2,
                "call_out_success": 0,
                "call_out_fail": 2,
                "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": 0,
                "call_out_avg_service_time": 0,
                "call_out_waiting_time": 0,
                "busy_time": 7,
                "manual_busy_time": 0,
                "ready_time": 93578,
                "alerting_time": 7,
                "hold_time": 0,
                "consult_time": 0,
                "third_time": 0,
                "service_time": 0,
                "transfer_time": 0,
                "transfer_in_time": 0,
                "transfer_out_time": 0,
                "call_in_alerting_time": 0,
                "call_out_alerting_time": 7,
                "max_service_time": 0,
                "hold_count": 0,
                "online_time": 93585,
                "h24": 0,
                "h48": 0,
                "transfer_success_total": 0,
                "transfer_skill_success_total": 0,
                "transfer_fail_total": 0,
                "transfer_total": 0,
                "transfer_success_rate": 0
            }
        ]
    }
}

按周查询：

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

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

响应：

{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "graph": [
            {
                "agent_id": "a9d61bec32c7ad62c5054b6db2402109",
                "agent_name": "不知道为什么这么样子这么可爱一123qq",
                "agent_num": "1007",
                "call_in_total": 0,
                "call_out_total": 28,
                "call_out_success": 0,
                "call_out_fail": 28,
                "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": 0,
                "call_out_avg_service_time": 0,
                "call_out_waiting_time": 0,
                "busy_time": 84,
                "manual_busy_time": 14,
                "ready_time": 187368,
                "alerting_time": 81,
                "hold_time": 0,
                "consult_time": 0,
                "third_time": 0,
                "service_time": 0,
                "transfer_time": 0,
                "transfer_in_time": 0,
                "transfer_out_time": 0,
                "call_in_alerting_time": 0,
                "call_out_alerting_time": 81,
                "max_service_time": 0,
                "hold_count": 0,
                "online_time": 187452,
                "h24": 0,
                "h48": 0,
                "transfer_success_total": 0,
                "transfer_skill_success_total": 0,
                "transfer_fail_total": 0,
                "transfer_total": 0,
                "transfer_success_rate": 0
            }
        ]
    }
}

按月查询：

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

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

响应：

{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "graph": [
            {
                "agent_id": "a9d61bec32c7ad62c5054b6db2402109",
                "agent_name": "不知道为什么这么样子这么可爱一123qq",
                "agent_num": "1007",
                "call_in_total": 0,
                "call_out_total": 28,
                "call_out_success": 0,
                "call_out_fail": 28,
                "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": 0,
                "call_out_avg_service_time": 0,
                "call_out_waiting_time": 0,
                "busy_time": 84,
                "manual_busy_time": 14,
                "ready_time": 187368,
                "alerting_time": 81,
                "hold_time": 0,
                "consult_time": 0,
                "third_time": 0,
                "service_time": 0,
                "transfer_time": 0,
                "transfer_in_time": 0,
                "transfer_out_time": 0,
                "call_in_alerting_time": 0,
                "call_out_alerting_time": 81,
                "max_service_time": 0,
                "hold_count": 0,
                "online_time": 187452,
                "h24": 0,
                "h48": 0,
                "transfer_success_total": 0,
                "transfer_skill_success_total": 0,
                "transfer_fail_total": 0,
                "transfer_total": 0,
                "transfer_success_rate": 0
            }
        ]
    }
}

按年查询：

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

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

响应：

{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "graph": [
            {
                "agent_id": "a9d61bec32c7ad62c5054b6db2402109",
                "agent_name": "不知道为什么这么样子这么可爱一123qq",
                "agent_num": "1007",
                "call_in_total": 0,
                "call_out_total": 33,
                "call_out_success": 0,
                "call_out_fail": 33,
                "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": 0,
                "call_out_avg_service_time": 0,
                "call_out_waiting_time": 0,
                "busy_time": 310,
                "manual_busy_time": 14,
                "ready_time": 196674,
                "alerting_time": 196,
                "hold_time": 0,
                "consult_time": 0,
                "third_time": 0,
                "service_time": 0,
                "transfer_time": 0,
                "transfer_in_time": 0,
                "transfer_out_time": 0,
                "call_in_alerting_time": 0,
                "call_out_alerting_time": 196,
                "max_service_time": 0,
                "hold_count": 0,
                "online_time": 196984,
                "h24": 0,
                "h48": 0,
                "transfer_success_total": 0,
                "transfer_skill_success_total": 0,
                "transfer_fail_total": 0,
                "transfer_total": 0,
                "transfer_success_rate": 0
            }
        ]
    }
}

自定义日期查询：

    字段解释说明：
"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代表自定义日期查询

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

响应：

{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "graph": [
            {
                "agent_id": "a9d61bec32c7ad62c5054b6db2402109",
                "agent_name": "不知道为什么这么样子这么可爱一123qq",
                "agent_num": "1007",
                "call_in_total": 0,
                "call_out_total": 33,
                "call_out_success": 0,
                "call_out_fail": 33,
                "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": 0,
                "call_out_avg_service_time": 0,
                "call_out_waiting_time": 0,
                "busy_time": 310,
                "manual_busy_time": 14,
                "ready_time": 196674,
                "alerting_time": 196,
                "hold_time": 0,
                "consult_time": 0,
                "third_time": 0,
                "service_time": 0,
                "transfer_time": 0,
                "transfer_in_time": 0,
                "transfer_out_time": 0,
                "call_in_alerting_time": 0,
                "call_out_alerting_time": 196,
                "max_service_time": 0,
                "hold_count": 0,
                "online_time": 196984,
                "h24": 0,
                "h48": 0,
                "transfer_success_total": 0,
                "transfer_skill_success_total": 0,
                "transfer_fail_total": 0,
                "transfer_total": 0,
                "transfer_success_rate": 0
            }
        ]
    }
}

其他异常响应：

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

}

文档更新时间: 2024-09-24 15:12   作者：admin