添加发送域名,将生成的 DNS 记录配置到您的域名提供商,Bird 会自动为每封邮件签署 DKIM、SPF 和 DMARC。大多数验证在几分钟内即可完成,Bird 还会持续重新检查记录状态。
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 生成记录、在边缘签名,并在域名失去对齐的那一刻通知你。身份认证成为一个设置步骤,而非持续的排查工作。
通往已签名域名的五个步骤。
我们生成所有记录。您只需发布一次,我们持续为您保持验证状态。
- 01
几分钟内添加一个域名。
在你的服务商处粘贴生成的 DNS 记录并点击验证。大多数会在传播后的几分钟内完成。
- 02
DKIM、SPF、DMARC 签名。
来自已验证域名的每封邮件都会自动签名,并可选支持 BIMI。
- 03
每个组织最多十个域名。
为事务性邮件和营销邮件分别配置域名,或为每个品牌单独设置域名,各自维护独立的发送信誉。默认上限为十个,可按需提升。
- 04
针对记录本身的工具。
对域名的实时 DMARC、SPF、DKIM、BIMI 和 MX 记录进行评估,获取失败项及原因。粘贴 DMARC 聚合报告,即可获得通俗易懂的解读。两项功能适用于任何域名,无需密钥。
- 05
对子域名友好。
从专用子域名发送,将你的发送声誉与企业邮件隔离开来。
一条命令,搞定所需的全部记录。
从仪表盘、API 或 CLI 添加域名。Bird 会返回需要发布的精确记录:一个用于签名邮件的 DKIM 密钥、一条无需改动你的顶级域记录即可对齐 SPF 的 return-path CNAME、一条 DMARC 记录,以及一条用于品牌化打开和点击链接的可选 tracking CNAME。然后它会替你完成验证。
$ 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、抑制和分析都随之提供。