SMS 日志
SMS 日志显示在 Messages 页面,是工作区的消息记录。出站发送和入站回复按时间倒序排列。使用它可以确认发送状态、跟踪投递生命周期,并查看分段数、费用和运营商详情。汇总的 Metrics 页面显示消息整体比率;SMS 日志则用于检查单条消息。该页面还包含 Send SMS,用于在控制台中一次性发送。

消息列表
每行代表一条消息。各列如下:
| 列名 | 显示内容 |
|---|---|
| Status | 消息的当前投递状态(参见状态) |
| From | 发送方:消息发送所用的号码、发送者 ID 或短号码 |
| To | 收件人号码 |
| Message | 消息正文的开头部分(点击该列或行中任意位置可打开消息) |
| Category | 消息类别,以简短标签显示(TXN、MKTG、AUTH、SVC) |
| Sent | 发送被接受的时间,以相对时间显示(悬停可查看精确时间戳) |
列表分页显示,每页 25 条消息;使用 Prev 和 Next 在页面间切换。
搜索和筛选
消息日志增长很快,因此页面顶部提供了收件人搜索和四个筛选器。它们可以组合使用:状态筛选加日期范围会将结果缩小到同时满足两个条件的消息。
按收件人搜索。 搜索框匹配 E.164 格式的精确收件人号码。输入完整号码(例如 +31612345678)即可找到发送给该号码的所有消息。搜索不支持子字符串匹配。
类别。 按消息类别筛选:Transactional、Marketing、Authentication 或 Service。
方向。 按 Outbound 或 Inbound 筛选。对您号码的回复与您的发送记录存储在一起,因此 Inbound 显示的是您收到的消息。
日期。 按消息发送时间筛选;选择预设范围或从日历中自定义范围。
当筛选条件组合无匹配结果时,页面会显示无结果状态,并提供 Clear filters 操作以重置回完整列表。
状态
消息的状态表示它在投递生命周期中的当前位置。消息从 accepted 开始,逐步走向最终回执。
| 状态 | 含义 |
|---|---|
| Accepted | Bird 已接收该消息,正在准备将其移交给运营商 |
| Sent | 已移交给运营商;等待投递回执 |
| Delivered | 运营商确认已投递到终端设备 |
| Undelivered | 非永久性未送达:终端设备关机、不可达或内容被拦截 |
| Failed | 永久性失败;消息无法投递 |
| Rejected | 消息被拒绝(策略检查未通过、扣费失败或运营商拒收) |
| Expired | 运营商停止尝试并将消息报告为过期 |
| Received | 入站消息 |
状态标签标识消息是在途中、已投递、已接收还是未成功。扫描结果时不要仅依赖颜色来判断。
检查消息
点击任意行可在侧面板中打开消息。面板有两个标签页:Events 和 Details,顶部显示消息正文、当前状态、收件人和类别。当消息仍在途中时,面板每隔几秒自动刷新,状态变更或投递回执无需手动重新加载即可显示。
Events
默认标签页是单条消息的带时间戳的时间线。它呈现 SMS 事件中描述的事件流:Accepted,然后 Sent,然后 Delivered,或失败事件(Undelivered、Failed、Rejected、Expired)。投递事件会标识运营商和 MCC/MNC(移动网络)。失败事件显示错误描述;Details 标签页包含错误代码。
Details
Details 标签页显示消息的元数据:
- Message ID、Direction、From、To 和 Category
- Segments:计费分段数、编码方式(GSM_7BIT 或 UCS2)以及字符数(参见分段与编码)
- Cost:金额和币种,在消息定价完成后显示
- Carrier 和 MCC/MNC:投递网络(已知时显示)
- Sent、Handed to carrier 和 Delivered 时间戳
- Error:未送达消息的错误描述和错误代码
- 您在发送时设置的任何 Tags 和 Metadata
大多数字段可以一键复制。
公开的消息和事件读取覆盖最近 30 天。更早的消息 ID 超出该读取窗口;请根据您自己的数据保留和合规策略保存应用程序所需的记录。
通过 API 访问相同日志
该页面背后的列表即 GET /v1/sms/messages,其筛选条件涵盖状态、类别、标签、精确收件人和时间窗口。使用 GET /v1/sms/messages/{message_id}/events 检索消息的时间线。使用 GET /v1/sms/messages/{message_id} 读取最新状态,或实时消费 webhook 事件。
后续步骤
相关资源
继续查阅此主题的文档、指南和示例。资源为英文。