添加发信域名,将生成的 DNS 记录填入你的服务商,Bird 便会为每一封邮件签上 DKIM、SPF 和 DMARC。大多数验证在数分钟内完成,你还能在仪表盘中查看 DMARC 对齐情况。
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..."You can sign in any time at bird.com/login.
Your test API key is on your dashboard, ready to send.
身份验证,无需考古般的 DNS 排查。
在 Bird Email API 上,可送达性从发件域名开始。Bird 生成记录、在边缘签名,并在域名失去对齐的那一刻通知你。身份认证成为一个设置步骤,而非持续的排查工作。
通往已签名域名的五个步骤。
Bird 生成每一条记录。你只需发布一次,我们负责保持其验证状态。
- 01
几分钟内添加一个域名。
在你的服务商处粘贴生成的 DNS 记录并点击验证。大多数会在传播后的几分钟内完成。
- 02
DKIM、SPF、DMARC 签名。
来自已验证域名的每封邮件都会自动签名,并可选支持 BIMI。
- 03
每个账户可拥有多个域名。
为事务邮件和营销邮件分别使用独立域名,或为每个品牌使用一个域名。每个域名都有自己的信誉。
- 04
DMARC 监控。
在仪表盘中查看 DMARC 对齐情况和身份认证结果。配置错误会在影响送达之前就暴露出来,而不是等到某次营销活动悄无声息地表现不佳之后。
- 05
对子域名友好。
从专用子域名发送,将你的发送声誉与企业邮件隔离开来。
一条命令,搞定所需的全部记录。
从仪表盘、API 或 CLI 添加域名。Bird 会返回需要发布的精确记录:一个用于签名邮件的 DKIM 密钥、一条无需改动你的顶级域记录即可对齐 SPF 的 return-path CNAME、一条 DMARC 记录,以及一条用于品牌化打开和点击链接的可选 tracking CNAME。然后它会替你完成验证。
$ 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 指南 中了解这些记录的工作原理。
发送域名常见问题
域名验证需要多久?+
我需要哪些记录?+
DMARC 记录究竟有什么作用?+
我可以从子域名发送吗?+
我可以使用多个域名吗?+
全球约 40% 的商业邮件已运行在 Bird 上。
在我们运营了十年的基础设施上发送事务和营销邮件。域名身份认证只是 Bird Email API 的一项能力:发送、可送达性、专用 IP、抑制和分析都随之提供。