短码是一种为大批量一对多 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.`,
category: "authentication",
}).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 活动通过后即刻生效。