调用ListHistoricalAgentReport获取坐席历史数据报表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListHistoricalAgentReport

系统规定参数。取值:ListHistoricalAgentReport。

InstanceId String ccc-test

呼叫中心实例ID。

PageNumber Integer 1

分页序号,范围1-100。

PageSize Integer 100

分页大小,范围1-100。

AgentIdList String ["user-test@ccc-test", "user-test2@ccc-test"]

坐席ID列表。

StartTime Long 1532448000000

获取的历史数据的起始时间,默认为当天的0时,最早为当前时间往前180天。统计的时间精度为小时,向前取整,闭区间。

StopTime Long 1532707199000

获取的历史数据的终止时间,默认为当前时间。统计的时间精度为小时,向后取整,开区间。例如:开始时间为 11:12:20,结束时间为 11:45:50,则对齐后的入参时间范围为

11:00:00, 12:00:00) ,即大于等于11点,小于12点。

返回数据

名称 类型 示例值 描述
Code String OK

响应码。

Data Struct

数据。

List Array of Items

坐席报表列表。

AgentId String user-test@ccc-test

座席ID,等同于userId。

AgentName String 云呼测试坐席

坐席姓名。

Inbound Struct

呼入指标。

AverageHoldTime Float 0

平均通话保持时长,单位秒。计算公式为:TotalHoldTime/CallsHold。

AverageRingTime Float 0

平均振铃时长,单位秒。计算公式为: TotalRingTime/CallsRinged。

AverageTalkTime Float 0

平均通话时长,单位秒。计算公式为:TotalTalkTime/CallsHandled。

AverageWorkTime Float 0

平均话后处理时长,单位秒。计算公式为:TotalWorkTime/CallsHandled。

CallsAttendedTransferIn Long 0

咨询转入量。若一通电话多次转入给该坐席,每次转入算一次。

CallsAttendedTransferOut Long 0

咨询转出量。若一通电话多次转出给其他坐席,每次转出算一次。

CallsBlindTransferIn Long 0

直接转入量。若一通电话多次转入给该坐席,每次转入算一次。

CallsBlindTransferOut Long 0

直接转出量。若一通电话多次转出给其他坐席,每次转出算一次。

CallsHandled Long 0

应答量,即坐席应答的次数。

CallsHold Long 0

保持量,即发生通话保持的次数。

CallsOffered Long 0

分配量,即分配给此坐席的电话次数, 包括其他坐席盲转和咨询转给此坐席的电话。

CallsRinged Long 0

坐席振铃的电话数量。

HandleRate Float 0

应答率。计算公式为:CallsHandled / CallsOffered(由于应答事件与分配事件可能落在不同的时间范围内,所以某些情况下结果可能大于100%)。

MaxHoldTime Long 0

最大通话保持时长,单位秒。

MaxRingTime Long 0

最大振铃时长,单位秒。

MaxTalkTime Long 0

最大通话时长,单位秒。

MaxWorkTime Long 0

最大话后处理时长,单位秒。

SatisfactionIndex Float 0

满意度指数,即满意度按键数字(1位数字)的平均值。

SatisfactionRate Float 0

满意率,计算公式为:标记为满意的评价数/满意度调查响应次数。

SatisfactionSurveysOffered Long 0

满意度调查发送次数。

SatisfactionSurveysResponded Long 0

满意度调查响应次数。

TotalHoldTime Long 0

总通话保持时长,单位秒。

TotalRingTime Long 0

总振铃时长,单位秒。

TotalTalkTime Long 0

总通话时长,单位秒。

TotalWorkTime Long 0

总话后处理时长,单位秒。

Outbound Struct

呼出指标。

AnswerRate Float 0

接通率,计算公式为:CallsAnswered/CallsDialed(由于接听事件与应答事件可能落在不同的时间范围内,所以某些情况下结果可能大于100%)。

AverageDialingTime Float 0

平均拨号时长,单位秒。计算公式为:TotalDialingTime/CallsDialed。

AverageHoldTime Float 0

平均通话保持时长,单位秒。计算公式为:TotalHoldTime/CallsHold。

AverageRingTime Float 0

平均振铃时长,单位秒。计算公式为: TotalRingTime/CallsRinged。

AverageTalkTime Float 0

平均通话时长,单位秒。计算公式为:TotalTalkTime/CallsAnswered。

AverageWorkTime Float 0

平均话后处理时长,单位秒。计算公式为:TotalWorkTime/CallsDialed。

