短码是一种为大批量一对多 SMS 而构建的 5–6 位号码：营销、提醒和高速率 OTP。运营商会在每个项目能够发送之前进行审核，因此开通前置周期以周而非分钟计。
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
所有发送者类型中最高的吞吐量。
短码经过专门设计，使一个号码能够承载沉重的出站负载，这正是让当日活动或提醒群发及时送达的关键。
- 02
专用或共享。
选用专用短码，其发送声誉仅归你所有；在关键词之后共享一个短码可更快、更便宜地启动，但代价是继承你邻居们的声誉。
- 03
发送前经运营商审核。
每个短码项目都会经运营商审查，因此该号码到手时就已建立起他们的信任，而不是在实时流量下才去赢得信任。
- 04
最适合一对多。
营销发送、事务性提醒和高速率 OTP 都适合短码。对于双向会话式流量，长码通常是更好的起点。
搜索、购买并路由它。
开通短码使用与任何其他发送者类型相同的客户端和相同的调用结构——只有 type 字段发生变化。按国家/地区和能力搜索、购买号码，并将其入站指向一个 webhook。
short-code.ts
201 · purchased
const { data: available } = await bird.numbers.search({
country: "US",
type: "short-code",
capabilities: ["sms"],
}).safe();
const { data: number } = await bird.numbers.buy({
number: available[0].number,
webhook: "https://example.com/webhooks/bird",
}).safe();审核为你换来吞吐量。
这种权衡很直接：短码通过先经过审核来赢得其高的、运营商信任的吞吐量，因此请按以周计的前置周期来规划。当某个项目的用量超出 长码 所能支持的范围时，或者当你从第一天起就需要一个又高又可预测的发送速率时，就选择它。如果你的流量是双向且会话式的，或者用量适中，长码能更快生效且启动成本更低。
短码常见问题
什么是 SMS 短码？+
短码是一种 5–6 位号码，由运营商批准用于大批量一对多 SMS——营销活动、提醒和高速率 OTP。它是吞吐量最高的发送者类型，并且在能够发送之前需经过运营商审核。
短码开通需要多长时间？+
请按周而非分钟来规划。运营商会在每个短码项目上线之前进行审核，因此短码会有一段真实的前置周期——这不同于长码，长码在注册一通过后即可购买并开始发送。
专用还是共享短码？+
专用短码仅归你所有，因此其发送声誉完全是你自己的。共享短码会在关键词之后将一个号码拆分给多个发送者——更便宜、启动更快，但你会继承其上所有其他人的声誉。
我什么时候应该改用长码？+
当流量是双向且会话式时，或者用量不足以证明值得审核和前置周期时。长码是本地化的、默认双向，并在其 10DLC 活动通过后即刻生效。