发送 SMS 意味着要满足运营商和监管规则:美国的 A2P 10DLC 注册、各地的退订关键词处理,以及许多国家/地区的发送者 ID 预注册。Bird 在一个地方运行每一项并通过 API 报告状态。
send-otp.ts
200 · 0.4s
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const code = generateOtp();
const { data, error } = await bird.sms.send({
from: "Bird",
to: "+15005550006",
text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."Today at 2:14 PM
Hey Ada — your Bird sign-in code is 482917. It'll expire in 10 minutes. Don't share it with anyone.
482917
Delivered三种制度,一个界面。
合规是 Bird SMS API 中让你的流量保持可投递的那一层。根据你向哪里发送以及发送哪种消息,会适用不同的制度:美国的应用流量需要 10DLC,每位接收方都可以退订,许多国家/地区会将字母数字发送者置于预注册的门槛之后。你只需各提交一次,并从用于发送的同一客户端查看其状态。
哪种制度适用于我?
你必须注册什么,取决于你的接收方在哪里以及你发送什么。大多数美国应用项目会同时涉及全部三种。
| 制度 | 它涵盖什么 | 适用范围 |
|---|---|---|
| A2P 10DLC | 针对应用到个人流量的品牌和活动注册 | 美国 |
| 退订(STOP/HELP) | STOP、HELP 和 START 关键词处理以及一份抑制列表 | 你发送的所有地方 |
| 发送者 ID 注册 | 在字母数字发送者 ID 可投递之前对其进行预注册 | 许多有此要求的国家/地区 |
分制度的合规
深入了解每种制度——它要求什么,以及 Bird 如何提交和跟踪它。
提交一次,从 API 查看状态。
你从控制台提交 10DLC 品牌和活动、免费电话号码验证或发送者 ID 注册。Bird 会将其提交给运营商和注册机构,并通过 API 暴露当前状态,于是你的开通代码可以等待获批,而不是去猜测。退订处理无需任何设置——它会在每次发送时强制执行。
SMS 合规常见问题
发送前我必须注册哪些内容?+
这取决于你向哪里发送以及发送什么。美国的应用流量需要 A2P 10DLC 品牌和活动注册。许多国家/地区要求字母数字发送者进行发送者 ID 预注册。退订处理在任何地方都适用,且无需任何设置。
我必须自己构建退订处理吗?+
不必。STOP、HELP 和 START 关键词会在每次发送时自动得到遵守。STOP 会抑制该接收方,HELP 会触发一条帮助回复,START 会重新订阅。抑制列表可通过 API 查询。
我如何知道某项注册何时获批?+
Bird 会向运营商或注册机构提交每项注册,并通过 API 报告其状态。你的代码可以轮询注册的状态并等待获批,而不是向一个尚未生效的活动发送。
合规与 SMS API 的其余部分是分开的吗?+
不是。它使用与发送、号码和双向相同的客户端和密钥。注册状态和抑制列表是与发送调用并列的 API 资源,因此一次集成即可同时覆盖发送及其相关规则。