字母数字发送者 ID 会在发件人字段中放置你的品牌名称而非号码。许多国家/地区要求你在该名称能够投递之前对其进行预注册。Bird 会提交注册并通过 API 报告其状态，让你知道发送者何时生效。
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为什么某些发送者需要先注册。
发送者 ID 注册是 Bird SMS API 上 SMS 合规 的一部分。为了遏制伪造，一些国家/地区只投递已向当地运营商或监管机构预注册的字母数字发送者 ID。在适用此规则的地方，未注册的品牌发送者会被拒绝或被改写。Bird 会替你提交注册并暴露其状态，于是你不会向一个尚不能投递的发送者发送。
注册如何运作。
哪里需要它、由谁提交，以及它何时生效。
- 01
了解哪里需要它。
字母数字发送者 ID 是否需要注册取决于目的地国家/地区。有些要求预注册，有些允许动态发送者，还有些则完全不允许字母数字。
- 02
Bird 替你提交。
从控制台提交发送者 ID 和目的地。Bird 会代表你将注册提交给当地运营商或监管机构。
- 03
通过 API 跟踪状态。
审批会经由外部注册机构进行，需要数天到数周。轮询注册的状态，让你的代码在从该发送者 ID 发送之前等待它。
- 04
它适用于字母数字发送者。
注册管辖的是字母数字发送者 ID 本身。从号码发送——长码、短码、免费电话号码——则遵循这些号码类型的规则。
从 API 查看注册状态。
你从控制台提交发送者 ID；API 会按目的地告诉你它所处的阶段。在从该发送者发送之前，读取注册并根据其状态进行分支处理。
sender-id-status.ts
200 · registered
const { data: senderId } = await bird.sms.compliance.senderIds
.get("Bird")
.safe();
if (senderId.status === "registered") {
// safe to send from this sender ID in that country
}
console.log(senderId.country); // → "IN"注册跟随字母数字发送者。
这是 字母数字发送者 ID 背后的合规步骤。该发送者类型让你能在国家/地区允许的地方以品牌名称发送；而注册正是在国家/地区要求先注册的地方让该名称可投递的关键。
发送者 ID 注册常见问题
什么是字母数字发送者 ID？+
它是一种显示为名称而非电话号码的发送者——你的品牌出现在发件人字段中。它仅支持单向，并且在目的地国家/地区允许的情况下，它能让一条消息明显识别为来自你。
为什么我必须注册一个？+
为了遏制伪造，许多国家/地区只投递已向当地运营商或监管机构预注册的字母数字发送者 ID。在适用该规则的地方，未注册的品牌发送者会被拒绝或被改写。
由谁提交注册？+
由 Bird 提交。你从控制台提交发送者 ID 和目的地，Bird 会将其提交给当地注册机构，API 会报告其状态，让你知道发送者何时生效。
需要多长时间？+
审批会经由外部运营商和注册机构进行，因国家/地区而异，通常需要数天到数周。通过 API 轮询注册的状态，并在从该发送者 ID 发送之前等待它。