群发邮件

群发邮件会向整个受众发送一封邮件：新闻通讯、公告，或任何需要同时发送给众多收件人的单条内容。发送开始时，我们会将受众成员解析为收件人列表，因此群发会覆盖该时刻受众中的所有成员。

在仪表板的 Email > Broadcasts 中创建群发邮件，也可通过 /v1/email/broadcasts 或 bird email broadcasts 创建。SDK 不包含群发方法。如需一次性收件人列表，请使用批量发送或单条发送。

在 Broadcasts 列表中点击 New broadcast 开始。编辑器是一个单页面：顶部是受众和发件人栏，下方是邮件内容，还有一个用于设置类别、跟踪和标签的设置控件。无需单独保存。群发设置了受众和发件人后，每次更改都会自动保存，因此草稿在这两项设定完成后立即存在，之后发送是独立的显式操作。

使用 To 字段选择受众，或选择 New 在不离开编辑器的情况下新建一个受众。

在编辑器顶栏打开设置控件，可配置以下三项：

群发邮件从已验证发送域名上的地址发出。将本地部分与您的某个已验证域名配对，并根据需要添加显示名称。如果希望回复发送到其他地址，可添加 Reply-To 地址。选择 Review 时，如果域名未验证，系统会发出警告。

群发邮件指向工作区中的某个邮件模板，模板包含群发的主题行和正文。发送时，每个收件人的联系人属性会填充模板中的变量，因此一次群发可以为每个收件人个性化内容。群发只能填充联系人属性，因此模板变量如果引用了其他内容，发送时会被拒绝，错误信息会指出该变量名称。

在主题行下方的画布中直接编写内容，或选择 Choose a template 从现有模板开始。此选项仅在群发内容为空时可用，因为在已编写主题或正文后选择模板会覆盖已有内容。群发发送的是模板的已发布版本，因此只有草稿的模板无法用于发送。

发送是独立的显式操作，可通过编辑器的 Review 按钮或群发详情页的 Send or reschedule 触发。两者都会打开一个对话框，检查群发是否完整，警告可能导致发送失败的问题，然后让您选择 Send now 或选择最多一年内的未来时间。已安排的群发仍可编辑，在发送实际开始之前都可以重新安排时间。

发送时会检查受众中是否仍有可到达的对象。如果受众中没有人拥有邮箱地址，或所有地址均已被屏蔽，此时会被拒绝，而不是稍后失败。

发送时会检查两个组织级别的限制。

第一个是在一个计费周期内可以发送多少次群发。您的套餐决定了该数量。已保存的草稿不计入此限额，取消群发也不会退还配额。用完后，您只能等待下一个计费周期，或升级到限额更高的套餐。

第二个限制并发群发数量。如果在达到限额时选择 Send now，请求会被拒绝。已安排的群发会等待空闲槽位。

按标签或模板名称搜索列表，或按状态、受众或日期范围筛选。日期范围按每次群发的创建时间筛选，而非发送时间，因此上周安排的、下月发送的群发仍会显示在 "Last 7 days." 下

通过表格上方的按钮将当前视图导出为 CSV。超过 50,000 行时，导出会被拒绝而非静默截断。请缩小筛选范围后重试。

群发始终处于四个阶段之一，列表上的 Status 筛选器使用这四个阶段：

每行的徽标显示其阶段内的确切状态。该值也是 API 的 status 字段返回的值。

在群发详情页取消已安排或正在发送的群发。尚未到达的收件人会被跳过，已在途的邮件无法撤回。删除仅适用于草稿，且操作不可恢复。

失败的群发会在其详情页显示原因：先是原因类别，然后是一句话说明具体原因。通过 API，这两项分别对应 failure_reason 和 failure_detail 字段。failure_detail 用于告知您在某个原因类别的多种具体原因中实际触发了哪一种。

群发的发送配置仅在发送开始时进行检查。如果发送域名在安排时已验证但在发送前失去了验证，群发会在此时失败。请重新验证域名并再次发送该群发。

群发邮件和单条发送共用相同的邮件配额。组织计费概览中的套餐卡片显示已使用的额度。套餐与定价介绍了各套餐包含的内容。

发送开始后，群发的 Overview 选项卡显示收件人数量和已发送数量，以及投递率、打开率、点击率、退信率和投诉率及其对应的数量。Recipients 选项卡列出每个收件人及其投递状态、未投递的原因、投递时间，以及打开和点击情况。搜索框要求输入完整、有效的邮箱地址；部分地址或域名会验证失败，搜索框标记为无效，表格保持之前的显示内容不变。表格上方的按钮可将该选项卡导出为 CSV，上限为 200,000 行，采用与群发列表导出相同的拒绝而非截断策略。Events 选项卡是群发的原始事件流，使用事件和 Webhook 中描述的事件类型。

在受众中加入一个沙盒地址，该联系人会被模拟而非实际发送：delivered@messagebird.dev 报告已投递，bounce@messagebird.dev 报告退信，每种都会产生与真实收件人相同的事件和 Webhook。这样您可以测试活动及其事件处理程序，而无需实际发送邮件。受众可以混合沙盒联系人和真实联系人；每个联系人有各自独立的结果。模拟收件人仍计入发送配额，因此预演消耗的配额与正式发送相同。