Mailchimp
将 Mailchimp 受众与 B1 自动同步：人员数据（包括姓名、电子邮件和电话）流入；组和列表成员资格变为 Mailchimp 标签；删除的人员会被存档。同步已集成到 B1 中——无需第三方服务、无需按任务计费，变更以接近实时的方式到达，而不是每晚一次。
开始之前
- 一个 Mailchimp 账户，其中包含您希望 B1 管理的受众
- 一个 Mailchimp API 密钥（Mailchimp：个人资料图标 → 账户和账单 → 额外项 → API 密钥）
- 您的受众 ID（Mailchimp：受众 → 设置 → 受众名称和默认值）
- 拥有编辑设置权限的 B1Admin 用户
同步内容
| B1 变更 | Mailchimp 效果 |
|---|---|
| 人员添加或更新 | 订阅者已添加/更新（名字、姓氏、电话；新订阅者显示为 已订阅） |
| 人员删除（或 GDPR 擦除） | 订阅者存档 |
| 人员加入组 | 添加以组命名的标签 |
| 人员离开组 | 移除该标签 |
| 人员进入已保存列表 | 添加以列表命名的标签 |
| 人员离开已保存列表 | 移除该标签 |
已保存列表通常是更好的标签来源。 B1 已保存列表 是一个基于规则的受众，可以重新评估——"北校区的所有人"、"选择牧关电子邮件的成员"。将您的 Mailchimp 段指向列表标签，同步会维护它们；为事工团队邮件使用组标签。
同步是单向的（B1 → Mailchimp），仅涉及 Mailchimp 的标准字段，因此不会与您在 Mailchimp 内部管理的合并字段或段冲突。
设置
- 在 B1Admin 中，转到设置 → 开发者 → Webhooks → 添加 Webhook。
- 将连接器类型设置为 Mailchimp。
- 粘贴您的 Mailchimp API 密钥和受众 ID。密钥存储已加密，不会再显示。
- 相关事件已预选；取消选中任何您不想要的（例如，保留人员事件但跳过组标签）。
- 保存。B1 在接受前会验证 Mailchimp 的密钥和受众——任何输入错误会立即失败并显示原因。
随时使用发送测试重新验证连接。每次同步尝试都会记录在 webhook 的交付历史中，包括 Mailchimp 的实际响应，失败的交付会自动重试，并在约五天内进行指数退避重试。
初始导入
连接器从启用之刻开始同步变更；它不会填充您现有的目录。对于设置日：
- 在 B1Admin 中，转到人员，搜索您想要的人员（或运行已保存列表），然后单击导出下载 CSV。
- 在 Mailchimp 中，使用受众 → 导入联系人加载 CSV，在导入期间应用任何标签。
通过 Mailchimp 的导入器进行初始加载使您能够控制同意问题——仅导入已真正同意接收您电子邮件的人员。批量导入整个目录作为已订阅联系人可能会违反 Mailchimp 的条款和反垃圾邮件法（CAN-SPAM/GDPR）。
限制和注意事项
- 单向同步。 Mailchimp 中的取消订阅、退回和编辑不会流回 B1。在 Mailchimp 中取消订阅的人仍然可以接收直接从 B1 发送的电子邮件——将 Mailchimp 视为大批量邮件同意的真实来源。
- 没有电子邮件地址的人员会被跳过（在交付历史中记录为此）——Mailchimp 订阅者由电子邮件键入。
- 电子邮件地址更改会创建新订阅者。 Mailchimp 通过电子邮件识别人员，因此在 B1 中更改某人的电子邮件会在新地址下添加他们；旧订阅者会保留到您在 Mailchimp 中存档它。
- 仅同步标准字段——名字、姓氏、电话。成员资格状态、校区和自定义 B1 字段在此版本中不映射到 Mailchimp 合并字段；改为使用列表标签进行段。
- 标签名称是组/列表名称。 重命名组或列表会在新名称下开始标记；旧标签会保留在现有订阅者上，直到在 Mailchimp 中移除。
- Mailchimp 的联系人限制仍然适用——将免费层受众推送超过其上限的同步将在交付历史中记录
已达到成员限制错误。
其他配方（Zapier / Make）
超出受众同步范围的任何操作——在 donation.created 时标记捐赠者、Mailchimp → B1 反向方向，或同步到完全不同的电子邮件平台（Constant Contact、Brevo 等）——仍然可以通过 Zapier 或 Make 进行，这些在相同的 webhook 事件上触发：
- 标记捐赠者： B1 新捐赠 → B1 查找人员 → Mailchimp 将订阅者添加到标签（
已捐赠-2026） - 双向： Mailchimp 新订阅者 → B1 创建人员
如果您之前通过 Zapier 连接了人员/组同步，启用本地连接器后关闭那些 Zaps——同时运行两者会重复处理每个事件，并浪费 Zapier 任务。
故障排除
- 保存失败，显示"Mailchimp 拒绝了 API 密钥"——密钥已被撤销或输入错误。密钥必须以数据中心后缀（如
-us21）结尾。 - 保存失败，显示"找不到受众"——受众 ID 在该账户下不存在。从受众 → 设置 → 受众名称和默认值复制它（不是受众的名称）。
- 一个人从未出现在 Mailchimp 中——检查 webhook 的交付历史。"已跳过：人员没有电子邮件地址"意思就是这样；来自 Mailchimp 的
4xx会在响应主体中显示原因。 - 交付完全停止——在重复失败交付后，webhook 会自动禁用。修复原因（通常是撤销的密钥），重新启用它，并使用发送测试确认。
另请参阅
- Webhooks（开发者参考）——底层引擎、事件目录、交付/重试语义
- 已保存列表——基于规则的受众，自然地映射到 Mailchimp 标签
- Zapier（概述）——用于超出受众同步范围的配方