Vai al contenuto principale

Integrazioni

B1 si integra con gli strumenti che il tuo team già usa. Collega Slack o Discord per le notifiche allo staff, automatizza i flussi di lavoro con Zapier o Make, oppure esporta i dati su richiesta in Google Sheets, senza pagare una piattaforma di integrazione separata e senza che ChurchApps ospiti nulla di aggiuntivo. Ogni integrazione funziona sull'infrastruttura del fornitore terzo e comunica con la tua chiesa tramite i webhook o l'API REST di B1.

Cosa è disponibile​

IntegrazioneCosa faDirezioneImpegno di configurazione
SlackPubblica notifiche leggibili (nuove persone, donazioni, iscrizioni, …) in un canale SlackB1 → Slack2 minuti
DiscordLo stesso, in un canale DiscordB1 → Discord2 minuti
ZapierUsa gli eventi di B1 come trigger e le azioni di B1 in una qualsiasi delle oltre 7.000 app di Zapier (in attesa dell'approvazione di Zapier)Entrambe5–10 min per Zap
MakeStessa idea di Zapier, nel generatore visuale di scenari di Make (non ancora rilasciato)Entrambe5–10 min per scenario
Google SheetsEsporta Persone / Donazioni / Gruppi / Presenze in un foglio di calcolo su richiesta (non ancora rilasciato)B1 → Foglio5 minuti
ClaudeFai domande ai dati della tua chiesa a Claude di Anthropic, con i limiti dei tuoi permessi: si può provare gratuitamente, consigliatoEntrambeMeno di 3 minuti
ChatGPTStessa idea con ChatGPT di OpenAI (richiede un abbonamento ChatGPT a pagamento)Entrambe10 minuti
MailchimpMantieni un pubblico Mailchimp sincronizzato con le tue persone, i gruppi e le liste salvate: integrato in B1B1 → Mailchimp5 minuti
Servizi collegatiRicette selezionate per Donorbox, Subsplash, VOMO, Clearstream, Text In Church, Mobile Message, CheckrVaria5–10 min ciascuna

Come scegliere​

  • Ti basta una notifica in chat? Usa Slack o Discord: nessun account di terze parti, nessuno Zap da mantenere. Si configura interamente dentro B1Admin.
  • Vuoi automatizzare qualcosa tra più app (ad esempio, "quando qualcuno dona, aggiungilo alla mia lista Mailchimp e pubblica in #donazioni su Slack")? Usa Zapier o Make. Zapier è più semplice; Make costa meno su larga scala e offre una logica più flessibile.
  • Ti serve un'estrazione dati una tantum o un report pianificato? Usa Google Sheets: incolla una chiave API nella barra laterale del componente e clicca su Esporta.
  • Vuoi fare domande in linguaggio semplice ("quanti visitatori alla prima volta sono venuti domenica scorsa?", "riassumi le donazioni di questo mese")? Inizia con Claude: si può provare gratuitamente e si configura in meno di 3 minuti. ChatGPT funziona altrettanto bene con un abbonamento a pagamento. Claude si collega con l'accesso tramite il tuo account B1; ChatGPT usa una chiave API di B1.
  • Stai costruendo un'integrazione personalizzata? Nessuna delle precedenti: parla direttamente con la REST API usando una chiave API, oppure collega un server che controlli ai webhook.

Cosa hanno in comune​

Tutto si configura in B1Admin in Impostazioni → Sviluppatori, che ha tre schede: Chiavi API, Webhook e App collegate.

  • Slack, Discord e Mailchimp sono webhook che crei tu stesso nella scheda Webhook (scegliendo il Tipo di connettore corrispondente). Non richiedono una chiave API.

  • Claude (con accesso tramite il tuo account B1) compare nella scheda App collegate, dove puoi revocarlo.

  • Zapier, Make, Google Sheets, ChatGPT e Claude con una chiave si autenticano con una chiave API B1, creata nella scheda Chiavi API. La chiave:

    • È legata alla persona che l'ha creata ed eredita i permessi di quella persona
    • Può essere limitata con ambiti: ad esempio, un'esportazione verso Google Sheets ha bisogno solo di people:read, non di settings:write
    • Può essere eliminata in qualsiasi momento, interrompendo subito l'accesso dell'integrazione senza influire su nient'altro

Alcuni connettori (Zapier, Make) registrano anche un webhook per tuo conto quando lo Zap o lo scenario viene attivato, e lo rimuovono quando disattivi lo Zap: non devi gestire tu l'URL del webhook.

Suggerimento

Perché Zapier e Make registrino automaticamente i webhook, la chiave API deve avere l'ambito settings:write (oltre agli ambiti delle risorse coinvolte dall'integrazione). Una chiave in sola lettura funziona per azioni ed esportazioni, ma non per i trigger.

Costi​

ChurchApps è gratuito e open source. Slack/Discord, l'@churchapps/integration-sdk e i connettori ufficiali di Zapier / Make / Google Sheets sono anch'essi gratuiti da parte nostra. I terzi possono addebitare costi per le proprie piattaforme (Zapier e Make hanno piani gratuiti generosi; Slack, Discord e Google Sheets sono gratuiti per questo uso).

Costruire la propria integrazione​

Se nessuna delle opzioni precedenti fa per te, ogni parte di B1 è accessibile:

  • REST API: chiama B1 da qualsiasi linguaggio con un'intestazione Authorization: Bearer cak_…
  • Webhook: collega un endpoint HTTPS pubblico a uno o più tipi di evento e ricevi payload JSON firmati
  • OAuth + App collegate: se stai costruendo un prodotto SaaS usato da molte chiese

Prossimi passi​

  • Slack e Discord: pubblica notifiche in chat
  • Zapier: collegati a oltre 7.000 app
  • Make: automazione visuale dei flussi di lavoro
  • Google Sheets: esporta in fogli di calcolo
  • Claude: chiedi a Claude di Anthropic dei dati della tua chiesa
  • ChatGPT: chiedi a ChatGPT di OpenAI dei dati della tua chiesa
  • Servizi collegati: ricette per singoli servizi (Mailchimp, Donorbox, Clearstream, …)