Перейти к основному содержимому

Donorbox

Если ваша церковь принимает пожертвования через Donorbox, а людей и справки ведёт в B1, триггеры Donorbox для Zapier могут мгновенно создавать соответствующие записи пожертвований в B1 — и создавать жертвователя как человека в B1, если его там ещё нет. Никакой ручной сверки и ежемесячных выгрузок.

Прежде чем начать

  • Учётная запись Donorbox хотя бы с одной кампанией
  • Учётная запись Zapier
  • Пользователь B1Admin с правом Edit Settings

Что можно связать​

НаправлениеТриггер DonorboxДействие B1
Donorbox → B1New or Updated Donation (мгновенно)Find Person → Add Donation
Donorbox → B1New or Updated DonorCreate Person
Donorbox → B1New or Updated Plan (регулярные)Find Person → Add Donation (id плана как примечание)

Donorbox публикует свои триггеры как мгновенные — они срабатывают в течение нескольких секунд после реального пожертвования. Задержки опроса нет.

Настройка​

1. Создайте API-ключ B1​

В B1Admin: Settings → Developer → API Keys → New API Key. Области:

  • people:read — чтобы найти жертвователя по адресу электронной почты

  • people:write — чтобы создать его, если он новый

  • donations:write — чтобы записать пожертвование

  • settings:write — Zapier проверяет каждый ключ B1 по списку веб-хуков B1 при подключении, поэтому без неё подключение не пройдёт (хотя триггер здесь принадлежит Donorbox, а не B1)

2. Создайте Zap «записать пожертвование»​

  1. Триггер — Donorbox: New Donation. Подключитесь с помощью API-ключа Donorbox (в Donorbox: Account → Profile → API Settings).
  2. Действие — B1.church: Find Person. Сопоставьте адрес электронной почты жертвователя из триггера с полем Email.
  3. Действие — B1.church: Add Donation. Сопоставьте:
    • Person → id из шага 2
    • Amount → сумма пожертвования из триггера
    • Donation Date → дата пожертвования из триггера
    • Fund → выберите фонд B1, который соответствует кампании Donorbox (Zapier позволяет менять фонд по фильтру или шагу Formatter)
    • Method → «Online»
    • Notes → id транзакции Donorbox (удобно при сверке)

Включите Zap. Следующее живое пожертвование через Donorbox автоматически появится в B1Admin → Donations.

Find Person в B1 останавливает Zap с ошибкой «No person found», если никто с таким адресом электронной почты не найден, поэтому шаг Filter не может ветвиться по этому условию. Чтобы обработать пожертвования от новых жертвователей, включите в Zapier обработку ошибок для шага Find Person и в её пути ошибки выполните B1.church: Create Person (сопоставьте имя, фамилию и адрес электронной почты), а затем Add Donation с id нового человека. Или запустите Zap New Donor → Create Person из таблицы выше, чтобы жертвователи уже существовали в B1 до поступления их пожертвования.

Типичные рецепты​

Один Zap на фонд​

Если у вас несколько кампаний Donorbox, которые соответствуют отдельным фондам B1, самая чистая схема — один Zap на кампанию с фильтром по campaign Donorbox в начале: тогда сопоставление фонда задано жёстко, и шаг поиска не нужен.

Обновлённые пожертвования считать исправлениями​

Триггер Donorbox New or Updated Donation срабатывает и при изменениях. Используйте шаг Zapier Path по event_type, чтобы разделить потоки: «new» → Add Donation, «updated» → Find Donation + Update (учтите, что в приложении Zapier для B1 сейчас нет действия Update Donation — пока события «updated» записывайте в канал Slack для ручной проверки).

Отправлять изменения регулярных планов в канал Slack​

  • Триггер — Donorbox: New or Updated Plan
  • Действие — Slack: Send Message в #donations (например, «План изменён — ежемесячное пожертвование Сары теперь $200»)

Ограничения и примечания​

  • Сопоставляйте жертвователей по адресу электронной почты. Donorbox не передаёт id человека из B1; единственный надёжный ключ связи — адрес электронной почты. Жертвователи, которые дают под другим адресом, создадут нового человека в B1, — ваша ежемесячная сверка должна искать такие случаи.
  • Возвраты отдельно не передаются — Donorbox отправляет обновление статуса для того же пожертвования. В приложении Zapier для B1 сейчас нет действия Update Donation; безопасный способ на сегодня — фиксировать события возврата вне системы и вручную корректировать пожертвование.
  • Сначала проверьте в песочнице Donorbox, чтобы не создать поддельные пожертвования в рабочей B1. Donorbox предоставляет учётные данные тестового режима отдельно от боевых.

Устранение неполадок​

  • Ошибки «No person found» — жертвователя ещё нет в B1 (или он дал пожертвование под другим адресом электронной почты). Добавьте путь ошибки, описанный выше, и проверьте, что в API-ключе есть people:write, чтобы Create Person мог выполниться.
  • Сумма пожертвования в 100 раз больше или меньше — Donorbox в одних вариантах полезной нагрузки передаёт центы, в других — доллары. При необходимости используйте шаг Formatter by Zapier — Numbers, чтобы разделить на 100.
  • Дублирование пожертвований от одного подарка — Donorbox срабатывает и на New Donation, и на Updated Donation. Либо отфильтруйте по event_type = "donation.succeeded", либо создайте два Zap с непересекающимися фильтрами.

См. также​

  • Zapier (обзор) — сторона B1 в каждом рецепте Zapier
  • Subsplash — другая платформа пожертвований с приложением Zapier
  • Mailchimp — цепочка «новое пожертвование» → метка в email-рассылке