Email,清晰解读
好问题, 明确答案。
从首次发送到全球邮件计划,找到关于集成、营销活动、送达率及重要细节的答案。
深受构建世界级软件团队的日常信赖
查看更多客户故事按主题浏览
如何在不发送真实邮件的情况下进行测试?
向已记录的沙盒地址发送邮件,例如 delivered@messagebird.dev、bounce@messagebird.dev 或 complaint@messagebird.dev。这些地址通过正常流程触发各种结果和 Webhook。将测试受众限定为沙盒地址;同一批次中的真实地址会收到真实邮件。
我需要立即拥有自己的已验证域名吗?
入门域名在其文档限制下支持首次发送,沙盒地址支持测试。正式发送前请验证您自己的发送域名。请查看工作区的当前限额,而非依赖本页的固定套餐配额。
从哪里开始?
使用首封邮件快速入门进行 API 集成,使用 SMTP 指南接入现有的 SMTP 应用,使用 Email marketing 发送营销活动,或使用代理邮箱快速入门处理对话。每条路径都链接到相应的设置和文档。
费用是多少?
免费计划每月提供 1,000 封免费邮件,无需绑定信用卡。付费计划的单封邮件费率随发送量增加而降低,超出计划额度的部分按每 1,000 封邮件计费。定价页面列出了每个档位的公开价格。企业协议可以完全取消该上限。
如果我降级套餐或使用自己的域名,自定义地址前缀会怎样?
降级不会影响现有功能:您已经申请的地址前缀会继续工作,只是在回到配额范围内之前无法申请新的。使用您自己域名的邮箱与其他邮箱一样计入总邮箱配额,其本地部分不会占用自定义地址前缀的配额。
专用 IP 费用是多少?
专用 IP 是 Growth 计划的附加选项,最多可添加五个,月费详见邮件定价页面。无需设置费,也无需年度承诺。
如何查看我的发送限额?
您的有效请求速率限制取决于组织的套餐和任何已配置的覆盖值。读取组织速率限制端点或响应请求头,并在请求被限制时遵守 Retry-After。REST 发送和 SMTP 共享发送容量;批量请求有单独的请求策略。启动广播使用其营销活动操作,而发送配额和投递速率控制是独立的。
单封邮件最大可以多大?
估算的生成消息大小不得超过 20 MB,包括 HTML、文本和 base64 编码的附件。原始附件内容应远低于 15 MB,以便为编码和消息其余部分留出空间。收件方服务器可能会有更小的限制。
邮件内容可保留多久?
启用内容存储后,原始已发送消息正文和附件最多可保留 30 天。邮箱请求头、提取的文本和邮箱附件遵循您套餐中可选的 30、90 或 365 天保留层级。原始邮箱正文和接收的原始 MIME 仍限于 30 天。
如何控制处理邮件的代理?
仅授予其工作所需的权限。让它准备和检查草稿,然后在授权发送前审核收件人、发件人和内容。请求速率限制有助于管理容量;权限和您的审核流程控制代理可以执行的操作。
可以同时发送事务性邮件和营销邮件吗?
可以,两者通过同一个发送 API 提交。唯一的区别是 category 字段,它决定了退订和取消订阅的适用规则。密码重置和收据选择 transactional,营销活动选择 marketing。
如果请求超时并重试会怎样?
每次逻辑发送时附带一个 Idempotency-Key 请求头。如果第一次请求已成功但您未收到响应,使用相同的密钥重放请求会返回原始结果并附带 Idempotency-Replay 头,而不会重复发送邮件。
可以定时发送邮件吗?
将 scheduled_at 设置为 30 秒到 30 天后的任意时间。发送请求会立即返回已接受状态,邮件保持计划状态直到发出,因此您可以在发送前随时取消。
可以添加附件吗?
可以,以 base64 编码放入 attachments 数组中。要在正文中内联显示图片,为其设置 content_id 并在 HTML 中通过 cid: 引用。原始文件大小请控制在 15 MB 以下,以确保编码后的邮件不超过 20 MB 上限,请注意可执行文件和脚本内容类型会在发送前被拒绝。
我可以保留现有的 SMTP 集成吗?
可以。通过 SMTP 中继提交邮件的应用可以通过更新主机、端口和凭据来使用 Bird。验证发送域,并使用启用了邮件发送权限的 API 密钥。
支持哪些 SMTP 端口?
使用端口 465 进行隐式 TLS,或使用端口 587 和 2525 进行 STARTTLS。根据你的 API 密钥区域选择主机。端口 25 不提供提交服务。
应该使用 SMTP 还是 Email API?
SMTP 适合已经构建 MIME 消息的现有应用。HTTP API 提供结构化请求字段和已存储模板操作。两者使用相同的域、信誉和投递控制。
SMTP 如何定价?
请查阅已发布的邮件定价,了解你的发送需求。我们的团队可以协助处理大批量或迁移需求;单独的 SMTP 协议不需要单独的邮件产品。
我的联系人和受众存储在哪里?
联系人归属于一个工作区。一条记录可以包含电子邮件地址、电话号码或两者兼有,还可以包含外部 ID 和带类型的属性。受众引用这些记录,因此更新联系人时,其在所有所属列表中的数据保持一致。
如何导入列表?
在控制台中上传 CSV、TSV 或 Excel 文件,导入前检查字段映射。您可以在导入时将联系人分配到受众。要进行应用同步,可通过 API 或 CLI 每次请求批量更新插入最多 1,000 个联系人。
受众是动态分组吗?
文档中记录的受众工作流使用静态成员:您手动添加或移除联系人。群发在开始发送时解析受众。使用您的应用或导入工作流来保持成员关系为最新状态。
支持哪些联系人属性类型?
定义文本、数字、布尔和日期时间属性,可选设置回退值。使用这些属性进行收件人个性化,并在导入或同步联系人时保持类型化的值一致。
如何定向群发?
选择一个已保存的受众。Bird 在开始发送时解析其当前成员,并应用相关的抑制规则和偏好设置。模板使用每位收件人已注册的联系人属性来个性化消息。
我可以定时发送或取消群发吗?
是的。控制台支持立即发送或最多提前一年定时发送,发送开始前可编辑和重新安排。取消已定时或正在发送的群发可以阻止尚未到达的收件人;已在途的消息无法撤回。
这和定时发送事务性消息一样吗?
两者的使用契约不同。群发为受众安排一次营销活动。消息 API 可定时发送内联内容,时间范围为 30 秒到 30 天,且不能将 scheduled_at 与已存储的模板组合使用。
我能否在不给客户发送邮件的情况下进行演练?
创建一个仅包含文档中记录的沙箱地址的独立受众。模拟结果会触发投递事件和 Webhook,但不会实际对外投递。沙箱流量仍会消耗发送额度并出现在指标中。
营销活动与 Email API 有什么关系?
邮件营销使用仪表板的群发编辑器,与事务性邮件共享相同的发送基础设施。准备受众、编写或选择内容、确认发件人并安排活动时间。开发者也可以使用 CLI 和 MCP 工作流。
如何处理同意和退订?
对营销活动使用营销类别,并仅向请求接收的用户发送。Bird 会应用收件人抑制和退出偏好。营销邮件支持一键退订请求头和正文中的退订链接;域身份验证和健康的列表仍然很重要。
可以衡量哪些指标?
查看活动的送达、打开、点击、退回和投诉数据。与隐私相关的图片请求会从报告的打开率中过滤掉,但打开或点击都不能证明产生了销售。请在你自己的应用中衡量已完成的客户行为。
我可以在这里构建自动化生命周期旅程吗?
本页面涵盖面向已保存受众的新闻通讯和定时群发。使用 Email API 构建事件触发的事务性发送。当前的活动工作流不提供可视化多步骤旅程构建器或原生 A/B 测试自动化。
必须使用可视化编辑器吗?
不需要。使用控制面板编辑器,或通过 CLI 和 MCP 工作流编写 HTML。React Email 的输出可以保存为 HTML,并保留 Bird 占位符。API、CLI 和 MCP 操作的是您在控制面板中看到的同一草稿和已发布版本。
个性化是如何工作的?
存储的模板支持 Liquid 和命名参数。普通参数名称是扁平的,例如 order_number。保留的 bird.contact 字段读取收件人属性。群发使用已注册的联系人属性,且不能使用模板循环;消息 API 支持更通用的模板发送。
我可以回滚模板吗?
可以。编辑会更改草稿。发布会创建一个不可变版本,供后续发送使用。回滚会选择一个之前发布的版本,并将草稿重置为该内容;已接受的发送保留其原有内容。
一个模板可以支持多种语言吗?
模板可以包含特定语言的主题、预览文本和正文内容。配置默认语言,并决定缺少某语言时是回退还是报错。发布前使用代表性的联系人值进行预览。
验证域名需要哪些记录?需要多长时间?
我们会为您生成所需记录:一条 DKIM TXT 记录用于签名邮件,一条 return-path CNAME 记录用于对齐 SPF(无需顶级域 SPF 记录),以及一条 DMARC TXT 记录。用于品牌化打开和点击链接的跟踪 CNAME 是可选的。添加域名,将记录粘贴到您的 DNS 服务商处,然后点击验证:大多数验证在 DNS 传播后几分钟内即可完成,偶尔可能需要更长时间。
DMARC 记录实际上起什么作用?
DMARC 告知接收服务器如何处理 DKIM 或 SPF 对齐失败的邮件,以及将显示谁在以您的域名发送邮件的聚合报告发送到哪里。我们要求在域名可以发送邮件之前必须设置 DMARC 记录,建议从 p=none 开始,即仅监控而不影响投递。一旦您确认所有合法来源都已对齐,再将策略收紧到 p=quarantine 或 p=reject。如果您的域名或父域名已发布了 DMARC,我们会直接使用。主要邮箱服务商现在要求批量发送者发布策略,因此拥有 DMARC 记录越来越成为大规模送达收件箱的必要条件。
我可以从子域名发送,或使用多个域名吗?
两者都可以,我们推荐使用专用子域名,因为它可以将您的邮件信誉与企业邮件隔离开来。您还可以为事务性邮件和营销邮件分别使用不同域名,或每个品牌一个域名,各自拥有独立的身份验证和信誉。
什么时候应该切换到专用 IP?需要自己做预热吗?
当您的发送量稳定且需要控制自身 IP 声誉时,可以考虑使用独立 IP。发送量低或不规律的发送者使用共享池可能更合适。Bird 会在大约 30 天内自动预热新的独立 IP,预热期间溢出流量通过共享基础设施路由。选择前请与邮件专家确认您的发送模式。
我可以将事务性邮件和营销邮件的流量分开吗?
可以。将 IP 分组为池,并将每种流量类型路由到各自的池。这样可以隔离承载营销活动和事务性流量的 IP。身份验证、域声誉和收件人互动对两者都很重要。
Bird 可以帮助我控制什么?
Bird 提供域身份验证、带托管预热的独立 IP 池、收件人抑制、偏好设置和发送指标。您的团队控制授权同意、内容和发送行为。Inbox Insights 单独衡量到达率。
如何排查指标下降?
使用统计 API 和控制台查看退信原因、投诉、发送域和邮箱提供商细分。在邮件日志中检查特定收件人。使用 Inbox Insights 调查到达率估算并运行营销活动种子测试。
健康分级会自动暂停发送吗?
不会。Healthy、Watching 和 Throttled 对发送风险进行分级,但不会改变您的发送速率或暂停流量。请排查受影响的营销活动或列表,并决定是否暂停。
退信、投诉或退订后会发生什么?
硬退信会创建一条抑制记录,阻止向该地址发送邮件。投诉会阻止非事务性邮件。退订会单独记录偏好。事务性邮件的投递仍取决于地址是否有效以及是否存在其他阻止记录。
哪些收件人会被自动抑制?
硬退回会为所有邮件创建抑制;投诉会为非事务性邮件创建抑制。手动抑制会阻止所有类别。软退回和延迟不会创建永久的收件人抑制。
退订算是抑制吗?
退订会在偏好设置选项卡中记录收件人的偏好。它与抑制列表是分开的。在决定是否投递时两者都会被检查,删除联系人不会清除其退出记录。
我可以移除或测试屏蔽记录吗?
在查明原因后,您可以通过控制面板或 API 移除屏蔽记录。移除一条屏蔽记录不会移除其他拦截记录或退订偏好。suppressed@messagebird.dev 沙盒地址允许您在不更改列表的情况下测试被拒收件人。
如何使用 Bird 验证邮箱地址?
使用 Email Lookup,配合具有 lookup 权限的 API 密钥。提交一个地址并读取其结果、投递置信度、风险标记以及拼写建议。仪表板、SDK 和 CLI 提供了尝试相同查询的方式。
我的集成应处理哪些判定结果?
文档记录的结果有 valid、neutral、risky、undeliverable 和 typo。将 result 视为开放词汇表,使用投递置信度处理未来的新值。单独的 valid 布尔值检查的是地址格式和域设置,而非邮箱是否存在。
收到 typo 或 neutral 结果时该怎么做?
向用户展示拼写建议让其确认;不要默默替换其地址。neutral 表示无法确认也无法否认该邮箱的存在。将结果和置信度与你的同意和发送策略结合使用。
验证能否保证投递成功或发送许可?
不能。查询有助于评估当时的地址质量,但不能建立同意、移除退出偏好或保证进入收件箱。请继续遵守抑制和偏好记录。
我可以在这里上传列表吗?
本页面介绍单地址 Lookup 工作流。对于较大的列表,请将单个查询集成到你的导入流程中并审查结果。如需讨论批量需求请联系销售团队;本页面不提供不受支持的批量上传产品。
我可以查看哪些指标?
查看投递、已记录的打开和点击、退信、投诉以及延迟。细分维度涵盖发送域、收件人域、邮箱提供商、标签、模板和群发。发送 IP 细分展示投递信号;互动数据不会归因到承载消息的 IP。
指标数据有多新?
统计数据会对事件流进行短暂延迟的聚合,并返回 data_as_of。数据使用事件时间,因此今天的一次点击可能属于更早发送的消息。每日和每小时端点支持统计指南中记录的时间窗口。
这些报告显示收件箱到达率或收入吗?
投递是指接收服务器接受了消息。使用 Inbox Insights 获取到达率估算,使用 Competitive Insights 查看面板观测到的竞争对手活动。要了解收入或激活情况,请在您自己的应用中将营销活动上下文与已完成操作关联。
试用入站邮件需要更改我的域名吗?
不需要。创建一个 Bird 转发地址,并从现有收件箱转发邮件。当您希望邮件直接发送到您控制的子域名时,请使用域名接收。
我可以在自己的域名上接收邮件吗?
可以。注册并验证一个专用子域名,启用接收功能并发布其提供的 MX 记录。使用接收子域名,将企业邮件路由与之分开。
我的应用程序如何获知收到的邮件?
订阅 email.received Webhook,或通过入站消息 API 读取消息。处理事件时请遵循 Webhook 验证和重试指南。
入站邮件与 Agent Mailboxes 有什么区别?
入站邮件解析到达转发地址或接收域名的消息,供您的应用程序处理。Agent Mailboxes 提供由代理拥有的收件箱,支持消息线程和回复工作流。
代理邮箱与入站邮件有什么区别?
入站邮件提供解析后的消息、附件和 Webhook。代理邮箱增加了持久地址、对话线程、接收规则和回复或撰写操作,使应用程序可以持续进行对话。
我可以使用自己的域名吗?
可以,需要一个已启用接收功能的发送域。你也可以使用生成的 inbox.ai 地址,或在套餐允许时使用自定义前缀。inbox.ai 地址在删除后仍保留给你的工作区,不会被重新分配给其他客户。
邮箱内容可保留多长时间?
请求头、提取文本和附件遵循套餐支持的保留层级。原始邮件正文和接收的原始 MIME 有 30 天的窗口期。更高的保留层级不会延长该原始内容窗口期,也不会恢复已删除的内容。
代理能否在不轮询的情况下监听?
使用邮箱 webhook 来响应收件箱消息。SSE 流也可用于实时视图,但断开连接后不会重放错过的事件。使用列表端点来补全数据;接收规则决定哪些来信会生成收件箱 webhook。
这个产品叫 Inbox Tracker 还是 Inbox Insights?
Inbox Insights 是当前的 Bird 仪表板产品。旧的 Inbox Tracker 产品链接会跳转到此处。如果您有现有的 eDataSource 或旧版 Tracker 账户,请使用该账户的文档和支持渠道;其功能和访问权限可能不同。
收件箱投放率与投递率有什么区别?
投递率记录的是接收服务器接受消息。Inbox Insights 通过种子和测量面板估算收件箱投放和垃圾邮件投放,同时结合您通过 Bird 测量的投递和互动数据。
开始使用需要什么?
使用有权访问 Inbox Insights 的工作区和已验证的发送域名。为该域名启用跟踪。部分域名或提供商尚无面板测量数据;种子测试需要可用的地址池和配额。
创建种子测试会发送我的营销活动吗?
不会。注册会为您提供种子地址。在发送截止日期前将它们加入您的营销活动。当这些邮箱收到邮件后,结果才会显示;即使未发送任何营销活动,注册也会消耗配额。
完成的种子测试可以查看什么?
查看该营销活动在各测量提供商的投放位置、其 SPF、DKIM 和 DMARC 结果,以及在测试使用了两个群组时的活跃与非活跃用户分布。
我可以通过公共 API 使用 Inbox Insights 吗?
Inbox Insights 是一个仪表板产品。其内部端点不作为公共 API 提供。请使用 Email stats API 进行您自己的投递和互动报告。
Competitive Insights 是当前的产品名称吗?
是的。Competitive Insights 是当前 Bird 控制台中用于观察品牌和比较邮件项目的功能。旧版 Competitive Tracker 产品链接会导向此处。现有旧版账户可能具有不同的功能集和访问路径。
这些数据涵盖竞争对手发送的所有邮件吗?
不涵盖。面板观测的是邮箱样本并估算结果。被观测的品牌使用其发送量最大的发送域,因此其他域上的活动不包含在内。发送量小或较新的发送者可能没有测量数据。
我能看到竞争对手的实际邮件吗?
营销活动动态中包含捕获的主题行和创意图片(如有)。部分观测到的营销活动没有图片。此功能不提供每封竞争对手邮件的可搜索副本或其完整客户旅程。
我能将竞争对手的阅读率与我的打开率进行比较吗?
请将它们视为不同的衡量方式。竞争对手阅读率由面板估算;Bird 打开追踪的计算方式不同。控制台会标注面板估算值和您自己的发送数据,以便您正确解读。
我能看到竞争对手使用的平台吗?
品牌资料会在面板已知的情况下显示其邮件服务提供商。缺失的提供商信息保持为空白,而非猜测。
如何开始?
在具有访问权限的工作区中打开 Competitive Insights,通过名称或域名添加品牌并查看观察列表。您的组织配额决定了可以观察的品牌数量。演示可以帮助您在制定计划前评估覆盖范围。
Momentum MTA 和 PowerMTA 有什么区别?
两者都是本地部署的 MTA,由您自行运行,而非通过我们的托管 API 发送。Momentum MTA 围绕可自定义的工作流和路由构建,适用于大批量发送。PowerMTA 则设计为在您自己的服务器或任何公有云(如 AWS 或 Azure)上运行。
这适合谁?使用 Inbox Insights 或 Competitive Insights 需要自行运行 MTA 吗?
适合因基础设施或合规要求需要自行运行 MTA 的团队,以及希望独立了解收件箱投放和竞争基准而非仅依赖自身发送指标的团队。前者运行 Momentum MTA 或 PowerMTA。后者使用 Inbox Insights(估算收件箱投放并支持种子测试)或 Competitive Insights(将您的项目与其他品牌进行基准对比),两者都无需自托管任何内容。
SparkPost 怎么了?我需要迁移吗?
SparkPost 属于 Bird。Bird Email 为新项目提供发送、活动和投递工作流。现有的 SparkPost 集成是独立的集成:在规划迁移之前,请与你的客户团队一起审查其 API 调用、域记录和事件。
API 和 SparkPost 的一样吗?
Bird Email 有自己的 API 和 SDK。请查阅发送、模板、域和 webhook 指南,不要假设 SparkPost 请求可以原样发送。
什么是 Momentum MTA?
Momentum 是我们面向大批量发送的本地部署邮件基础设施平台,通过其 Policy Manager 提供可自定义的工作流、路由和投递参数。它能随发送量扩展并保持稳定性能,且支持完整 Unicode(SMTPUTF8),可发送至国际字符集地址。
什么是 Adaptive Delivery?如何监控它?
Adaptive Delivery 是 Momentum 的自动流量整形功能。它监测每个邮箱服务商对您邮件的响应,并实时调整:限流、延迟或短暂暂停某条发送流以保护您的信誉,待情况好转后再恢复发送速率。您无需为每个服务商手动调控发送速率即可达到收件箱。Intelligence Router 可跨所有数据源展示这些调整过程,并在每次调整时发出实时警报。
Momentum 可以在云端运行吗?还在持续开发吗?
两者皆是。Momentum 可运行在您自己的服务器、任何主流云平台,或混合部署,以匹配您的基础设施、成本和合规需求,并可随时调整配比。它也在持续更新:近期版本保持对现代操作系统、TLS 1.3 以及最新安全和 SMTP 标准的支持,并通过实时 API 暴露消息事件,供您接入自有报告和自动化系统。
PowerMTA 可以和托管平台同时使用吗?发送 IP 由谁控制?
可以。PowerMTA 可以将部分流量中继到托管的 Bird Email API,其余流量直接从您自己的服务器发送——这是试用托管平台或逐步迁移最简单的方式,无需一次性全部迁移。PowerMTA 本身运行在您自有的基础设施上,这些 IP 由您自行管理。中继到托管平台的流量可以使用我们的 IP,也可以使用您的专用 IP,其他一切完全由您掌控。
什么是虚拟 MTA?
虚拟 MTA 允许你在一个 PowerMTA 实例内运行多个独立的发送流,每个流有自己的 IP、信誉和限制。用它们分别管理事务性邮件、营销邮件或不同客户。共享域和收件方提供商的策略仍可能影响跨流的投递。
我的邮件是否加密?数据存储在哪里?
是的。API 仅支持 HTTPS。如果你通过 SMTP 提交,端口 465 从第一个字节开始加密,端口 587 和 2525 通过 STARTTLS 升级:在升级完成之前我们拒绝这些端口上的 AUTH,因此凭据不会以明文传输。端口 25 不提供提交服务。使用与你的 API 密钥匹配的区域端点。官方 SDK 和 CLI 会读取其区域前缀并选择对应端点。请查阅区域指南和你的数据处理协议,了解适用于你组织的存储和处理承诺。
API 密钥能做什么?可以限制权限吗?
仅限你为其设定的权限范围。密钥包含一组权限范围,如 emails、email_marketing 或 domains,每项为 read 或 write,因此仅能发送邮件的密钥无法管理你的发送域。管理成员、工作区设置、密钥和 IP 池需要通过仪表板或已授权的 CLI 或 MCP 会话使用个人权限。每个密钥还支持 CIDR 范围白名单,来自其他地址的请求将被拒绝。
如何在不停机的情况下轮换密钥?
轮换会签发新密钥,同时保留旧密钥在宽限期内可用(默认 24 小时),以便你在部署中逐步替换。传入零可立即撤销旧密钥。旧密钥保留其先前的过期时间。替换密钥初始没有过期时间,如果你的应用需要,请显式设置。
我的团队可以通过自有身份提供商登录吗?
可以,支持 SAML 2.0 或 OIDC,因此 Okta、Microsoft Entra ID 和 Google Workspace 都可以使用。配置按组织进行:您的客户团队会为您开通。使用密码登录的成员可以自行开启 MFA。
是否有审计日志记录谁更改了什么?
是的。审计日志是只读的、组织范围的管理操作记录,包含操作者、工作区、时间和结果,并支持导出为 OCSF 格式以接入您自己的 SIEM。它记录的是配置变更,而非您发送的邮件内容。邮件内容记录在邮件日志中。
在哪里获取你们的安全和数据保护文件?
认证和安全文档发布在信任中心 trust.bird.com。数据处理协议、隐私声明和可接受使用政策发布在 bird.com/legal,包含当前版本以及已替代版本的存档。如需供应商调查问卷,您的客户团队会负责处理。
付诸实践。
继续查阅此主题的文档、指南和示例。资源为英文。
将您的邮件计划付诸实践。
发送一封测试邮件,完成您的设置。如果您有更大规模的发送计划,请与我们的团队讨论集成、迁移和支持需求。