CallsAnswered Long 0

接通量。

CallsAttendedTransferIn Long 0

咨询转入量。若一通电话多次转入给该坐席,每次转入算一次。

CallsAttendedTransferOut Long 0

咨询转出量。若一通电话多次转出给其他坐席,每次转出算一次。

CallsBlindTransferIn Long 0

直接转入量。若一通电话多次转入给该坐席,每次转入算一次。

CallsBlindTransferOut Long 0

直接转出量。若一通电话多次转出给其他坐席,每次转出算一次。

CallsDialed Long 0

拨号量。

CallsHold Long 0

保持量,即发生通话保持的次数。

CallsRinged Long 0

坐席振铃的电话数量。

MaxDialingTime Long 0

最大拨号时长,单位秒。

MaxHoldTime Long 0

最大通话保持时长,单位秒。

MaxRingTime Long 0

最大振铃时长,单位秒。

MaxTalkTime Long 0

最大通话时长,单位秒。

MaxWorkTime Long 0

最大话后处理时长,单位秒。

SatisfactionIndex Float 0

满意度指数,即满意度按键数字(1位数字)的平均值。

SatisfactionRate Float 0

满意率,计算公式为:标记为满意的评价数/满意度调查响应次数。

SatisfactionSurveysOffered Long 0

满意度调查发送次数。

SatisfactionSurveysResponded Long 0

满意度调查响应次数。

TotalDialingTime Long 0

总拨号时长,单位秒。

TotalHoldTime Long 0

总通话保持时长,单位秒。

TotalRingTime Long 0

总振铃时长,单位秒。

TotalTalkTime Long 0

总通话时长,单位秒。

TotalWorkTime Long 0

总话后处理时长,单位秒。

Overall Struct

整体指标。

AverageBreakTime Float 0

平均小休时长,单位秒。计算公式为:TotalBreakTime/小休次数。小休次数为非接口统计字段。

AverageHoldTime Float 0

平均通话保持时长,单位秒。计算公式为:TotalHoldTime/(呼入CallsHold+呼出CallsHold)。

AverageReadyTime Float 0

平均就绪时长,单位秒。计算公式为:TotalReadyTime/就绪次数。就绪次数为非接口统计字段。

AverageTalkTime Float 0

平均通话时长,单位秒。计算公式为: TotalTalkTime/(CallsAnswered+CallsHandled)。

AverageWorkTime Float 0

平均话后处理时长,单位秒。计算公式为:TotalWorkTime/TotalCalls。

MaxBreakTime Long 0

最大小休时长,单位秒。

MaxHoldTime Long 0

最大通话保持时长,单位秒。

MaxReadyTime Long 0

最大就绪时长,单位秒。

MaxTalkTime Long 0

最大通话时长,单位秒。

MaxWorkTime Long 0

最大话后处理时长,单位秒。

OccupancyRate Float 0

座席利用率,计算公式为: (TotalworkTime + TotalTalkTime ) / TotalLoggedInTime。

SatisfactionIndex Float 0

满意度指数,即满意度按键数字(1位数字)的平均值。

SatisfactionRate Float 0

满意率,计算公式为:标记为满意的评价数/满意度调查响应次数。

SatisfactionSurveysOffered Long 0

满意度调查发送次数。

SatisfactionSurveysResponded Long 0

满意度调查响应次数。

TotalBreakTime Long 0

总小休时长,单位秒。

TotalCalls Long 0

总电话量。计算公式为:CallsOffered

  • CallsDialed。
TotalHoldTime Long 0

总保持时长,单位秒。

TotalLoggedInTime Long 0

总登录时长,单位秒。不包含小休时长。

TotalReadyTime Long 0

总就绪时长,单位为秒。

TotalTalkTime Long 0

总通话时长,单位秒。

TotalWorkTime Long 0

总话后处理时长,单位秒。

PageNumber Integer 1

分页序号。

PageSize Integer 100

分页大小。

TotalCount Integer 10

总条目数。

HttpStatusCode Integer 200

HTTP状态码。

Message String

响应信息。

RequestId String EEEE671A-3E24-4A04-81E6-6C4F5B39DF75

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ListHistoricalAgentReport
&AgentIdList=["ccc-user@ccc-test", "ccc-user2@ccc-test"]
&InstanceId=ccc-test
&PageNumber=1
&PageSize=100
&<公共请求参数>

正常返回示例

XML格式

