본문으로 건너뛰기

Donorbox

교회가 Donorbox를 통해 기부를 받지만 B1에서 사람과 명세서를 추적하는 경우 Donorbox의 즉시 Zapier 트리거를 사용하여 B1 내부에서 일치하는 기부 기록을 생성할 수 있습니다 — 기부자가 아직 존재하지 않으면 B1 사람으로 생성합니다. 수동 조정 없음, 월간 내보내기 없음.

시작하기 전에

  • 최소 하나의 캠페인이 있는 Donorbox 계정
  • Zapier 계정
  • 설정 편집 권한이 있는 B1Admin 사용자

연결할 수 있는 것​

방향Donorbox 트리거B1 작업
Donorbox → B1새 또는 업데이트된 기부(즉시)사람 찾기 → 기부 추가
Donorbox → B1새 또는 업데이트된 기부자사람 생성
Donorbox → B1새 또는 업데이트된 계획(반복)사람 찾기 → 기부 추가(계획 id를 참고로 사용)

Donorbox는 즉시 트리거를 게시합니다 — 실제 기부 후 몇 초 내에 실행됩니다. 폴링 지연이 없습니다.

설정​

1. B1 API 키 발급​

B1Admin에서: 설정 → 개발자 → API 키 → 새 API 키. 범위:

  • people:read — 이메일로 기부자를 찾아볼 때
  • people:write — 새 기부자를 생성할 때
  • donations:write — 선물을 기록할 때

이 방향의 트리거는 Donorbox의 것이며 B1의 것이 아니므로 settings:write가 필요하지 않습니다.

2. "기부 기록" Zap 빌드​

  1. 트리거 — Donorbox: 새로운 기부. Donorbox의 API 키로 연결합니다(Donorbox: 계정 → 프로필 → API 설정).
  2. 작업 — B1.church: 사람 찾기. 기부자의 이메일을 트리거에서 이메일 검색 필드로 매핑합니다.
  3. 작업 — Zapier로 필터(선택 사항): 기부자가 발견되지 않은 경우에만 계속…
  4. 작업 — B1.church: 사람 생성. 이름/성/이메일을 매핑하면 기부자가 멤버로 착륙합니다, 단순히 선물 기록이 아님.
  5. 작업 — B1.church: 기부 추가. 매핑:
    • 금액 → data.amount
    • 기부 날짜 → 트리거의 기부 날짜
    • 기금 → Donorbox 캠페인을 미러링하는 B1 기금을 선택합니다(Zapier는 필터 또는 형식화 단계를 기반으로 기금을 전환할 수 있게 합니다)
    • 방법 → "온라인"
    • 참고 → Donorbox 거래 id(조정할 때 유용)

Zap을 켭니다. Donorbox를 통한 다음 실시간 기부는 B1Admin → 기부 내에서 자동으로 착륙합니다.

일반적인 레시피​

기금별 하나의 Zap​

여러 Donorbox 캠페인을 별도 B1 기금으로 매핑하는 경우 가장 깔끔한 레이아웃은 캠페인별로 하나의 Zap이며 상단에 Donorbox 캠페인 필터가 있습니다 — 이렇게 하면 기금 매핑이 하드코드되고 조회 단계를 건너뜁니다.

업데이트된 기부를 수정으로 취급​

Donorbox의 새 또는 업데이트된 기부는 편집 시에도 실행됩니다. Zapier 경로 단계를 event_type에 사용합니다: "new" → 기부 추가, "updated" → 기부 찾기 + 업데이트(참고: B1의 Zapier 앱에는 현재 기부 업데이트 작업이 없습니다 — 지금은 "updated" 이벤트를 Slack 채널에 로깅하여 수동 검토).

반복 계획 변경을 Slack 채널로 동기화​

  • 트리거 — Donorbox: 새 또는 업데이트된 계획
  • 작업 — Slack: #donations 메시지 전송(예: "계획 변경 — Sarah의 월간 기부는 이제 $200")

제한 및 주의사항​

  • 기부자를 이메일로 매칭합니다. Donorbox는 B1의 사람 id를 공유하지 않습니다. 유일한 내구적인 조인 키는 이메일입니다. 다른 이메일로 기부하는 기부자는 새 B1 사람을 생성합니다 — 월간 조정은 이것들을 찾아야 합니다.
  • 환불은 별도로 노출되지 않습니다 — Donorbox는 동일한 기부에 대한 상태 업데이트를 내보냅니다. B1의 Zapier 앱에는 현재 기부 업데이트 작업이 없습니다. 오늘은 환불 이벤트를 대역 외로 로깅하고 기부를 수동으로 조정하는 것이 안전한 패턴입니다.
  • 먼저 Donorbox의 샌드박스에서 테스트합니다. — 프로덕션 B1에서 가짜 선물을 생성하지 않도록. Donorbox는 라이브와 별도로 테스트 모드 자격 증명을 제공합니다.

문제 해결​

  • 모든 실행에서 "사람을 찾을 수 없음" 경고 — 발견되지 않은 분기에서 사람 생성이 실행되도록 단계를 정렬하면 괜찮습니다. 사람 생성 단계도 실행되지 않으면 API 키에 people:write가 있는지 다시 확인합니다.
  • 기부 금액이 100배 너무 크거나 작음 — Donorbox는 일부 페이로드 변형에서 센트를 보내고 다른 변형에서는 달러를 보냅니다. 보장할 수 없으면 Zapier 형식화 — 숫자 단계를 사용하여 100으로 나눕니다.
  • 단일 선물에서 중복 기부 — Donorbox는 새 기부와 업데이트된 기부를 모두 실행합니다. event_type = "donation.succeeded"로 필터링하거나 겹치지 않는 필터가 있는 두 개의 Zap을 빌드하세요.

참고도 보기​

  • Zapier(개요) — 모든 Zapier 레시피의 B1 측
  • Subsplash — 다른 기부 플랫폼, Zapier 앱 사용
  • Mailchimp — "새 선물"을 이메일 태그로 연결