A2P 10DLC 是应用到个人 SMS 通过标准 10 位号码触达美国接收方的方式。你先注册一个品牌，然后注册一个描述你所发送消息的活动。运营商会审核两者，并在活动获批后授予其吞吐量。
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.`,
category: "authentication",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."
Today at 2:14 PM
10DLC 存在的原因。
A2P 10DLC 是 Bird SMS API 上 SMS 合规 的一部分。美国运营商要求任何通过本地长码发送应用流量的企业注册其背后的品牌以及它运行的每个活动。已注册的流量会获得经审核的吞吐量和运营商信任；未注册的流量会被过滤。Bird 会提交两者并报告审批状态，于是你发送进入的是一个真正生效的活动。
注册流程。
先品牌，再活动，然后是承载它的号码。
- 01
注册品牌。
提交你流量背后的法律实体。运营商会审核它，该品牌随即成为每个活动所附着的身份。
- 02
注册活动。
描述您发送的消息：用途、示例内容和用户订阅流程。获得批准后即可解锁活动的发送吞吐量。
- 03
关联你的号码。
附加将承载该活动的长码。从此之后，它们的美国应用流量将通过已注册的活动运行。
- 04
查询状态直到生效。
审批需要数天到数周。通过 API 轮询活动的状态，让你的代码等待它，而不是向一个待处理的活动发送。
从 API 查看活动状态。
你从控制台提交品牌和活动；API 会暴露各自所处的阶段。按 id 读取活动，并在开始发送前根据状态进行分支处理。
const { data: campaign } = await bird.sms.compliance.campaigns
.get("cmp_7Hq2...")
.safe();
if (campaign.status === "approved") {
// throughput is live — safe to send
}
console.log(campaign.brandId); // → "brand_3Lx9..."
10DLC 是长码获得美国吞吐量的途径。
如果你从 长码 发送，10DLC 正是将它们从过滤风险转变为经审核发送者的关键。号码在你购买的那一刻起就属于你，但它的美国应用流量只有在其关联的活动获批后才能以全速发送。
What registration costs.
TCR sets these fees and Bird passes them through at cost, priced live from the Bird billing API: a one-time brand fee, a one-time vetting fee per campaign submission, and a recurring monthly fee per campaign that varies by use case.