<RequestId>EEEE671A-3E24-4A04-81E6-6C4F5B39DF75</RequestId>
<Message>无</Message>
<HttpStatusCode>200</HttpStatusCode>
<Data>
    <TotalCount>10</TotalCount>
    <PageSize>100</PageSize>
    <PageNumber>1</PageNumber>
    <List>
        <AgentName>云呼测试坐席</AgentName>
        <AgentId>user-test@ccc-test</AgentId>
        <Inbound>
            <TotalWorkTime>0</TotalWorkTime>
            <TotalHoldTime>0</TotalHoldTime>
            <CallsRinged>0</CallsRinged>
            <SatisfactionSurveysOffered>0</SatisfactionSurveysOffered>
            <AverageHoldTime>0</AverageHoldTime>
            <MaxRingTime>0</MaxRingTime>
            <CallsOffered>0</CallsOffered>
            <SatisfactionIndex>0</SatisfactionIndex>
            <CallsHold>0</CallsHold>
            <CallsHandled>0</CallsHandled>
            <TotalRingTime>0</TotalRingTime>
            <SatisfactionSurveysResponded>0</SatisfactionSurveysResponded>
            <HandleRate>0</HandleRate>
            <CallsAttendedTransferIn>0</CallsAttendedTransferIn>
            <TotalTalkTime>0</TotalTalkTime>
            <AverageRingTime>0</AverageRingTime>
            <MaxTalkTime>0</MaxTalkTime>
            <SatisfactionRate>0</SatisfactionRate>
            <CallsBlindTransferOut>0</CallsBlindTransferOut>
            <AverageWorkTime>0</AverageWorkTime>
            <CallsAttendedTransferOut>0</CallsAttendedTransferOut>
            <MaxWorkTime>0</MaxWorkTime>
            <CallsBlindTransferIn>0</CallsBlindTransferIn>
            <MaxHoldTime>0</MaxHoldTime>
            <AverageTalkTime>0</AverageTalkTime>
        </Inbound>
        <Outbound>
            <TotalDialingTime>0</TotalDialingTime>
            <TotalWorkTime>0</TotalWorkTime>
            <TotalHoldTime>0</TotalHoldTime>
            <CallsRinged>0</CallsRinged>
            <AverageHoldTime>0</AverageHoldTime>
            <MaxRingTime>0</MaxRingTime>
            <SatisfactionIndex>0</SatisfactionIndex>
            <CallsHold>0</CallsHold>
            <TotalRingTime>0</TotalRingTime>
            <AverageDialingTime>0</AverageDialingTime>
            <CallsAnswered>0</CallsAnswered>
            <TotalTalkTime>0</TotalTalkTime>
            <CallsDialed>0</CallsDialed>
            <MaxDialingTime>0</MaxDialingTime>
            <MaxTalkTime>0</MaxTalkTime>
            <SatisfactionRate>0</SatisfactionRate>
            <CallsAttendedTransferOut>0</CallsAttendedTransferOut>
            <MaxHoldTime>0</MaxHoldTime>
            <AverageTalkTime>0</AverageTalkTime>
            <AnswerRate>0</AnswerRate>
            <SatisfactionSurveysOffered>0</SatisfactionSurveysOffered>
            <SatisfactionSurveysResponded>0</SatisfactionSurveysResponded>
            <CallsAttendedTransferIn>0</CallsAttendedTransferIn>
            <AverageRingTime>0</AverageRingTime>
            <CallsBlindTransferOut>0</CallsBlindTransferOut>
            <AverageWorkTime>0</AverageWorkTime>
            <MaxWorkTime>0</MaxWorkTime>
            <CallsBlindTransferIn>0</CallsBlindTransferIn>
        </Outbound>
        <Overall>
            <TotalReadyTime>0</TotalReadyTime>
            <TotalCalls>0</TotalCalls>
            <TotalBreakTime>0</TotalBreakTime>
            <TotalWorkTime>0</TotalWorkTime>
            <TotalHoldTime>0</TotalHoldTime>
            <SatisfactionSurveysOffered>0</SatisfactionSurveysOffered>
            <AverageHoldTime>0</AverageHoldTime>
            <SatisfactionIndex>0</SatisfactionIndex>
            <AverageBreakTime>0</AverageBreakTime>
            <SatisfactionSurveysResponded>0</SatisfactionSurveysResponded>
            <TotalTalkTime>0</TotalTalkTime>
            <AverageReadyTime>0</AverageReadyTime>
            <TotalLoggedInTime>0</TotalLoggedInTime>
            <MaxTalkTime>0</MaxTalkTime>
            <SatisfactionRate>0</SatisfactionRate>
            <MaxReadyTime>0</MaxReadyTime>
            <AverageWorkTime>0</AverageWorkTime>
            <MaxWorkTime>0</MaxWorkTime>
            <MaxBreakTime>0</MaxBreakTime>
            <OccupancyRate>0</OccupancyRate>
            <MaxHoldTime>0</MaxHoldTime>
            <AverageTalkTime>0</AverageTalkTime>
        </Overall>
    </List>
