Email 概览

通过 POST /v1/email/messages 发送事务性和营销邮件。使用 bk_{region}_... 密钥及其对应的区域主机：https://us1.platform.bird.com 或 https://eu1.platform.bird.com。我们会使用 DKIM 对邮件进行签名、投递邮件，并报告每个收件人的结果。

如果想先发一封邮件再继续阅读，快速入门会引导你从一个 API 密钥到成功投递一封邮件。本页介绍本节其余内容所依赖的模型，并指向各部分的详细指南。

一次发送在一次调用中被接受，然后异步投递。POST /v1/email/messages 验证载荷和发送域，随后返回 202 Accepted 及一个 em_ 消息 ID。通过 webhook 事件或消息端点读取每个收件人的结果。发送邮件涵盖载荷、字段限制和响应。

该模型的两个特性决定了本节其余内容的结构。

一封邮件，多个收件人，各自独立的生命周期。 一封发给五个地址的邮件会产生五个独立的结果，你读取到的消息级状态是它们的汇总。屏蔽以同样方式处理：一个被屏蔽的地址返回 rejected，其余四个正常投递。

每封邮件都声明发送目的。 类别为 transactional 或 marketing，决定哪些屏蔽规则适用。退订了你新闻通讯的人仍然需要收到密码重置邮件，类别正是告诉我们区别的依据。

发送也可以通过其他途径到达，或延迟发出。SMTP 接受任何使用该协议的提交，定时发送会将邮件保留到你设定的时间。

Email 是控制面板侧边栏中的一个频道。其页面按显示顺序如下：

收件人不在 Email 部分，而在侧边栏的 Contacts 中：All contacts 存储具有自定义属性的联系人（参见联系人），Audiences 将他们分组为群发邮件使用的可复用列表（参见受众）。

发送。 发送邮件是首先要阅读的指南：它定义了所有其他发送路径都基于的载荷。在此基础上，模板存储可复用内容，附件添加文件，批量发送在一次请求中提交最多 100 封邮件，群发邮件向整个受众发送一封邮件。

域名与身份认证。 发送域名涵盖注册域名并完成验证。DKIM、SPF 和 DMARC 解释每条记录向接收邮箱提供商证明了什么，BIMI 在支持该功能的邮件应用中将你的品牌标志展示在邮件旁。

信誉。 屏蔽列表是我们停止发送的地址列表，由硬退信和投诉自动填充；退订以相同方式停止投递，但基于明确的偏好而非屏蔽记录。专用 IP 和池与 IP 预热介绍如何使用仅属于你组织的 IP 地址进行发送。邮件可送达性将这些内容串联起来。

了解发生了什么。 邮件日志展示单封邮件及其按收件人的时间线。邮件指标汇总你的流量。事件是事件词汇表以及 webhook 如何将事件投递到你的端点。

接收。 接收邮件涵盖两种接收方式：我们生成的无需 DNS 的转发地址，或你拥有的子域上的 MX 记录。Agent 邮箱在此基础上构建可供你的代码发送和读取的收件箱。

测试。 邮件沙箱可端到端测试你的集成而不实际投递。向 bounce@messagebird.dev 发送以通过真实的事件和 webhook 管道生成硬退信。该测试不会向你的屏蔽列表写入任何内容。

要从其他提供商迁移生产邮件，请参照迁移指南。它涵盖请求映射、DNS、屏蔽列表、webhook、沙箱测试和流量切换。