Sign inGet Started

WhatsApp 指标

Metrics 页面位于 WhatsApp → Metrics,展示您的 WhatsApp 发送在整个工作区的表现。要查看单条消息,请改用 WhatsApp 日志。您的工作区角色需要同时具有 WhatsApp 读取权限和分析读取权限,才能访问此页面。

Bird 仪表板中的 WhatsApp Metrics 页面:投递率、失败率和接受量摘要卡片位于按时间投递图表上方

查看指标

范围、筛选范围和标签页

  • Outbound / Inbound:Outbound 标签页涵盖您发送的消息。Inbound 标签页统计您的号码接收到的消息,包括总计和按号码统计。
  • 范围:过去 24 小时、7 天、30 天(默认)或 90 天。您也可以在图表上拖动以放大查看。
  • 筛选范围:仅在 Outbound 标签页中,可将页面缩小到单个号码、模板、模板类别或标签,每次只能选择其中一项。页面中有两部分不受筛选范围影响,始终涵盖整个工作区:错误代码列表和 Breakdowns 面板。

消息按 Bird 接受它们的时段计入,因此今天到达的投递回执会更新昨天的数据。在所有回执到达之前,最近几小时显示的投递量可能偏低。

摘要卡片

卡片含义健康条件
投递率已投递消息占已接受消息的比例高于 90%
失败率失败消息占已接受消息的比例低于 5%
已接受Bird 已接受的消息数,以及其中到达 WhatsApp 的数量不评级

卡片超出健康范围时显示 Needs attention。查看失败原因了解具体情况。

按时间的投递情况

图表按小时(24 小时范围)或按天(更长范围)绘制已接受、已投递和失败的消息量。可用它发现峰值,例如某次营销活动发出后或某个模板开始被拒绝时。

失败原因

失败率图表跟踪整个范围内的失败率。图表下方,失败按错误代码分组,最常见的排在前面。列表最多显示该范围内出现过的 50 个代码,因此在较长的列表中,少见的代码可能不会显示。即使您为页面设置了筛选范围,错误代码也始终涵盖整个工作区。最后一行 Rejected 统计 Bird 在接受之前就拒绝的消息。这些消息不计入失败率,因此该行只显示数量,不显示占比。

延迟

延迟表格显示三个阶段的 p50、p95 和 p99 耗时:

  • 处理:从 Bird 接受消息到将其提交给 WhatsApp。
  • 投递:从提交给 WhatsApp 到 WhatsApp 确认消息已投递至收件人设备。
  • 总计:两个阶段合计。

投递阶段偏慢通常表示收件人手机处于离线状态,这是 Bird 无法控制的。处理阶段偏慢则值得排查。如果 p50 正常但 p99 偏慢,原因通常是某个模板或目的地。

细分

Breakdowns 面板按号码、模板、模板类别、标签或国家/地区拆分已接受、已投递和失败的消息。每行使用与摘要卡片相同的阈值标记为 Healthy 或 Needs attention。每个标签页列出该范围内排名前 50 的行。

标签是您在发送时设置的标签。带有多个标签的消息会出现在每个标签对应的行中。无法识别国家/地区的收件人归入 ZZ,群组发送不包含在国家/地区标签页中。

Bird 仪表板中 WhatsApp Metrics 页面的下半部分:投递延迟表格显示处理、投递和总计的 p50/p95/p99 及迷你折线图,下方是 Breakdowns 面板,按号码、模板、模板类别、标签和国家/地区分组展示投递情况

以编程方式访问

相同的数据也可通过 API、SDK(bird.whatsapp.stats)、CLI(bird whatsapp stats)以及 MCP 服务器获取。从以下端点开始:

每个参考页面都列出了可接受的时间范围、过滤器和响应字段。

后续步骤