BIRD Email
专为同时发送其他消息的开发者打造的电子邮件 API。
Transactional and marketing email on the same infrastructure that carries your SMS, voice, and WhatsApp. About 40% of the world's commercial email transits the Bird network — we've been at this a decade. 99.99% SLA on Email specifically.
import { BirdClient } from "@messagebird/sdk";
import { WelcomeEmail } from "./emails/welcome";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const { data, error } = await bird.email.send({
from: "Bird <hello@bird.com>",
to: ["ada@example.com"],
subject: "Your invite is ready",
react: <WelcomeEmail name="Ada" />,
}).safe();
if (error) throw error;
console.log(data.id);
// → "email_2bX91Yk8h..."You can sign in any time at bird.com/login.
Your test API key is on your dashboard, ready to send.
从 npm install 到首次发送，仅需 5 分钟
用您已在使用的编程语言发送邮件。
覆盖所有主流运行时的 SDK。首次发送将发送至受信测试收件人 (delivered@bird.dev)，这样您可以在验证域名之前先跑通 CI 检查。
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const { data, error } = await bird.email.send({
from: "you@yourdomain.com",
to: ["delivered@bird.dev"],
subject: "Hello from Node",
html: "<p>It works.</p>",
}).safe();Ten parts of email that
aren't your problem anymore.
投递能力与运维基础组件，
named and audit-able.
- 01
边缘节点签名。
为任何已验证的发送域签署 DKIM、SPF、DMARC 和 BIMI。
- 02
主动黑名单监控。
实时监控各大 DNSBL；在打开率下降之前发出警报。
- 03
托管式专用 IP。
按账户分配，21 天内自动预热，发送者声誉下降时自动热切换。
- 04
动态屏蔽列表。
退回、投诉和退订将自动且可逆地抑制对应收件人。
- 05
60 秒完成 DNS 验证。
添加域名，粘贴记录，点击验证。大多数验证在一分钟内完成。
- 06
React Email 模板。
在 SDK 中进行服务端渲染。将 React 组件作为邮件正文传入；我们在发送时渲染 MIME。
- 07
每封邮件的公开分享链接。
每封已发送的邮件都会生成一个 48 小时有效的公开 URL，方便截图、工单和错误报告。
- 08
四十二项投递能力指标。
按域名、按 ISP、按 IP 维度——在仪表板和诊断 API 中呈现。
- 09
入站解析。
按收件人地址发送 HMAC 签名的 Webhook。解析回复，构建线程应用。
- 10
批量发送多达 500 封。
每次调用可指定不同的收件人，每位收件人拥有独立变量。一个幂等键覆盖整个批次。
我们为何打造邮件服务
因为您的验证码不应该和送达回执分属不同供应商。
电子邮件不是一个独立产品，它是流程中的一个渠道。验证码先通过邮件发送，失败后回退至 SMS。当客户偏好 WhatsApp 时，收据通过 WhatsApp 发送。Bird Email 的 API、Webhook 和幂等契约与所有其他渠道一致——因为同一个工程团队在我们运行了十年的同一套线路上构建了它们。
import { BirdClient } from "@messagebird/sdk";
import { WelcomeEmail } from "./emails/welcome";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const { data, error } = await bird.email.send({
from: "Bird <hello@bird.com>",
to: ["ada@example.com"],
subject: "Your invite is ready",
react: <WelcomeEmail name="Ada" />,
}).safe();
if (error) throw error;
console.log(data.id);
// → "email_2bX91Yk8h..."You can sign in any time at bird.com/login.
Your test API key is on your dashboard, ready to send.
每次状态变更都是一个 Webhook。
HMAC 签名的负载，防重放，幂等。所有 Bird 渠道使用相同的信封格式——学会一个，全部掌握。
{
"type": "email.delivered",
"id": "evt_3nB91x...",
"created_at": "2026-05-19T15:42:01.221Z",
"data": {
"email_id": "email_2bX91Yk8h",
"from": "hello@bird.com",
"to": "ada@example.com",
"subject": "Your invite is ready",
"isp": "gmail",
"latency_ms": 1842
}
}重试计划：5 秒、30 秒、5 分钟、30 分钟、2 小时、6 小时、12 小时。最终尝试后进入死信队列；所有死信事件均可通过仪表板或 API 重放。
email.queued已被 API 接受并排入发送队列。email.sent已移交给接收端 MTA。email.delivered接收端 MTA 已接受该消息。email.opened跟踪像素已被请求（如果启用了跟踪）。email.clicked某个跟踪链接被点击。email.bounced软退回或硬退回——退回代码包含在负载中。email.complained收件人将该消息标记为垃圾邮件。email.unsubscribed收件人点击了 list-unsubscribe 头部。email.failed发送前的永久性失败。
如果您已集成了电子邮件，那么 SMS 也已集成。
相同的认证模型、相同的幂等契约、相同的错误信封、相同的 Webhook 结构。不同的只是各渠道的功能——而非调用方式。
Verified domain, signed at the edge, suppression-aware. Render React or pass raw HTML.
await bird.email.send({
from: "hello@bird.com",
to: ["ada@example.com"],
subject: "Your code",
html: `<p>Code: ${code}</p>`,
});SMS
Same envelope, same idempotency, same error type registry. The transport is the only difference.
await bird.sms.send({
from: "Bird",
to: "+14155550172",
text: `Your code is ${code}.`,
});