Vai al contenuto principale

Donorbox

Se la tua chiesa riceve donazioni tramite Donorbox ma gestisce persone ed estratti conto in B1, puoi fare in modo che i trigger istantanei di Zapier di Donorbox creino in B1 i record di donazione corrispondenti, e creino il donatore come persona in B1 se non esiste già. Nessuna riconciliazione manuale, nessuna esportazione mensile.

Prima di iniziare

  • Un account Donorbox con almeno una campagna
  • Un account Zapier
  • Un utente B1Admin con il permesso Modifica impostazioni

Cosa puoi collegare​

DirezioneTrigger di DonorboxAzione in B1
Donorbox → B1Donazione nuova o aggiornata (istantaneo)Trova persona → Aggiungi donazione
Donorbox → B1Donatore nuovo o aggiornatoCrea persona
Donorbox → B1Piano nuovo o aggiornato (ricorrente)Trova persona → Aggiungi donazione (usa l'ID del piano come nota)

Donorbox pubblica i suoi trigger come istantanei: si attivano pochi secondi dopo una donazione reale. Nessun ritardo di polling.

Configurazione​

1. Crea una chiave API B1​

In B1Admin: Impostazioni → Sviluppatori → Chiavi API → Nuova chiave API. Ambiti:

  • people:read: per cercare il donatore tramite email

  • people:write: per crearlo se è nuovo

  • donations:write: per registrare la donazione

  • settings:write: quando colleghi la chiave, Zapier verifica ogni chiave B1 con l'elenco dei webhook di B1, quindi la connessione fallisce senza questo ambito (anche se il trigger qui appartiene a Donorbox, non a B1)

2. Crea lo Zap "registra una donazione"​

  1. Trigger: Donorbox: Nuova donazione. Collegati con la chiave API di Donorbox (in Donorbox: Account → Profilo → Impostazioni API).
  2. Azione: B1.church: Trova persona. Collega l'email del donatore dal trigger al campo Email.
  3. Azione: B1.church: Aggiungi donazione. Collega:
    • Persona → l'ID del passaggio 2
    • Importo → l'importo della donazione dal trigger
    • Data della donazione → la data della donazione dal trigger
    • Fondo → scegli il fondo di B1 che corrisponde alla campagna Donorbox (Zapier ti permette di cambiare fondo in base a un filtro o a un passaggio Formatter)
    • Metodo → "Online"
    • Note → ID della transazione Donorbox (utile in fase di riconciliazione)

Attiva lo Zap. La prossima donazione reale ricevuta tramite Donorbox compare automaticamente in B1Admin → Donazioni.

Il passaggio Trova persona di B1 interrompe lo Zap con un errore "Nessuna persona trovata" quando nessuno ha quell'email, quindi un passaggio Filtro non può ramificarsi su questo. Per gestire i donatori alla prima donazione, attiva la gestione degli errori di Zapier per il passaggio Trova persona e, nel suo percorso di errore, esegui B1.church: Crea persona (collega nome, cognome ed email) e poi Aggiungi donazione con l'ID della nuova persona. In alternativa, esegui lo Zap Nuovo donatore → Crea persona dalla tabella sopra, così i donatori esistono già in B1 prima che arrivi il loro dono.

Ricette comuni​

Uno Zap per fondo​

Se gestisci più campagne Donorbox che corrispondono a fondi separati in B1, la disposizione più pulita è uno Zap per campagna con un filtro campagna di Donorbox in cima: così l'associazione con il fondo è fissa e salti il passaggio di ricerca.

Tratta le donazioni aggiornate come correzioni​

Il trigger Donazione nuova o aggiornata di Donorbox si attiva anche alle modifiche. Usa un passaggio Percorso di Zapier su event_type per separare i casi: "nuova" → Aggiungi donazione, "aggiornata" → Trova donazione + Aggiorna (nota: l'app Zapier di B1 non ha ancora un'azione Aggiorna donazione; per ora, registra gli eventi "aggiornata" in un canale Slack per una revisione manuale).

Sincronizza le modifiche ai piani ricorrenti con un canale Slack​

  • Trigger: Donorbox: Piano nuovo o aggiornato
  • Azione: Slack: Invia messaggio a #donations (ad esempio, "Piano modificato: l'offerta mensile di Sarah è ora di 200 $")

Limiti e note​

  • Abbina i donatori tramite email. Donorbox non condivide l'ID persona di B1; l'unica chiave di collegamento stabile è l'email. I donatori che donano con un'email diversa creeranno una nuova persona in B1: la tua riconciliazione mensile dovrebbe cercare questi casi.
  • I rimborsi non sono esposti separatamente: Donorbox invia un aggiornamento di stato sulla stessa donazione. L'app Zapier di B1 non ha al momento un'azione Aggiorna donazione; per ora, il modo sicuro è registrare gli eventi di rimborso fuori dal sistema e correggere la donazione manualmente.
  • Prova prima nel sandbox di Donorbox per evitare di creare donazioni false nel B1 di produzione. Donorbox fornisce credenziali di modalità test separate da quelle live.

Risoluzione dei problemi​

  • Errori "Nessuna persona trovata": il donatore non è ancora in B1 (oppure ha donato con un'email diversa). Aggiungi il percorso di errore descritto sopra e verifica che la chiave API abbia people:write così da poter eseguire Crea persona.
  • L'importo della donazione sembra 100 volte più grande o più piccolo: Donorbox invia centesimi in alcune varianti del payload e dollari in altre. Usa un passaggio Formatter by Zapier — Numbers per dividere per 100, se necessario.
  • Donazioni duplicate per un singolo dono: Donorbox attiva sia Donazione nuova sia Donazione aggiornata. Filtra su event_type = "donation.succeeded" oppure crea due Zap con filtri non sovrapposti.

Vedi anche​