</Data>
<Code>OK</Code>

JSON格式

{
    "RequestId": "EEEE671A-3E24-4A04-81E6-6C4F5B39DF75",
    "Message": "无",
    "HttpStatusCode": "200",
    "Data": {
        "TotalCount": "10",
        "PageSize": "100",
        "PageNumber": "1",
        "List": [
            {
                "AgentName": "云呼测试坐席",
                "AgentId": "user-test@ccc-test",
                "Inbound": {
                    "TotalWorkTime": "0",
                    "TotalHoldTime": "0",
                    "CallsRinged": "0",
                    "SatisfactionSurveysOffered": "0",
                    "AverageHoldTime": "0",
                    "MaxRingTime": "0",
                    "CallsOffered": "0",
                    "SatisfactionIndex": "0",
                    "CallsHold": "0",
                    "CallsHandled": "0",
                    "TotalRingTime": "0",
                    "SatisfactionSurveysResponded": "0",
                    "HandleRate": "0",
                    "CallsAttendedTransferIn": "0",
                    "TotalTalkTime": "0",
                    "AverageRingTime": "0",
                    "MaxTalkTime": "0",
                    "SatisfactionRate": "0",
                    "CallsBlindTransferOut": "0",
                    "AverageWorkTime": "0",
                    "CallsAttendedTransferOut": "0",
                    "MaxWorkTime": "0",
                    "CallsBlindTransferIn": "0",
                    "MaxHoldTime": "0",
                    "AverageTalkTime": "0"
                },
                "Outbound": {
                    "TotalDialingTime": "0",
                    "TotalWorkTime": "0",
                    "TotalHoldTime": "0",
                    "CallsRinged": "0",
                    "AverageHoldTime": "0",
                    "MaxRingTime": "0",
                    "SatisfactionIndex": "0",
                    "CallsHold": "0",
                    "TotalRingTime": "0",
                    "AverageDialingTime": "0",
                    "CallsAnswered": "0",
                    "TotalTalkTime": "0",
                    "CallsDialed": "0",
                    "MaxDialingTime": "0",
                    "MaxTalkTime": "0",
                    "SatisfactionRate": "0",
                    "CallsAttendedTransferOut": "0",
                    "MaxHoldTime": "0",
                    "AverageTalkTime": "0",
                    "AnswerRate": "0",
                    "SatisfactionSurveysOffered": "0",
                    "SatisfactionSurveysResponded": "0",
                    "CallsAttendedTransferIn": "0",
                    "AverageRingTime": "0",
                    "CallsBlindTransferOut": "0",
                    "AverageWorkTime": "0",
                    "MaxWorkTime": "0",
                    "CallsBlindTransferIn": "0"
                },
                "Overall": {
                    "TotalReadyTime": "0",
                    "TotalCalls": "0",
                    "TotalBreakTime": "0",
                    "TotalWorkTime": "0",
                    "TotalHoldTime": "0",
                    "SatisfactionSurveysOffered": "0",
                    "AverageHoldTime": "0",
                    "SatisfactionIndex": "0",
                    "AverageBreakTime": "0",
                    "SatisfactionSurveysResponded": "0",
                    "TotalTalkTime": "0",
                    "AverageReadyTime": "0",
                    "TotalLoggedInTime": "0",
                    "MaxTalkTime": "0",
                    "SatisfactionRate": "0",
                    "MaxReadyTime": "0",
                    "AverageWorkTime": "0",
                    "MaxWorkTime": "0",
                    "MaxBreakTime": "0",
                    "OccupancyRate": "0",
                    "MaxHoldTime": "0",
                    "AverageTalkTime": "0"
                }
            }
        ]
    },
    "Code": "OK"
}

错误码

HttpCode 错误码 错误信息 描述
400 Parameter.Blank The parameter %s may not be null or blank. 该参数不能为null或含有空白符的字符串。

访问错误中心查看更多错误码。