获取呼叫统计数据

查询呼入机器人呼叫量、接通率、转人工率等统计指标。startTime/endTime 为空时默认查询最近 7 天；同一天返回小时粒度，多天返回天粒度；最大查询跨度由系统配置控制，默认 3 个月。

请求参数

名称	类型	必填	描述
startTime	int64	否	查询开始时间，毫秒时间戳；为空时默认最近 7 天开始时间
endTime	int64	否	查询结束时间，毫秒时间戳；为空时默认当天结束时间
robotIdList	int64[]	否	机器人 ID 列表；为空时查询租户下全部机器人

返回参数

名称	类型	描述	示例值
requestId	string	请求追踪 ID，排查问题时提供	9d4ea6bef22248e3bfff9da3f89e33be
code	int32	业务状态码，200 表示业务成功	200
message	string	响应消息；业务失败时为失败原因	success
data	object	呼叫统计汇总数据
└dailyMetrics	object[]	按天统计列表；多天查询时返回
└hour	int32	小时，0-23；小时粒度数据返回	10
└date	date	统计日期	2026-06-23
└totalIncomingCalls	int32	总呼入量，包含接通和未接通；统计周期内所有呼入请求的总数	120
└connectedCalls	int32	已接通通话量，机器人接通量	98
└unansweredCalls	int32	未接通量，只展示繁忙未接通量	22
└effectiveCalls	int32	有效通话量，通话时长超过阈值的通话数量	80
└queueCalls	int32	排队通话量	10
└transferredToAgent	int32	转人工服务量，所有转接到人工坐席的通话数量	20
└nodeTransferredToAgent	int32	节点转人工服务量，节点中进行转人工的通话数量	15
└busyTransferredToAgent	int32	繁忙转人工服务量	5
└directTransferToAgent	int32	直接转人工量，通话时长不足阈值即转人工的通话数量	4
└botResolvedCalls	int32	机器人解决量，通话时长超过阈值且未转人工的通话数量	60
└totalCallDuration	int64	累计通话时长，单位秒；仅统计机器人服务阶段，不含人工服务时长	3600
└averageCallDuration	int64	平均通话时长，单位秒；计算公式：累计通话时长 / 已接通通话量	36
└totalQueueDuration	int64	累计排队时长，单位秒；用户在机器人服务阶段的等待总时长	180
└averageQueueDuration	int64	平均排队时长，单位秒；计算公式：累计排队时长 / 出现排队的通话量	18
└connectionRate	number	接通率，0-1 表示；计算公式：已接通通话量 / 总呼入量	0.8167
└effectiveCallRate	number	有效通话率，0-1 表示；计算公式：有效通话量 / 已接通通话量	0.8163
└botResolutionRate	number	机器人解决率，0-1 表示；计算公式：机器人解决量 / 已接通通话量	0.6122
└transferToAgentRate	number	转人工率，0-1 表示；计算公式：节点转人工服务量 / 已接通通话量	0.1531
└directTransferToAgentRate	number	直接转人工率，0-1 表示；计算公式：直接转人工量 / 已接通通话量	0.0408
└hourlyMetrics	object[]	按小时统计列表；同一天查询时返回
└hour	int32	小时，0-23；小时粒度数据返回	10
└date	date	统计日期	2026-06-23
└totalIncomingCalls	int32	总呼入量，包含接通和未接通；统计周期内所有呼入请求的总数	120
└connectedCalls	int32	已接通通话量，机器人接通量	98
└unansweredCalls	int32	未接通量，只展示繁忙未接通量	22
└effectiveCalls	int32	有效通话量，通话时长超过阈值的通话数量	80
└queueCalls	int32	排队通话量	10
└transferredToAgent	int32	转人工服务量，所有转接到人工坐席的通话数量	20
└nodeTransferredToAgent	int32	节点转人工服务量，节点中进行转人工的通话数量	15
└busyTransferredToAgent	int32	繁忙转人工服务量	5
└directTransferToAgent	int32	直接转人工量，通话时长不足阈值即转人工的通话数量	4
└botResolvedCalls	int32	机器人解决量，通话时长超过阈值且未转人工的通话数量	60
└totalCallDuration	int64	累计通话时长，单位秒；仅统计机器人服务阶段，不含人工服务时长	3600
└averageCallDuration	int64	平均通话时长，单位秒；计算公式：累计通话时长 / 已接通通话量	36
└totalQueueDuration	int64	累计排队时长，单位秒；用户在机器人服务阶段的等待总时长	180
└averageQueueDuration	int64	平均排队时长，单位秒；计算公式：累计排队时长 / 出现排队的通话量	18
└connectionRate	number	接通率，0-1 表示；计算公式：已接通通话量 / 总呼入量	0.8167
└effectiveCallRate	number	有效通话率，0-1 表示；计算公式：有效通话量 / 已接通通话量	0.8163
└botResolutionRate	number	机器人解决率，0-1 表示；计算公式：机器人解决量 / 已接通通话量	0.6122
└transferToAgentRate	number	转人工率，0-1 表示；计算公式：节点转人工服务量 / 已接通通话量	0.1531
└directTransferToAgentRate	number	直接转人工率，0-1 表示；计算公式：直接转人工量 / 已接通通话量	0.0408
└totalIncomingCalls	int32	总呼入量，包含接通和未接通；统计周期内所有呼入请求的总数	120
└connectedCalls	int32	已接通通话量，机器人接通量	98
└unansweredCalls	int32	未接通量，只展示繁忙未接通量	22
└effectiveCalls	int32	有效通话量，通话时长超过阈值的通话数量	80
└queueCalls	int32	排队通话量	10
└transferredToAgent	int32	转人工服务量，所有转接到人工坐席的通话数量	20
└nodeTransferredToAgent	int32	节点转人工服务量，节点中进行转人工的通话数量	15
└busyTransferredToAgent	int32	繁忙转人工服务量	5
└directTransferToAgent	int32	直接转人工量，通话时长不足阈值即转人工的通话数量	4
└botResolvedCalls	int32	机器人解决量，通话时长超过阈值且未转人工的通话数量	60
└totalCallDuration	int64	累计通话时长，单位秒；仅统计机器人服务阶段，不含人工服务时长	3600
└averageCallDuration	int64	平均通话时长，单位秒；计算公式：累计通话时长 / 已接通通话量	36
└totalQueueDuration	int64	累计排队时长，单位秒；用户在机器人服务阶段的等待总时长	180
└averageQueueDuration	int64	平均排队时长，单位秒；计算公式：累计排队时长 / 出现排队的通话量	18
└connectionRate	float	接通率，0-1 表示；计算公式：已接通通话量 / 总呼入量	0.8167
└effectiveCallRate	float	有效通话率，0-1 表示；计算公式：有效通话量 / 已接通通话量	0.8163
└botResolutionRate	float	机器人解决率，0-1 表示；计算公式：机器人解决量 / 已接通通话量	0.6122
└transferToAgentRate	float	转人工率，0-1 表示；计算公式：节点转人工服务量 / 已接通通话量	0.1531
└directTransferToAgentRate	float	直接转人工率，0-1 表示；计算公式：直接转人工量 / 已接通通话量	0.0408

