发送域名

验证一个域名。 为每封邮件签名。

适用于:
Cursor

添加发送域名,将生成的 DNS 记录配置到您的域名提供商,Bird 会自动为每封邮件签署 DKIM、SPF 和 DMARC。大多数验证在几分钟内即可完成,Bird 还会持续重新检查记录状态。

welcome.tsx
200 · 1.2s
import { BirdClient } from "@messagebird/sdk";
import { render } from "@react-email/render";
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",
  html:    await render(<WelcomeEmail name="Ada" />),
}).safe();

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

无需手动翻查 DNS 记录,即可完成身份验证。

Bird Email API 上,可送达性从发件域名开始。Bird 生成记录、在边缘签名,并在域名失去对齐的那一刻通知你。身份认证成为一个设置步骤,而非持续的排查工作。

通往已签名域名的五个步骤。

我们生成所有记录。您只需发布一次,我们持续为您保持验证状态。

  1. 01

    几分钟内添加一个域名。

    在你的服务商处粘贴生成的 DNS 记录并点击验证。大多数会在传播后的几分钟内完成。

  2. 02

    DKIM、SPF、DMARC 签名。

    来自已验证域名的每封邮件都会自动签名,并可选支持 BIMI。

  3. 03

    每个组织最多十个域名。

    为事务性邮件和营销邮件分别配置域名,或为每个品牌单独设置域名,各自维护独立的发送信誉。默认上限为十个,可按需提升。

  4. 04

    针对记录本身的工具。

    对域名的实时 DMARC、SPF、DKIM、BIMI 和 MX 记录进行评估,获取失败项及原因。粘贴 DMARC 聚合报告,即可获得通俗易懂的解读。两项功能适用于任何域名,无需密钥。

  5. 05

    对子域名友好。

    从专用子域名发送,将你的发送声誉与企业邮件隔离开来。

一条命令,搞定所需的全部记录。

从仪表盘、API 或 CLI 添加域名。Bird 会返回需要发布的精确记录:一个用于签名邮件的 DKIM 密钥、一条无需改动你的顶级域记录即可对齐 SPF 的 return-path CNAME、一条 DMARC 记录,以及一条用于品牌化打开和点击链接的可选 tracking CNAME。然后它会替你完成验证。

bird email domains create
bird CLI
$ bird email domains create mail.acme.com \
    | jq -c '.status, (.dns_records[] | {purpose, type, host})'

"pending"
{"purpose":"dkim","type":"TXT","host":"bird1._domainkey.mail.acme.com"}
{"purpose":"return_path","type":"CNAME","host":"send.mail.acme.com"}
{"purpose":"dmarc","type":"TXT","host":"_dmarc.mail.acme.com"}
{"purpose":"tracking","type":"CNAME","host":"links.mail.acme.com"}

# Publish them, then check: bird email domains verify <domain-id>

品牌化的打开与点击跟踪。

添加可选的 tracking CNAME,Bird 就会在你自己的域名下衡量打开和点击,而不是通过通用重定向。打开数据来自 HTML 中的像素;点击数据来自通过你品牌化主机名重写的链接,因此重定向和链接的信誉都归属于你的品牌,并通过 HTTPS 提供服务。

跟踪是独立于发送的能力。一旦 DKIM、return-path 和 DMARC 验证通过,域名即可发送,无论是否配置了 tracking 记录。打开与点击跟踪会在 CNAME 验证通过并由你开启后生效。

它默认关闭是有原因的。重写后的链接会改变收件人悬停时看到的 URL 并增加一次重定向跳转,所以对于密码重置和安全类邮件,请关闭点击跟踪——在这些场景下,一条干净的直达链接比这项指标更重要。

一次验证,长久守护。

添加域名后,Bird 会每隔几分钟检查一次,在前三天内逐渐放宽至每小时检查一次,之后稳定为每天对所有活跃域名进行一次复查。如果已验证的记录开始出现问题,该域名将保持验证状态并进入警告状态,恢复为每小时检查一次,同时通知您的工作区;只有在连续 24 小时持续失败后才会降级,而在此期间内任何一次通过检查即可清除警告。短暂的 DNS 波动不会导致您的服务中断,修复后的记录会在下次检查时自动重新验证,无需您手动操作。

在文档中深入了解。

发送域名指南 添加并验证域名,并在 DKIM、SPF 与 DMARC 指南 中了解这些记录的工作原理。

全球约 40% 的商业邮件已运行在 Bird 上。

在我们运营了十年的基础设施上发送事务和营销邮件。域名身份认证只是 Bird Email API 的一项能力:发送、可送达性、专用 IP、抑制和分析都随之提供。

从一个渠道开始。
准备好后,再添加其他渠道。

测试 API 密钥即刻可用。添加支付方式并验证发送者身份后,即可解锁生产环境。

正在使用 Claude Code、Cursor 或 Codex?复制一条设置提示,您的智能代理即可自动安装 Bird CLI 和相关技能。选择您的工具:

Cursor