Siirry pääsisällölle

Integraatiot

B1 liittyy yhteen tiimisi jo käyttämien työkalujen kanssa. Yhdistä Slack tai Discord henkilökunnan ilmoituksia varten, automatisoi työnkulkuja Zapierissa tai Makessa tai vie tietoja pyynnöstä Google Sheetsiin. Tämä onnistuu ilman erillistä integraatioalustaa ja ilman, että ChurchApps isännöi mitään ylimääräistä. Jokainen integraatio toimii kolmannen osapuolen omassa infrastruktuurissa ja kommunikoi seurakuntasi kanssa B1:n webhookien tai REST API:n kautta.

Saatavilla olevat​

IntegraatioMitä se tekeeSuuntaAsennukseen kuluva aika
SlackLähettää luettavia ilmoituksia (uudet henkilöt, lahjoitukset, ilmoittautumiset, …) Slack-kanavalleB1 → Slack2 minuuttia
DiscordSama Discord-kanavalleB1 → Discord2 minuuttia
ZapierKäytä B1:n tapahtumia käynnistimina ja B1:n toimintoja missä tahansa Zapierin yli 7 000 sovelluksestaMolemmat5–10 min per Zap
MakeSama idea kuin Zapierissa, Maken visuaalisessa skenaariorakentajassaMolemmat5–10 min per skenaario
Google SheetsVie Henkilöt / Lahjoitukset / Ryhmät / Läsnäolo laskentataulukkoon pyynnöstäB1 → Taulukko5 minuuttia
ClaudeKysy Anthropicin Claudelta kysymyksiä seurakuntasi tiedoista, rajattuna oikeuksiisi. Kokeilu on ilmainen ja suositeltavaMolemmatAlle 3 minuuttia
ChatGPTSama idea OpenAI:n ChatGPT:n kanssa (vaatii maksullisen ChatGPT-tilauksen)Molemmat10 minuuttia
Yhdistetyt palvelutValitut reseptit palveluille Mailchimp, Donorbox, Subsplash, VOMO, Clearstream, Text In Church, Mobile Message ja CheckrVaihtelee5–10 min kukin

Miten valita​

  • Haluatko vain ilmoituksen chatiin? Käytä Slackia tai Discordia. Et tarvitse kolmannen osapuolen tiliä etkä ylläpidettävää Zapia. Määritys tehdään kokonaan B1Adminin sisällä.
  • Haluatko automatisoida jotain eri sovellusten välillä (esim. "kun joku lahjoittaa, lisää hänet Mailchimp-listalleni ja Slackin #lahjoitukset-kanavalle")? Käytä Zapieria tai Makea. Zapier on helpompi käyttää, ja Make on halvempi suuressa mittakaavassa sekä joustavampi logiikaltaan.
  • Tarvitsetko kertaluonteisen tietovedon tai ajastetun raportin? Käytä Google Sheetsiä. Liitä API-avain lisäosan sivupalkkiin ja napsauta Vie.
  • Haluatko kysyä kysymyksiä tavallisella kielellä ("montako ensikertalaista kävi viime sunnuntaina?", "tiivistä tämän kuukauden lahjoitukset")? Aloita Claudella. Kokeilu on ilmainen ja asennus kestää alle 3 minuuttia. ChatGPT toimii myös maksullisella tilauksella. Claude yhdistyy kirjautumalla B1-tilillesi, ChatGPT käyttää B1 API -avainta.
  • Rakennatko oman mukautetun integraation? Mikään yllä olevista ei sovi. Puhu suoraan REST API:lle API-avaimella tai tilaa oma palvelimesi webhookeihin.

Mitä niillä on yhteistä​

Jokainen integraatio tunnistautuu B1 API -avaimella, joka luodaan B1Adminissa kohdassa Asetukset → Kehittäjä → API-avaimet. Avain:

  • On sidottu seurakuntasi tiettyyn henkilöön ja perii tuon henkilön oikeudet
  • Voidaan rajata oikeuksilla (scopes). Esimerkiksi Google Sheets -vienti tarvitsee vain people:read-oikeuden, ei settings:write-oikeutta
  • Voidaan peruuttaa milloin tahansa, jolloin integraation käyttöoikeus katkeaa välittömästi vaikuttamatta muuhun

Muutama liitin (Zapier, Make) rekisteröi myös webhookin puolestasi, kun Zap tai skenaario otetaan käyttöön, ja poistaa sen, kun Zap sammutetaan. Et itse hallitse webhook-URL-osoitetta.

vihje

Jotta Zapier ja Make voivat rekisteröidä webhookit automaattisesti, API-avaimella on oltava settings:write-oikeus sekä resurssikohtaiset oikeudet sille, mitä integraatio käsittelee. Pelkän lukuoikeuden omaava avain toimii toiminnoille ja vienneille, mutta ei käynnistimille.

Kustannukset​

ChurchApps on ilmainen ja avoimen lähdekoodin ohjelmisto. Slack, Discord, @churchapps/integration-sdk sekä viralliset Zapier-, Make- ja Google Sheets -liittimet ovat meidän puolestamme myös ilmaisia. Kolmannet osapuolet voivat veloittaa omista alustoistaan. Zapierilla ja Makella on molemmilla anteliaat ilmaistasot, ja Slack, Discord ja Google Sheets ovat tähän käyttöön ilmaisia.

Oman rakentaminen​

Jos mikään yllä olevista ei sovi, jokainen B1-pinta on avoin:

  • REST API: kutsu B1:tä millä tahansa kielellä Authorization: Bearer cak_… -otsakkeella
  • Webhookit: tilaa julkinen HTTPS-päätepiste yhteen tai useampaan tapahtumatyyppiin ja vastaanota allekirjoitettuja JSON-sisältöjä
  • OAuth ja Yhdistetyt sovellukset: jos rakennat SaaS-tuotetta, jota monet seurakunnat käyttävät

Seuraavat askeleet​

  • Slack ja Discord: lähetä chat-ilmoituksia
  • Zapier: yhdistä yli 7 000 sovellukseen
  • Make: visuaalinen työnkulkujen automaatio
  • Google Sheets: vie laskentataulukoihin
  • Claude: kysy Anthropicin Claudelta seurakuntasi tiedoista
  • ChatGPT: kysy OpenAI:n ChatGPT:ltä seurakuntasi tiedoista
  • Yhdistetyt palvelut: palvelukohtaiset reseptit (Mailchimp, Donorbox, Clearstream jne.)