Перейти до основного вмісту

Mailchimp

Автоматично синхронізуйте аудиторію Mailchimp із B1: люди надходять разом з іменем, електронною адресою та телефоном; членство в групах і списках стає тегами Mailchimp; видалені люди архівуються. Синхронізація вбудована в B1: без стороннього сервісу, без оплати за кожне завдання, а зміни надходять майже в режимі реального часу, а не за нічним розкладом.

Перш ніж почати

  • Обліковий запис Mailchimp з аудиторією, якою має керувати B1
  • Ключ API Mailchimp (Mailchimp: значок профілю → Account & billing → Extras → API keys)
  • Ваш Audience ID (Mailchimp: Audience → Settings → Audience name and defaults)
  • Користувач B1Admin з дозволом Edit Settings

Що синхронізується​

Зміна в B1Ефект у Mailchimp
Людину додано або оновленоПередплатника додано або оновлено (ім'я, прізвище, телефон; нові передплатники отримують статус subscribed)
Людину видалено (або стерто відповідно до GDPR)Передплатника архівовано
Людина приєдналася до групиДодано тег з назвою групи
Людина вийшла з групиЦей тег видалено
Людина потрапила до збереженого спискуДодано тег з назвою списку
Людина вийшла зі збереженого спискуЦей тег видалено

Збережені списки зазвичай є кращим джерелом тегів. Збережений список у B1 це аудиторія на основі правил, яка сама себе перевіряє: «усі з північного кампусу», «члени, які погодились на пасторські листи». Прив'яжіть свої сегменти Mailchimp до тегів списків, і синхронізація підтримуватиме їх актуальними. Теги груп використовуйте для розсилок команд служіння.

Синхронізація є односторонньою (B1 → Mailchimp) і змінює лише стандартні поля Mailchimp, тож вона не може конфліктувати з полями злиття чи сегментами, якими ви керуєте всередині Mailchimp.

Налаштування​

  1. У B1Admin перейдіть до Settings → Developer → Webhooks → New Webhook.
  2. Встановіть Connector Type на Mailchimp.
  3. Вставте Mailchimp API Key та Audience ID. Ключ зберігається у зашифрованому вигляді і більше не відображатиметься.
  4. Відповідні події вже вибрано. Зніміть позначку з тих, що не потрібні (наприклад, залиште події людей увімкненими, але пропустіть теги груп).
  5. Збережіть. Перед прийняттям B1 перевіряє ключ і аудиторію в Mailchimp. Помилка в друку призведе до негайної відмови з поясненням.

Скористайтеся Send Test, щоб будь-коли повторно перевірити з'єднання. Кожна спроба синхронізації записується в історію доставок вебхука разом із фактичною відповіддю Mailchimp. Невдалі доставки автоматично повторюються з поступовою затримкою приблизно протягом п'яти днів.

Початковий імпорт​

Коннектор синхронізує зміни з моменту ввімкнення. Він не заповнює задним числом вашу наявну базу людей. Для дня налаштування:

  1. У B1Admin перейдіть до People, знайдіть потрібних людей (або запустіть збережений список) і натисніть Export, щоб завантажити CSV-файл.
  2. У Mailchimp скористайтеся Audience → Import contacts, щоб завантажити CSV, застосувавши потрібні теги під час імпорту.

Початкове завантаження через імпортер Mailchimp допомагає зберегти контроль над питанням згоди. Імпортуйте лише тих людей, які справді погодились отримувати ваші листи. Масовий імпорт усього каталогу як передплатників може порушувати умови Mailchimp і антиспамове законодавство (CAN-SPAM/GDPR).

Обмеження та примітки​

  • Одностороння синхронізація. Відписки, відмови від доставки та зміни, внесені в Mailchimp, не передаються назад у B1. Людина, яка відписалася в Mailchimp, може все одно отримувати листи, надіслані безпосередньо з B1. Тож вважайте Mailchimp джерелом істини щодо згоди на масові розсилки.
  • Люди без електронної адреси пропускаються (про це записується в історію доставок), адже передплатники Mailchimp ідентифікуються за адресою електронної пошти.
  • Зміна електронної адреси створює нового передплатника. Mailchimp ідентифікує людей за електронною адресою, тож якщо змінити адресу людини в B1, її буде додано під новою адресою. Старий передплатник залишиться, доки ви не архівуєте його в Mailchimp.
  • Синхронізуються лише стандартні поля: ім'я, прізвище, телефон. Статус членства, кампус і користувацькі поля B1 у цій версії не відповідають полям злиття Mailchimp. Для сегментації використовуйте теги списків.
  • Назви тегів збігаються з назвами груп або списків. Перейменування групи чи списку призведе до тегування під новою назвою. Старий тег залишиться на наявних передплатниках, доки його не буде видалено в Mailchimp.
  • Обмеження контактів Mailchimp і далі діють. Якщо синхронізація перевищить ліміт аудиторії безплатного тарифу, в історії доставок з'являться помилки Member limit reached.

Інші рецепти (Zapier / Make)​

Усе, що виходить за межі синхронізації аудиторії, як-от позначення донорів тегом за подією donation.created, зворотний напрямок Mailchimp → B1 або синхронізація з іншою платформою електронної пошти (Constant Contact, Brevo тощо), і далі доступне через Zapier або Make. Вони запускаються за тими самими подіями вебхука:

  • Позначення донорів: B1 New Donation → B1 Find Person → Mailchimp Add Subscriber to Tag (Gave-2026)
  • Двосторонній: Mailchimp New Subscriber → B1 Create Person

Якщо ви раніше налаштовували синхронізацію людей і груп через Zapier, вимкніть ці Zap після ввімкнення вбудованого коннектора. Робота обох одночасно призводить до подвійної обробки кожної події та марно витрачає завдання Zapier.

Усунення несправностей​

  • Збереження не вдається з повідомленням "Mailchimp rejected the API key": ключ було відкликано або введено з помилкою. Ключі мають закінчуватися суфіксом дата-центру, наприклад -us21.
  • Збереження не вдається з повідомленням "audience not found": Audience ID не існує в цьому обліковому записі. Скопіюйте його з Audience → Settings → Audience name and defaults. Це не назва аудиторії.
  • Людина ніколи не з'являлася в Mailchimp: перевірте історію доставок вебхука. Повідомлення "Skipped: person has no email address" означає саме це. Помилка 4xx від Mailchimp покаже причину у тілі відповіді.
  • Доставки повністю зупинилися: після повторних вичерпаних доставок вебхук автоматично вимикається. Усуньте причину (зазвичай відкликаний ключ), увімкніть вебхук знову та скористайтеся Send Test, щоб переконатися.

Дивіться також​

  • Webhooks (довідка для розробників): рушій, що лежить в основі, каталог подій, семантика доставки та повторних спроб
  • Saved Lists: аудиторії на основі правил, які природно відповідають тегам Mailchimp
  • Zapier (огляд): для рецептів, що виходять за межі синхронізації аудиторії