发送域名

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

适用于:

添加发信域名,将生成的 DNS 记录填入你的服务商,Bird 便会为每一封邮件签上 DKIM、SPF 和 DMARC。大多数验证在数分钟内完成,你还能在仪表盘中查看 DMARC 对齐情况。

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 生成记录、在边缘签名,并在域名失去对齐的那一刻通知你。身份认证成为一个设置步骤,而非持续的排查工作。

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

Bird 生成每一条记录。你只需发布一次,我们负责保持其验证状态。

  1. 01

    几分钟内添加一个域名。

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

  2. 02

    DKIM、SPF、DMARC 签名。

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

  3. 03

    每个账户可拥有多个域名。

    为事务邮件和营销邮件分别使用独立域名,或为每个品牌使用一个域名。每个域名都有自己的信誉。

  4. 04

    DMARC 监控。

    在仪表盘中查看 DMARC 对齐情况和身份认证结果。配置错误会在影响送达之前就暴露出来,而不是等到某次营销活动悄无声息地表现不佳之后。

  5. 05

    对子域名友好。

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

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

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

bird domains create
pending
$ bird domains create mail.acme.com

Created dom_01k8a2hq9v publish these records at your DNS provider:

  TYPE   HOST                            VALUE
  TXT    bird._domainkey.mail.acme.com   v=DKIM1; k=rsa; p=MIGfMA0GCSq…
  CNAME  send.mail.acme.com              us1.bounce.bird.com
  TXT    _dmarc.mail.acme.com            v=DMARC1; p=none; rua=mailto:…
  CNAME  links.mail.acme.com             us1.links.bird.com

Status: pending run `bird domains verify dom_01k8a2hq9v` once they propagate.

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

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

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

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

一次验证,长久守护。

在你添加域名后,Bird 会频繁轮询,之后每天重新检查每个域名。已验证的域名只有在连续两次检查失败后才会失效,因此一次短暂的 DNS 故障不会让你掉线。记录一恢复,它就会自行重新验证。

在文档中深入了解。

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

发送域名常见问题

域名验证需要多久?+
添加域名,在你的服务商处粘贴生成的 DNS 记录,然后点击验证。大多数验证在 DNS 传播后的数分钟内完成,偶尔也可能需要更久。
我需要哪些记录?+
Bird 会替你生成这些记录:用于为邮件签名的 DKIM TXT 记录、对齐 SPF 的 return-path CNAME(无需 apex SPF 记录),以及 DMARC TXT 记录。用于品牌化打开/点击链接的跟踪 CNAME 为可选项。在你的 DNS 服务商处添加它们并完成验证。
DMARC 记录究竟有什么作用?+
DMARC 告诉接收服务器如何处理 DKIM 或 SPF 对齐失败的邮件,以及将显示谁在以你的域名发件的汇总报告发往何处。Bird 要求域名在发送前先配置 DMARC 记录,并建议从 p=none 起步,它只监控而不影响送达。在你确认所有合法发件源都已对齐后,再将策略收紧为 p=quarantine 或 p=reject。如果你已在自己的域名或上级域名发布了 DMARC,Bird 会按原样使用它。主流收件箱服务商如今要求批量发件方发布策略,因此在大批量发送时,拥有策略越来越成为进入收件箱的一部分。
我可以从子域名发送吗?+
可以,而且推荐这样做。从专用子域名发送可将你的邮件信誉与企业邮件隔离开来。
我可以使用多个域名吗?+
可以。为事务性和营销邮件分别运行不同域名,或为每个品牌运行一个域名,各自拥有独立的身份验证和声誉。

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

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

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

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

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