A2P 10DLC 是应用到个人 SMS 通过标准 10 位号码触达美国接收方的方式。你先注册一个品牌，然后注册一个描述你所发送消息的活动。运营商会审核两者，并在活动获批后授予其吞吐量。
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
Delivered10DLC 存在的原因。
A2P 10DLC 是 Bird SMS API 上 SMS 合规 的一部分。美国运营商要求任何通过本地长码发送应用流量的企业注册其背后的品牌以及它运行的每个活动。已注册的流量会获得经审核的吞吐量和运营商信任；未注册的流量会被过滤。Bird 会提交两者并报告审批状态，于是你发送进入的是一个真正生效的活动。
注册流程。
先品牌，再活动，然后是承载它的号码。
- 01
注册品牌。
提交你流量背后的法律实体。运营商会审核它，该品牌随即成为每个活动所附着的身份。
- 02
注册活动。
描述你所发送的消息——用例、示例内容和选择加入流程。审批正是解锁活动吞吐量的关键。
- 03
关联你的号码。
附加将承载该活动的长码。从此之后，它们的美国应用流量将通过已注册的活动运行。
- 04
查询状态直到生效。
审批需要数天到数周。通过 API 轮询活动的状态，让你的代码等待它，而不是向一个待处理的活动发送。
从 API 查看活动状态。
你从控制台提交品牌和活动；API 会暴露各自所处的阶段。按 id 读取活动，并在开始发送前根据状态进行分支处理。
campaign-status.ts
200 · approved
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 正是将它们从过滤风险转变为经审核发送者的关键。号码在你购买的那一刻起就属于你，但它的美国应用流量只有在其关联的活动获批后才能以全速发送。
A2P 10DLC 常见问题
什么是 A2P 10DLC？+
A2P 10DLC 是美国运营商针对通过标准 10 位长码发送的应用到个人 SMS 的框架。企业需要注册其流量背后的品牌，以及一个描述消息内容的活动，运营商会在授予吞吐量之前对两者进行审核。
品牌和活动有什么区别？+
品牌是发送流量的法律实体。活动描述该品牌下某个具体的消息用例。一个品牌可以有多个活动，而且你将号码关联到活动，而不是品牌。
审批需要多长时间？+
品牌和活动审核会经由运营商和注册机构进行，通常需要数天到数周。通过 API 查询活动的状态，让你的代码在发送前等待获批。
10DLC 在美国境外适用吗？+
不适用。10DLC 是美国的框架。其他国家/地区有各自的规则——许多国家/地区改为要求发送者 ID 预注册——而退订关键词处理在你发送的任何地方都适用。