跳到主要内容

Mailchimp

将 Mailchimp 受众与 B1 自动同步：人员随他们的姓名、电子邮件和电话流入；小组和列表成员资格成为 Mailchimp 标签；已删除的人员被存档。同步内置于 B1 — 没有第三方服务、没有按任务计量，更改以近乎实时的方式到达，而不是在每晚计划上。

开始之前

  • 一个 Mailchimp 帐户，带有您想要 B1 管理的受众
  • Mailchimp API 密钥（Mailchimp：资料图标 → 帐户和计费 > 额外功能 > API 密钥）
  • 您的受众 ID（Mailchimp：受众 > 设置 > 受众名称和默认值）
  • 具有编辑设置权限的 B1Admin 用户

什么同步​

B1 更改Mailchimp 效果
添加或更新人员添加/更新订阅者（名字、姓氏、电话；新订阅者以subscribed形式到达）
删除人员（或 GDPR 删除）订阅者已存档
人员加入小组以小组名称添加标签
人员离开小组删除该标签
人员进入保存列表以列表名称添加标签
人员离开保存列表删除该标签

保存列表通常是更好的标签源。 B1 保存列表是一个基于规则重新评估自己的受众 — "北校区的所有人"、"选择加入牧教电子邮件的成员"。将您的 Mailchimp 细分指向列表标签，同步保持它们；为事工团队邮件使用小组标签。

同步是单向的（B1 → Mailchimp）并且只触及 Mailchimp 的标准字段，因此它不能与您在 Mailchimp 中管理的合并字段或细分冲突。

设置​

  1. 在 B1Admin 中转到设置 > 开发人员 > Webhooks > 添加 Webhook。
  2. 将连接器类型设置为 Mailchimp。
  3. 粘贴您的Mailchimp API 密钥和受众 ID。密钥存储为加密形式，永远不会再显示。
  4. 相关事件是预先选择的；取消勾选您不想要的（例如保持人员事件开启但跳过小组标签）。
  5. 保存。B1 在接受前对 Mailchimp 验证密钥和受众 — 打字错误立即失败并提供原因。

随时使用发送测试重新验证连接。每个同步尝试都记录在 webhook 的交付历史中，包含 Mailchimp 的实际响应，失败的交付会自动重试，大约五天的退避。

初始导入​

连接器从其打开的那一刻起同步更改；它不会回填您的现有目录。对于设置日：

  1. 在 B1Admin 中转到人员，搜索您想要的人员（或运行保存列表），然后单击导出以下载 CSV。
  2. 在 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 添加订阅者到标签 (Gave-2026)
  • 双向： Mailchimp 新订阅者 → B1 创建人员

如果您之前通过 Zapier 连接人员/小组同步，启用本机连接器后关闭这些 Zaps — 同时运行两个双进程每个事件并为空燃烧 Zapier 任务。

故障排查​

  • 保存失败"Mailchimp 拒绝 API 密钥" — 密钥被撤销或打字错误。密钥必须以数据中心后缀（如-us21）结尾。
  • 保存失败"受众未找到" — 受众 ID 在该帐户下不存在。从受众 > 设置 > 受众名称和默认值复制它（它不是受众的名称）。
  • 人员从未出现在 Mailchimp 中 — 检查 webhook 的交付历史。"跳过：人员没有电子邮件地址"意味着正好那样；来自 Mailchimp 的4xx在响应体中显示原因。
  • 交付完全停止 — 在重复的耗尽交付后，webhook 自动禁用。修复原因（通常是已撤销的密钥），重新启用它，并使用发送测试确认。