Zapier
L'app ufficiale B1.church su Zapier permette a uno Zap di reagire agli eventi della tua chiesa (nuova persona, nuova donazione, nuovo membro di un gruppo, …) e di scrivere i record in B1. Nessun codice, nessuna infrastruttura: lo configuri nell'editor drag-and-drop di Zapier, incolli una chiave API e attivi lo Zap.
L'app B1.church è costruita e funzionante, ma è ancora in attesa della revisione di Zapier prima di comparire pubblicamente nel catalogo app dell'editor degli Zap. Fino all'approvazione, può usarla solo chi ha un invito. Tutto quello che segue descrive come funzionerà una volta approvata.
Prima di iniziare
- Un account Zapier (il piano gratuito basta per qualche Zap)
- Un amministratore della chiesa con il permesso Modifica impostazioni in B1Admin (dovrai creare una chiave API)
- Un'idea di ciò che vuoi fare, ad esempio "quando una persona viene aggiunta in B1, aggiungila alla mia lista Mailchimp"
Trigger e azioni
| Tipo | Cosa | Evento / endpoint di B1 |
|---|---|---|
| Trigger | Nuova persona | person.created |
| Trigger | Persona aggiornata | person.updated |
| Trigger | Nuova donazione | donation.created |
| Trigger | Nuovo membro del gruppo | group.member.added |
| Trigger | Nuova risposta a un modulo | form.submission.created |
| Azione | Crea persona | aggiunge una nuova persona |
| Azione | Aggiungi donazione | registra una donazione |
| Azione | Aggiungi membro al gruppo | aggiunge una persona a un gruppo |
| Azione | Trova persona | cerca una persona per ID, email o nome; fa fallire l'attività se nessuno corrisponde |
Puoi combinarli liberamente con una qualsiasi delle oltre 7.000 app supportate da Zapier.
Configurazione
1. Crea una chiave API B1
- In B1Admin vai su Impostazioni → Sviluppatori → Chiavi API.
- Clicca su Nuova chiave API, dalle un nome come "Zapier", e seleziona gli ambiti di cui lo Zap ha bisogno.
- Importante: includi sempre l'ambito
settings:write. Zapier verifica la chiave con l'elenco dei webhook di B1 quando la colleghi, e i trigger di B1 registrano un webhook per tuo conto quando lo Zap viene attivato: entrambe le operazioni richiedonosettings:write. Una chiave senza di esso fallisce il test di connessione, anche se i tuoi Zap usano solo azioni di B1. - Concedi anche gli ambiti richiesti dalle azioni: ad esempio, l'azione "Aggiungi donazione" richiede
donations:write, "Crea persona" richiedepeople:write. - Salva. La chiave
cak_…completa viene mostrata una sola volta: copiala.
2. Collega Zapier a B1
- In Zapier, crea un nuovo Zap.
- Quando scegli per la prima volta un trigger o un'azione di B1, Zapier ti chiede di Accedere a B1.church.
- Incolla la chiave API del passaggio 1 in API Key (lascia vuoto API URL) e clicca su Sì, continua. Zapier la verifica con la tua chiesa.
La connessione viene salvata in Zapier e riutilizzata da ogni Zap del tuo account.
3. Costruisci lo Zap
Scegli un trigger, poi aggiungi uno o più passaggi di azione. Di seguito alcuni esempi.
Ricette comuni
Aggiungi le nuove persone di B1 a Mailchimp
- Trigger: B1: Nuova persona
- Azione: Mailchimp: Aggiungi/Aggiorna iscritto. Collega
name__first,name__last,contactInfo__emaildi B1 ai campi Nome / Cognome / Email di Mailchimp.
Pubblica le donazioni in un canale Slack con una scheda più ricca del connettore integrato
- Trigger: B1: Nuova donazione
- Azione: Slack: Invia messaggio nel canale. Componi qualsiasi layout (pulsanti, allegati, ecc.) che il connettore Slack integrato non permette.
Aggiungi i nuovi membri dei gruppi a un Gruppo Google
- Trigger: B1: Nuovo membro del gruppo
- Azione: Filtro di Zapier: continua solo se il
groupIddel trigger è il gruppo di B1 che ti interessa - Azione: B1: Trova persona (usa il
personIddel trigger per recuperare l'email) - Azione: Gruppi Google: Aggiungi membro
Inoltra le risposte ai moduli a un gestionale di progetti
- Trigger: B1: Nuova risposta a un modulo
- Azione: Notion / Linear / Asana / Trello: Crea pagina / problema / compito
Come funzionano i trigger
I trigger sono REST hook, non polling: Zapier non interroga B1 ogni 15 minuti. Quando attivi lo Zap, Zapier chiede a B1 di registrare un webhook che punta a un URL privato di Zapier; quando l'evento si verifica, B1 invia il messaggio a Zapier e il tuo Zap parte in pochi secondi. Se disattivi lo Zap, Zapier chiede a B1 di eliminare il webhook: nessuna iscrizione orfana.
Questo significa che il trigger si attiva solo per gli eventi che si verificano dopo l'attivazione dello Zap. Non c'è recupero retroattivo: attivare uno Zap non riproduce le donazioni di ieri.
Limiti e note
- Più Zap con lo stesso trigger registrano ciascuno il proprio webhook di B1: non ci sono conflitti, ma è utile saperlo se controlli Impostazioni → Sviluppatori → Webhook e ti chiedi perché compaiano tre righe identiche
Zapier — donation.created. - Dati di test nella configurazione dello Zap: quando costruisci uno Zap, Zapier chiede dei dati di esempio per mappare i campi. Recupera l'evento corrispondente più recente da B1, se esiste; altrimenti usa un esempio sintetico dalla definizione dell'app.
- Gli errori delle azioni compaiono come errori dello Zap nella cronologia delle attività di Zapier. Causa comune: una chiave API senza l'ambito giusto (ad esempio, l'azione "Aggiungi donazione" richiede
donations:write). Crea di nuovo la chiave con gli ambiti corretti e ricollegala in Zapier. - Quote delle chiamate API in uscita: ogni chiamata API di B1 da un'azione conta sulla quota di attività di Zapier, non su nulla lato B1.
Risoluzione dei problemi
- "Autenticazione non riuscita" durante la connessione: la chiave API è errata, eliminata oppure non ha
settings:write. Crea in B1Admin una nuova chiave consettings:writepiù gli ambiti delle risorse usate dallo Zap (gli ambiti non si possono modificare su una chiave esistente), poi aggiorna la connessione. - Il trigger non si attiva mai: verifica che il webhook sia stato effettivamente registrato. In B1Admin, Impostazioni → Sviluppatori → Webhook dovrebbe ora mostrare una riga chiamata "Zapier — <evento>". Se non c'è, probabilmente la chiave API non aveva
settings:writequando hai attivato lo Zap. Correggi la chiave, disattiva lo Zap e riattivalo. - Il trigger si attiva due volte: Zapier a volte reinvia un evento se la conferma è andata persa. Se ti serve una deduplicazione rigorosa, usa un passaggio "Filtro di Zapier" su un ID univoco (ad esempio, l'
iddella persona).
Vedi anche
- Make: stesso schema, su un'altra piattaforma
- Slack e Discord: notifiche in chat più semplici, senza Zapier
- Webhook (riferimento per sviluppatori)