长码是一种可发送和接收 SMS 的标准 10 位电话号码。它是中等用量下双向对话、OTP 和提醒的默认发送者。对于美国应用流量，它通过 A2P 10DLC 注册。
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 号码 界面上四种发送者类型之一，是更广泛的 Bird SMS API 的一部分。它们本地化、双向且开通迅速——在用量证明需要短码之前，对于大多数会话式和事务性流量而言是合适的起点。
长码能带给你什么。
本地化呈现、双向流量、中等用量。
- 01
一个本地 10 位号码。
接收方看到的是来自他们自己国家/地区的区号，这读起来像是一个真实的发送者，而不是一次营销群发。
- 02
默认双向。
将号码的入站流量指向一个 webhook，回复就会以签名事件形式送达——这是会话式流程的基础。
- 03
通过 A2P 10DLC 注册。
美国应用流量通过已注册的 10DLC 活动运行，这会赢得经审核的吞吐量和运营商的信任，而不是成为一个过滤风险。
- 04
注册一通过即刻生效。
立即购买号码；一旦其 10DLC 活动获批，它就开始承载已注册的流量。
购买一个并开始发送。
按国家/地区和能力搜索、购买号码，并将其入站路由到一个 webhook——使用你发送所用的同一客户端。同一种代码结构可开通任何发送者类型；只有 type 字段发生变化。
long-code.ts
201 · purchased
const { data: available } = await bird.numbers.search({
country: "US",
type: "long-code",
capabilities: ["sms"],
}).safe();
const { data: number } = await bird.numbers.buy({
number: available[0].number,
webhook: "https://example.com/webhooks/bird",
}).safe();注册是其中的一部分。
要向美国号码发送应用到个人流量，长码需通过一个已注册的 A2P 10DLC 活动运行。Bird 会从控制台提交品牌和活动，并通过 API 报告审批状态，让你确切知道何时可获得全速吞吐量。
长码常见问题
什么是 10DLC 长码？+
10 位长码（10DLC）是一种标准本地电话号码，在其品牌和活动向运营商注册后，可在美国用于应用到个人 SMS。
长码能获得多少吞吐量？+
已注册的 10DLC 长码会获得经审核的吞吐量，具体取决于品牌的信任分数和活动类型——比未注册的号码多，比短码少。
长码能接收回复吗？+
可以。长码是双向的：将号码的入站路由到一个 webhook，回复就会以 HMAC 签名事件形式送达。
我什么时候应该改用短码？+
当一对多用量超出长码吞吐量所能支持的范围时，或者当某个项目需要运营商审核的短码所提供的更高、更可预测的速率时。