Sign inGet started

SMS 日志

SMS 日志显示在 Messages 页面,是工作区的消息记录。出站发送和入站回复按时间倒序排列。使用它可以确认发送状态、跟踪投递生命周期,并查看分段数、费用和运营商详情。汇总的 Metrics 页面显示消息整体比率;SMS 日志则用于检查单条消息。该页面还包含 Send SMS,用于在控制台中一次性发送。
Bird 控制台中的 SMS Messages 页面:Messages 标题上方的 "Free-form SMS is in preview" 横幅、Send SMS 按钮、带有 Filters、Status 和 Date 控件的精确收件人搜索框,以及工作区尚未发送消息时消息表格位置显示的空状态插图

消息列表

每行代表一条消息。各列如下:
列名显示内容
Status消息的当前投递状态(参见状态
From发送方:消息发送所用的号码、发送者 ID 或短号码
To收件人号码
Message消息正文的开头部分(点击该列或行中任意位置可打开消息)
Category消息类别,以简短标签显示(TXNMKTGAUTHSVC
Sent发送被接受的时间,以相对时间显示(悬停可查看精确时间戳)
列表分页显示,每页 25 条消息;使用 PrevNext 在页面间切换。

搜索和筛选

消息日志增长很快,因此页面顶部提供了收件人搜索和四个筛选器。它们可以组合使用:状态筛选加日期范围会将结果缩小到同时满足两个条件的消息。
按收件人搜索。 搜索框匹配 E.164 格式的精确收件人号码。输入完整号码(例如 +31612345678)即可找到发送给该号码的所有消息。搜索不支持子字符串匹配。
状态。 按一个或多个投递状态筛选。状态支持多选,例如可以同时选择 UndeliveredFailedExpired 来显示所有未送达的消息。可选项即状态中列出的各状态。
类别。 按消息类别筛选:TransactionalMarketingAuthenticationService
方向。OutboundInbound 筛选。对您号码的回复与您的发送记录存储在一起,因此 Inbound 显示的是您收到的消息。
日期。 按消息发送时间筛选;选择预设范围或从日历中自定义范围。
当筛选条件组合无匹配结果时,页面会显示无结果状态,并提供 Clear filters 操作以重置回完整列表。

状态

消息的状态表示它在投递生命周期中的当前位置。消息从 accepted 开始,逐步走向最终回执。
状态含义
AcceptedBird 已接收该消息,正在准备将其移交给运营商
Sent已移交给运营商;等待投递回执
Delivered运营商确认已投递到终端设备
Undelivered非永久性未送达:终端设备关机、不可达或内容被拦截
Failed永久性失败;消息无法投递
Rejected消息被拒绝(策略检查未通过、扣费失败或运营商拒收)
Expired运营商停止尝试并将消息报告为过期
Received入站消息
状态标签标识消息是在途中、已投递、已接收还是未成功。扫描结果时不要仅依赖颜色来判断。

检查消息

点击任意行可在侧面板中打开消息。面板有两个标签页:EventsDetails,顶部显示消息正文、当前状态、收件人和类别。当消息仍在途中时,面板每隔几秒自动刷新,状态变更或投递回执无需手动重新加载即可显示。

Events

默认标签页是单条消息的带时间戳的时间线。它呈现 SMS 事件中描述的事件流:Accepted,然后 Sent,然后 Delivered,或失败事件(UndeliveredFailedRejectedExpired)。投递事件会标识运营商和 MCC/MNC(移动网络)。失败事件显示错误描述;Details 标签页包含错误代码。

Details

Details 标签页显示消息的元数据:
  • Message IDDirectionFromToCategory
  • Segments:计费分段数、编码方式(GSM_7BITUCS2)以及字符数(参见分段与编码
  • Cost:金额和币种,在消息定价完成后显示
  • CarrierMCC/MNC:投递网络(已知时显示)
  • SentHanded to carrierDelivered 时间戳
  • Error:未送达消息的错误描述和错误代码
  • 您在发送时设置的任何 TagsMetadata
大多数字段可以一键复制。
公开的消息和事件读取覆盖最近 30 天。更早的消息 ID 超出该读取窗口;请根据您自己的数据保留和合规策略保存应用程序所需的记录。

通过 API 访问相同日志

该页面背后的列表即 GET /v1/sms/messages,其筛选条件涵盖状态、类别、标签、精确收件人和时间窗口。使用 GET /v1/sms/messages/{message_id}/events 检索消息的时间线。使用 GET /v1/sms/messages/{message_id} 读取最新状态,或实时消费 webhook 事件

后续步骤

查看 SMS 分析了解更广泛的报告工作流,以及双向 SMS了解如何处理入站消息。
  • SMS 指标:监控整体投递率、失败率和接受量。
  • SMS 事件:了解时间线背后的事件词汇。
  • 发送 SMS:构建包含类别、标签和元数据的发送载荷。

相关资源

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

获取实施简报