Sign inGet Started

语音指标

Bird 仪表板中的 指标 页面汇总了工作区发起和接收的通话分段:有多少接通、持续多久、如何结束以及去往何处。可用于一段时间内的通话报告。要跟踪某一通具体的通话,请打开通话日志。
一通电话可以包含多个通话分段,例如转接或拨打另一方时建立的连接。这些指标会分别统计每个分段。
每个分段按其开始时间计入,并在结束后被汇总,因此只要仍有通话进行中,最近的时间桶就会持续填充。该页面需要工作区角色同时具备语音和分析的读取权限。

查看指标

打开 Voice > 指标。四个选项卡共用一个时间范围选择器和一行筛选条件:概览、通话质量、号码与路由 和 流量模式。切换选项卡时,范围和筛选条件保持不变。
时间范围选择器提供最近 24 小时或 7、30、90 天,默认为 7 天。按天的范围以本地日历日为分桶单位;24 小时范围是 24 个小时桶的滚动窗口。在时间图表上拖选可将页面上所有卡片缩小到该时段。
四个筛选条件可以组合使用:您的号码(通话分段中您所在的一端)、目的地(分段的目的地国家/地区)、SIP 中继和结果。每个已应用的筛选条件都有可单独移除的标签,大多数卡片也提供控件,可按您正在查看的行应用筛选。

接通率与通话时长

概览 选项卡以五个指标卡片开头。前四个显示与上一个等长时间窗口的变化:
  • 接通率:已接听分段数除以范围内的尝试总数。未接听的尝试仍计入分母,因此路由无法接通或所拨号码无人接听时,ASR 都会下降。其变化以百分点差值表示。
  • 平均通话时长:已接听分段的平均计费时长。不计入未接听分段,因此 ACD 不能说明接通的频率。少数持续很久的分段会使平均值高于中位数;通话质量选项卡的时长分布会显示这种差异。
  • 分段总数和已接听分段:计算 ASR 所用的两个计数。
  • 不同号码数:远端有多少个不同号码,每个号码无论参与多少分段都只计一次。结合分段总数,可以区分流量是分散到多方还是集中在少数几方。

通话量与接通率随时间的变化

趋势图在左轴将已接听分段与其他分段堆叠为该时段的总量,并在右侧 0 至 100% 的轴上用折线显示 ASR。分桶粒度随范围变化:24 小时范围按小时,其余范围按天。结合两者可以区分流量增长和质量下降:堆叠量上升而折线持平,表示流量增加且路由仍能接通;堆叠量持平而折线下降,则表示路由开始无法接通。卡片下方的查看所有分段会打开同一时间窗口的分段日志。

通话如何结束

圆环图和图例按最终结果划分范围内的分段尝试次数,并显示每种结果的数量及其占分段总数的比例:
结果含义
已接听分段已接通
未接听超时,但不代表电话曾响铃
失败被对端或网络拒绝
已拒绝被对端拒接,或被 Bird 拒绝
未知无法确定结果
其他此列表尚未列出的结果
范围内没有分段的结果不会显示。要了解拒绝的原因而不只是频率,请打开具体分段:被拒绝的通话说明了 Bird 为每个分段记录的原因。

主要国家/地区

国家/地区表按分段数量列出前 10 个目的地国家/地区,表格底部显示范围内有活动的国家/地区总数。这里指分段的目的地:出站分段为您拨打的国家/地区,入站分段为您自己的号码所属国家/地区。
按天选择范围时,表格底部还会显示该表覆盖的分段比例,每行也会用条形显示其占比。24 小时范围不显示这两项:明细按完整的本地日历日读取,上方卡片则覆盖滚动的 24 小时,两者的总数衡量不同的范围,计算它们之间的占比会造成误导。需要覆盖率时,请切换到 7 天或更长的范围。
每行包含分段数量、该国家/地区的出站 / 入站划分,以及自身的 ASR。某个国家/地区的 ASR 明显低于页面整体值,通常是仅影响某一目的地的路由问题的首个迹象。如果无法确定方向划分,则显示短横线。

通话质量

