Make
Make (ранее Integromat) — платформа визуальной автоматизации процессов, похожая по духу на Zapier, но с более гибкой логикой и меньшими затратами при большом объёме. Официальное приложение B1.church для Make позволяет создавать «сценарии», которые мгновенно реагируют на события B1 и записывают данные обратно в B1.
Приложение B1.church для Make ещё не опубликовано в каталоге приложений Make, поэтому добавить модули B1.church, описанные ниже, в сценарий сейчас нельзя. До его публикации используйте Zapier или вызывайте REST API B1 из модуля Make HTTP — Make a request с API-ключом. Всё, что описано ниже, показывает, как приложение будет работать после выпуска.
Прежде чем начать
- Учётная запись 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.
- Нажмите New API Key, назовите его «Make» и выдайте нужные области доступа.
- Добавьте
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 для проверки финансов
- Триггер — 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(параллельно — через router Make)
Как работает мгновенный триггер
Мгновенный триггер основан на веб-хуке, а не на опросе: при активации Make вызывает POST /membership/webhooks с созданным им URL и выбранным событием. Когда событие происходит в B1, B1 отправляет пакет на 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 и проверьте снова.
Не хватает модуля?
Если вам нужен модуль, которого нет (например, новое действие для конечной точки, которую мы ещё не охватили), напишите на support@churchapps.org. А пока модуль Make HTTP — Make a request может вызывать любую конечную точку B1 с заголовком Authorization: Bearer cak_….
См. также
- Zapier — тот же принцип с более простым интерфейсом и большим каталогом приложений
- Slack и Discord — встроенные уведомления в чат без Make
- Веб-хуки (справочник для разработчиков)