Make
Make (раніше Integromat) — це візуальна платформа для автоматизації робочих процесів, схожа на Zapier, але з гнучкішою логікою та нижчою вартістю при великих обсягах. Офіційний застосунок B1.church для Make дає змогу створювати «сценарії», які миттєво реагують на події B1 і записують дані назад у B1.
Перш ніж почати
- Обліковий запис у Make (безкоштовного тарифу достатньо для невеликих робочих процесів)
- Адміністратор церкви з дозволом Edit Settings (Редагування налаштувань) у B1Admin
- Загальне уявлення про сценарій, який ви хочете створити
Модулі
| Тип | Що робить | Подія B1 / кінцева точка |
|---|---|---|
| Instant Trigger | Watch Events (Стеження за подіями) | будь-яка передплачена подія B1 (person.created, donation.created, …) |
| Action (Дія) | Create Person (Створити особу) | додає нову особу |
| Action (Дія) | Add Donation (Додати пожертву) | записує пожертву |
| Action (Дія) | Add Group Member (Додати учасника групи) | додає особу до групи |
| Search (Пошук) | Search People (Пошук людей) | знаходить людей за іменем або електронною адресою |
Миттєвий тригер дає змогу вибрати, яку подію відстежувати: один модуль-тригер на сценарій, який налаштовується для кожної події.
Налаштування
1. Створіть ключ API B1
- У B1Admin перейдіть до Settings → Developer → API Keys (Налаштування → Розробник → Ключі API).
- Натисніть New API Key (Новий ключ API), назвіть його «Make» і надайте потрібні дозволи (scopes).
- Додайте
settings:write, якщо будь-який із ваших сценаріїв використовує миттєвий тригер: Make реєструє вебхук від вашого імені, коли сценарій вмикається. - Також надайте дозволи, які потрібні модулям дій (наприклад,
donations:writeдля модуля Add Donation). - Збережіть і скопіюйте ключ
cak_….
2. Встановіть підключення
- У Make створіть новий сценарій і перетягніть модуль-тригер B1.church на полотно.
- Коли з'явиться запит, виберіть Create a connection (Створити підключення). Вставте ключ API в поле API Key і залиште API Base URL як
https://api.churchapps.org(якщо ви не тестуєте на сервері staging). - Натисніть Save (Зберегти): Make перевіряє ключ, читаючи профіль вашої церкви.
Підключення зберігається у вашому обліковому записі Make і використовується повторно в різних сценаріях.
3. Налаштуйте тригер
- Відкрийте налаштування модуля Watch Events (Стеження за подіями).
- Виберіть потрібну подію, наприклад
donation.created. - Збережіть. Make створює унікальну URL-адресу вебхука і зберігає її внутрішньо.
4. Додайте наступні модулі
Перетягніть на полотно будь-які з сотень модулів застосунків Make: Mailchimp, Google Sheets, Slack, HubSpot, власну HTTP-кінцеву точку тощо. Зіставте вихідні дані тригера (event, churchId, data.id, data.amount, …) з полями введення цих модулів. Модулі flatten, iterator, router та aggregator у Make дають змогу будувати розгалужені та паралельні потоки, які було б важко реалізувати в Zapier.
5. Увімкніть сценарій
Перемкніть Active (Активний) у заголовку сценарію. Make викликає POST /membership/webhooks у B1, щоб зареєструвати URL-адресу. Відтоді кожна відповідна подія B1 у режимі реального часу проходить через сценарій.
Вимкнення сценарію викликає DELETE /membership/webhooks/{id}, тож не залишається «сиротливих» підписок.
Поширені рецепти
Синхронізація пожертв із Google Sheet для фінансового огляду
- Тригер — B1: Watch Events (
donation.created) - Дія — Google Sheets: Add a Row (Додати рядок). Зіставте
data.donationDate,data.amount,data.personId,data.method,data.batchIdзі стовпцями таблиці.
Умовне сповіщення в Slack залежно від суми пожертви
- Тригер — B1: Watch Events (
donation.created) - Router (Маршрутизатор):
- Гілка A — Filter (Фільтр):
data.amount >= 1000→ Slack: публікація в#major-gifts - Гілка B — інші випадки → Slack: публікація в
#donations
- Гілка A — Filter (Фільтр):
Нова особа → CRM + вітальний лист + Slack
- Тригер — B1: Watch Events (
person.created) - Дія — HubSpot: Create Contact (Створити контакт)
- Дія — Mailgun: Send Welcome Email (Надіслати вітальний лист)
- Дія — Slack: сповіщення в
#new-people(паралельно, за допомогою маршрутизатора Make)
Як працює миттєвий тригер
Миттєвий тригер працює на основі вебхуків, а не опитування. Після активації Make викликає POST /membership/webhooks із згенерованою URL-адресою та обраною вами подією. Коли подія відбувається в B1, B1 надсилає POST-запит з даними на URL-адресу Make, і ваш сценарій запускається за кілька секунд. Вимкнення сценарію видаляє вебхук.
Тригер спрацьовує лише для подій, які відбуваються поки сценарій активний. Подій, що сталися раніше, він не обробляє.
Обмеження та примітки
- Одна подія на модуль Watch Events. Щоб відстежувати кілька подій в одному сценарії, додайте кілька модулів-тригерів в окремі сценарії (або використовуйте один модуль з об'єднаним списком подій — див. нижче).
- Перевірка підпису не надається — Make не передає
X-B1-Signatureдо сценарію; межею довіри є невгадувана URL-адреса вебхука для кожного сценарію. Це звичайна практика Make. Якщо вам потрібна явна перевірка підпису, створіть власну інтеграцію за допомогою SDK. - Кількість операцій — кожен виклик API з модуля дії зараховується до вашої квоти операцій Make і ні на що з боку B1 не впливає.
Усунення несправностей
- Тест підключення не проходить — найчастіше через помилку в ключі API. Скопіюйте його ще раз із B1Admin (повний ключ показується лише один раз; якщо ви його втратили, створіть новий ключ).
- Модуль-тригер не активується — перевірте Settings → Developer → Webhooks (Налаштування → Розробник → Вебхуки) у B1Admin. Якщо після активації сценарію ви не бачите рядка «Make — <event>», у ключі немає
settings:write. Оновіть ключ і знову активуйте сценарій. - Дія повертає
403 Forbidden— ключ API не має дозволу для цієї кінцевої точки. Наприклад, Add Donation потребуєdonations:write. Оновіть ключ у B1Admin і повторіть тест.
Налаштування застосунку
Застосунок B1.church для Make має відкритий вихідний код — JSON-визначення знаходяться в репозиторії B1Integrations/Make/. Якщо вам потрібен модуль, якого ще немає (наприклад, нова дія для кінцевої точки, яку ми ще не охопили), відкрийте issue або pull request у цьому репозиторії.
Див. також
- Zapier — той самий принцип із простішим інтерфейсом і більшим каталогом застосунків
- Slack & Discord — вбудовані сповіщення в чати без Make
- Вебхуки (довідник для розробників)