通话质量 选项卡包含连接指标和时长分布。某项指标在 Bird 于该范围内有测量值时才显示;缺失则表示 Bird 未测量到任何数据,这与分数差是两回事:
  • 振铃延迟,中位数和第 95 百分位数:主叫从拨号到听到振铃的等待时间。两者相差较大,说明路由通常接通很快,但偶尔会延迟。
  • 音频质量:平均意见分,即对通话听感的标准 1 至 5 分评分,取已测量分段的平均值。正常连接的评分高于 4。低于该值时,请筛选到一个中继或一个目的地,查看下降是否仅发生在某条路由,并检查同一选项卡中的短时分段,因为接通却没有音频的路由会同时影响这两项指标。
  • 短时分段:已接听且持续不足 30 秒的分段,显示为占已接听分段的比例。对于出站流量,该比例上升通常表示路由可以接通但没有音频。
分段持续时长将已接听分段按计费时长划分为六个区间,从不足 30 秒到 10 分钟及以上,并在上方显示平均时长。计费时长指接听后的时间,因此该分布对应您的语音费用。

呼入与呼出流量

号码与路由选项卡将混合视图中难以分辨的两个方向分开显示。卡片统计出站分段和入站分段,以及相较上一时间窗口的变化;旁边的活跃号码和活跃中继统计承载过流量的号码与中继。方向随时间的变化按时间桶堆叠两个方向,因此仅发生在入站流量上的变化也能显示出来,而不会被混合趋势掩盖。
图表下方的表格按您的号码、号码所属国家/地区、SIP 中继或方向细分该时段,并提供可排序的分段数、已接听分段数、ASR 和 ACD 列。您的号码所属国家/地区是分段中您所在的一端,与概览选项卡中的目的地国家/地区是不同的维度。中继行可以帮助您找出质量下降的中继,因此应比较各行的 ASR,而不是只看其中一行。号码和中继标签链接到对应记录,号码汇总则打开可搜索、可分页的视图,列出承载过分段的每个号码。

流量模式

流量模式 选项卡以您的本地时区分析通话到达的时间分布:一周中最繁忙的星期几和小时、按星期几和小时划分的网格图以及按小时的曲线。网格图和小时曲线需要超过一天的范围,且网格图最多显示最近 30 天的数据,因此在 90 天范围下会注明。按星期几汇总的曲线在范围达到 14 天时才出现,低于该值时每个星期几仅有一个观测值。

编程访问

使用 CLI 或 MCP 的统计操作来获取仪表板背后的聚合数据。这些聚合操作尚未发布公开的 HTTP 或 SDK 契约。如需 HTTP 或 SDK 报告,请使用下文描述的公开分段记录来自行计算聚合。
  • CLI。 bird voice stats summary 返回指标卡片显示的时段聚合,bird voice stats daily 和 bird voice stats hourly 返回趋势图背后的时间序列。分项数据包括 by-country、by-trunk、by-number、by-number-country、by-weekday、by-hour-of-day 和 by-response-code,最后一项按最终 SIP 代码对通话分组,未在仪表板中图表化。这些命令接受与页面相同的窗口、时区以及目的地、号码、中继和结果筛选条件,但有一个例外:by-response-code 仅接受窗口、时区和 --direction,且其窗口为日历日而非时刻,因此覆盖的群体比筛选后的页面更广。仅需 bird auth login 授予的只读权限即可调用所有这些操作。参阅 Bird CLI 指南完成安装和身份验证。
  • 智能体。 MCP 服务器 以工具形式暴露相同的统计读取接口。
  • 自定义聚合。 如需自定义报告或数据仓库,GET /v1/voice/legs 返回筛选后的分段记录,分段日志的 CSV 导出涵盖与当前筛选条件匹配的记录。语音事件将通话状态变更发送到您的端点。请将它们与已完成的分段记录进行核对,因为事件可能缺失或乱序到达。
在相同窗口和时区下,CLI 和仪表板的数值一致。仪表板在每次读取时发送你存储的时区;不带 --timezone 的命令按 UTC 分桶。

后续步骤

页面涵盖内容
通话日志这些聚合背后的各个分段,以及某通通话被拒绝的原因
语音事件用于自定义报告的通话事件
发起通话Bird 从 INVITE 读取的内容,以及通话如何计费
故障排查当指标异常变动时,从症状追溯到原因

相关资源

继续查阅此主题的文档、指南和示例。资源为英文。

获取实施简报