SMS 概述
Bird SMS 通过与 Bird Email 相同的平台和 API 密钥发送短信。使用 bk_{region}_… 密钥对您的区域主机（https://us1.platform.bird.com 或 https://eu1.platform.bird.com）调用 Bird。Bird 选择到达收件人运营商的路由，将文本拆分为计费分段，并通过投递回执报告每条消息。SMS 端点以 /v1/sms/ 开头。
您可以使用自选的发送方和类别发送自由文本，也可以使用 Bird 的内置 模板，模板会提供正文、类别和发送方。Bird 还会接收对您号码的回复，将每条入站消息与您的发送记录一起存储，并发出 sms.received。当回复匹配受支持的退订关键字（如 STOP）时，Bird 还会记录发送方与订阅者的屏蔽关系。有关覆盖范围和配置，请参阅退订与关键字。
发送工作原理
使用 POST /v1/sms/messages 发送 SMS：一个收件人和一条消息，携带您自己的 text（含发送方和类别）或 template 引用及其变量值。Bird 验证请求和目的地、解析发送方，并返回 202 Accepted 和消息 ID。投递随后异步进行。通过事件和 webhooks 或消息读取端点跟踪结果。要在一次调用中发送多条独立消息，请使用批量端点。
三个核心概念贯穿整个 API：
- 发送和投递是两个独立阶段。 202 表示 Bird 已接受消息。运营商在接受后处理消息，稍后可能返回投递回执。失败回执也是最终结果；在将发送视为已投递之前，请检查报告的状态。
- 文本按分段计费。 超过一个分段的消息会被拆分并按分段计费，每个分段的容量取决于您使用的字符。字符限制包含编码规则、完整字符集以及如何将消息控制在一个分段内。
- 发送目的很重要。 每条消息都携带一个类别：transactional、marketing、authentication 或 service。Bird 和运营商使用类别来理解消息的用途。使用模板发送时，类别来自模板。
在首次发送之前，请在 SMS > Destinations 中启用您所服务的目的地国家。默认拒绝的白名单初始仅启用您组织的所属国家。Bird 会拒绝向任何其他国家的发送。发送 SMS 介绍了此前提条件。
对于一次性验证码，建议使用 Bird Verify，而非自行编写消息。Verify 通过 SMS 或邮件生成并投递验证码、校验答案，并强制执行过期时间、尝试次数限制和重新发送冷却。
仪表板中的 SMS 应用
在仪表板中，SMS 是侧边栏中的产品之一。以下是它的页面及各页面指南的位置：
| 页面 | 用途 |
|---|---|
| Messages | 所有已发送消息及其逐条事件时间线和投递详情。指南：SMS 日志 |
| Templates | 可发送的内置模板：名称、类别、语言和变量。指南：SMS 模板 |
| Metrics | 投递率、失败率和接受量随时间的变化。指南：SMS 指标 |
| Senders | 可用于发送的发送方 ID 和号码，以及每个号码的注册地。指南：SMS 发送方 ID |
| Destinations | 您的工作区可发送到的国家；发送前请先启用目的地。指南：发送 SMS |
可见性
使用消息记录和可用的事件时间线来调查接受、运营商交接和投递结果。消息详情包含分段数和所有计费组成部分。公共消息读取覆盖 SMS 日志中描述的保留窗口。
- SMS 日志：仪表板中的逐条消息视图。每次发送的事件时间线、分段数、费用和运营商详情。
- SMS 指标：所有发送的汇总投递率、失败率、接受量和投递延迟。
- 事件：SMS 事件词汇表、消息生命周期以及向您端点的 webhook 投递。
后续步骤
| 页面 | 涵盖内容 |
|---|---|
| 发送 SMS | 发送 API：目的地、发送方、正文、分段、类别、标签 |
| 字符限制 | GSM-7 和 UCS-2 编码、每分段限制以及 12 分段上限 |
| SMS 模板 | 内置模板目录和通过模板引用发送 |
| SMS 发送方 ID | 选择发送方类型并按目的地国家注册 |
| 10DLC 注册 | 为美国 A2P 发送注册品牌、活动和号码 |
| SMS 日志 | 每条消息及其事件时间线、分段数和费用 |
| SMS 指标 | 投递率、失败率和延迟 |
| 事件 | SMS 事件类型和 webhook 投递 |
| Webhooks 和事件 | 端点设置、签名验证、重试和重放 |
| Verify 概述 | 通过 SMS 和邮件发送的一次性验证码，由 Bird 发送并校验 |
| 控制您的账户可发送的地区 | 视频：展示向未启用目的地发送时的返回结果 |