错误码

状态码	描述
90001	租户未开通或 API Key 无效
90002	签名校验错误
90003	请求头中时间戳错误
90005	参数错误，例如时间间隔超过限制

getEndpoint

/open/api/deepvox/statistics/getCallMetrics

curl -X GET "https://b.163.com/open/api/deepvox/statistics/getCallMetrics?startTime=1750176000000&endTime=1750780799999&robotIdList=10001%2C10002"

{
  "requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
  "code": 200,
  "message": "success",
  "data": {
    "dailyMetrics": [
      {
        "hour": 10,
        "date": "2026-06-23",
        "totalIncomingCalls": 120,
        "connectedCalls": 98,
        "unansweredCalls": 22,
        "effectiveCalls": 80,
        "queueCalls": 10,
        "transferredToAgent": 20,
        "nodeTransferredToAgent": 15,
        "busyTransferredToAgent": 5,
        "directTransferToAgent": 4,
        "botResolvedCalls": 60,
        "totalCallDuration": 3600,
        "averageCallDuration": 36,
        "totalQueueDuration": 180,
        "averageQueueDuration": 18,
        "connectionRate": 0.8167,
        "effectiveCallRate": 0.8163,
        "botResolutionRate": 0.6122,
        "transferToAgentRate": 0.1531,
        "directTransferToAgentRate": 0.0408
      }
    ],
    "hourlyMetrics": [
      {
        "hour": 10,
        "date": "2026-06-23",
        "totalIncomingCalls": 120,
        "connectedCalls": 98,
        "unansweredCalls": 22,
        "effectiveCalls": 80,
        "queueCalls": 10,
        "transferredToAgent": 20,
        "nodeTransferredToAgent": 15,
        "busyTransferredToAgent": 5,
        "directTransferToAgent": 4,
        "botResolvedCalls": 60,
        "totalCallDuration": 3600,
        "averageCallDuration": 36,
        "totalQueueDuration": 180,
        "averageQueueDuration": 18,
        "connectionRate": 0.8167,
        "effectiveCallRate": 0.8163,
        "botResolutionRate": 0.6122,
        "transferToAgentRate": 0.1531,
        "directTransferToAgentRate": 0.0408
      }
    ],
    "totalIncomingCalls": 120,
    "connectedCalls": 98,
    "unansweredCalls": 22,
    "effectiveCalls": 80,
    "queueCalls": 10,
    "transferredToAgent": 20,
    "nodeTransferredToAgent": 15,
    "busyTransferredToAgent": 5,
    "directTransferToAgent": 4,
    "botResolvedCalls": 60,
    "totalCallDuration": 3600,
    "averageCallDuration": 36,
    "totalQueueDuration": 180,
    "averageQueueDuration": 18,
    "connectionRate": 0.8167,
    "effectiveCallRate": 0.8163,
    "botResolutionRate": 0.6122,
    "transferToAgentRate": 0.1531,
    "directTransferToAgentRate": 0.0408
  }
}

{
  "requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
  "code": 200,
  "message": "success"
}

{
  "requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
  "code": 200,
  "message": "success"
}

{
  "requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
  "code": 200,
  "message": "success"
}

{
  "requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
  "code": 200,
  "message": "success"
}