号码

为每条消息选择合适的发送者。

长代码、短代码、免费电话号码和字母数字发送方 ID：通过单一端点完成配置、注册和路由。您使用的发送方决定了吞吐量、成本以及适用的合规制度。

send-notification.ts

202 · 0.4s

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const { data, error } = await bird.sms.send({
  from:     "Bird",
  to:       "+15005550006",
  text:     "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
  category: "transactional",
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

send-notification.ts

202 · 0.4s

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const { data, error } = await bird.sms.send({
  from:     "Bird",
  to:       "+15005550006",
  text:     "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
  category: "transactional",
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

四种发送者类型，一套 API。

号码是 Bird SMS API 的基础。用你已经在使用的同一客户端搜索可用性、购买号码，并将入站路由到一个 webhook。你选择哪种类型取决于用量、地域，以及你能承担多少注册工作。

我应该使用哪种发送者？

吞吐量、覆盖范围和注册工作量因发送者类型而异。大多数美国应用流量从 10DLC 长码起步；大批量一对多项目会转向短码。

发送者类型	最适合	注册
长码（10DLC）	中等用量下的双向对话、OTP、提醒	A2P 10DLC 品牌 + 活动
短码	大批量一对多营销和提醒	运营商审核，前置周期以周计
免费电话号码	无需 10DLC 的美国/加拿大流量，吞吐量高于长码	免费电话号码验证
字母数字发送者 ID	在国家/地区允许的地方进行单向品牌提醒	许多国家/地区需要预注册

选择一种号码类型

深入了解每种发送方类型：覆盖范围、吞吐量及注册要求。

长码用于双向流量的本地 10 位号码，通过 A2P 10DLC 注册。短码为高吞吐量一对多发送而构建的 5–6 位号码。免费电话号码面向美国和加拿大流量、无需 10DLC 的已验证免费电话号码。字母数字发送者 ID在目的地国家/地区允许的地方以你的品牌名称发送。

几次调用即可搜索、购买并路由。

按国家/地区和功能查找号码，购买后将其入站流量指向 Webhook——全部通过您发送消息所用的同一 SDK 完成。号码在所需注册审批通过后即刻生效。

provision.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();

console.log(number.id); // → "num_8KQ2..."

在需要的地方处理好注册。

大多数美国应用流量需要 A2P 10DLC 品牌和活动注册；免费电话号码需要验证；许多国家/地区要求发送者 ID 预注册。Bird 会从控制台运行其中每一项，合规界面会从 API 跟踪状态。

SMS 平台的其余部分

一套 API，一组密钥。探索其他能力。

发送发送 API：分段、Unicode 安全、批量和幂等性。双向以 HMAC 签名 webhook 形式接收的入站 SMS 和会话式回复。合规A2P 10DLC 注册、STOP/HELP 退订，以及发送者 ID 规则。路由150 多个国家/地区、240 条直连运营商链路，以及故障转移。分析基于运营商投递回执的投递和互动指标。SMS API 概览完整的 SMS API：发送、号码、双向、合规、路由和分析。

开通合适的号码，几分钟内完成路由。

号码是 Bird SMS API 的一项能力：发送、双向入站、合规、路由和分析都随它一同提供。

探索 SMS 平台立即开始

为每条消息 选择合适的发送者。