从发送到
送达手机的完整路径。

通过一个发送 API 触达客户，由 Bird 负责运营商连接。选择支持的目的地和合适的发送方，然后跟踪报告的投递结果。当路由、收件人或注册需要关注时，按国家或运营商排查失败原因。

开始使用联系销售

你的应用

选择收件人、发送方、类别和消息内容。

目的地与发送方检查

使用已启用的市场和所需的注册。

运营商交接

Bird 通过其运营商连接提交消息。

可查询的投递结果

在消息记录、webhooks 和分析中跟踪回执。

概念流程图。受理、运营商交接和投递回执描述了消息生命周期的不同阶段。

你的发送所依托的那一层。

路由位于 Bird SMS API 之下。Bird 在受理前检查目的地和发送方，然后将准备好的消息提交到运营商传输通道。在决定是否需要排查发送方、目的地或收件人问题时，检查报告的运营商和投递结果。

了解运营商交接前的决策。

资格检查、消息准备和运营商提交各有不同职责。

01
运营商连接。
Bird 管理发送背后的运营商连接。使用目的地目录检查你所服务市场的支持发送方类型和注册要求。
02
准备好的发送方和目的地。
发送方类型、目的地规则和注册决定了可以使用的发送号码。在消息排入传输队列之前，需建立有效的配置。
03
可用时提供运营商信息。
处理过程可解析收件人的运营商以用于计价。查找缺失或失败时回退到国家级计价。回执中的运营商信息也可能缺失；避免仅根据号码前缀推断网络。
04
投递回执作为运营商证据。
运营商回执可报告投递成功或最终的投递失败结果。部分消息会一直等待回执，缺失的运营商字段视为未知。请结合事件时间线阅读当前状态。
05
讨论上线所需的路由要求。
公开的 SMS 请求不提供最低成本与最高质量的路由选择器。在规划较大流量时，请与 SMS 专家讨论目的地组合、发送方要求和吞吐量。

可排查的投递结果。

一次成功的 SMS 投递取决于目的地、发送方注册、消息内容和运营商路径。Bird 将这些决策整合到一个发送流程中。先从目的地要求入手，然后利用消息记录和运营商结果确定需要改进的地方。

投递回执，直接来自运营商。

成功的请求在运营商投递前返回 202。后续事件可能包含报告的运营商和 MCC/MNC。将缺失的字段视为未知，检查消息时间线获取可用证据。

POST /webhooks/bird

signed

{
  "type": "sms.delivered",
  "timestamp": "2026-05-19T15:42:01.221Z",
  "data": {
    "sms_id":       "sms_4kT01Lq2m",
    "workspace_id": "ws_8KQ2",
    "to":           "+15005550006",
    "from":         "+12025550188",
    "tags":         null,
    "metadata":     null,
    "carrier":      "Verizon",
    "mcc_mnc":      "311480",
    "cost": {
      "amount":             "0.0079",
      "currency_code":      "USD",
      "transaction_amount": "0.0079",
      "passthrough_amount": null
    }
  }
}

运营商和 MCC/MNC 字段在可用时提供。与基于前缀的预期不一致是需要排查的理由，但这本身并不能证明号码已携号转网。

sms.delivered运营商已确认手机收到了消息（DLR）。
sms.failed运营商拒绝或无法投递，并附有具体原因。

路由依赖号码情报。

当你的应用需要受支持的电话号码情报时，使用 Lookup。订阅 webhooks 获取 SMS 结果，并使用错误参考和可送达性指南来解读报告的失败。查询结果不等同于发送方资格或投递保证。

构建前的问题

如何查看目的地覆盖范围？

打开目的地目录，查看每个市场的发送方类型和注册要求。你的工作区还必须启用该目的地，发送请求才会被接受。

运营商回执能证明什么？

它报告来自运营商的投递结果。回执可能在请求被接受后才到达，消息记录可能仍处于待处理状态。投递成功并不代表收件人已阅读或响应了短信。

如何排查失败的路由？

从消息状态和失败原因入手。按运营商、国家或发送方对比报告，然后检查注册和目的地配置。仅凭汇总失败率无法定位原因。

我可以单独查询一个电话号码吗？

如果你的应用在发送前需要电话号码情报，请使用 Lookup。查看该查询可用的信号和覆盖范围，而不是将 SMS 投递报告当作完整的号码检查。

SMS 平台的其余部分

一套 API，一组密钥。探索其他能力。

发送发送 API：分段、Unicode 安全、批量和幂等性。号码长码、短码、免费电话号码和字母数字发送者 ID。双向以 HMAC 签名 webhook 形式接收的入站 SMS 和会话式回复。合规A2P 10DLC 注册、退订关键词和发送方 ID 规则。分析投递结果、失败原因和运营商回执中的延迟。SMS API 概览完整的 SMS API：发送、号码、双向、合规、路由和分析。SMS 资源库查找指南、解答和工具，助你迈出下一步。

规模扩展
不失控。

在工作区中组织团队，控制 API 访问权限，通过审计日志追踪变更。

HarborOrganization

WorkspacesProductionSandbox

Delivery agent

API key · Customer operations team

Active

PermissionsAccess

EmailRead & write

SMSRead & write

ALAlex Lee AdminPermissions updated

Audit log

Production

Workspace: Production
Resource: Delivery agent
WhatsApp: ReadRead & write

Succeeded

Explore Enterprise

从 SMS 开始。
使用 Bird 跨渠道构建。

开始使用联系销售

从发送到送达手机的完整路径。