Make
Make (cunoscut anterior ca Integromat) este o platformă vizuală de automatizare a fluxurilor de lucru, asemănătoare cu Zapier, dar cu logică mai flexibilă și un cost mai mic la scară mare. Aplicația oficială B1.church pentru Make vă permite să creați „scenarii” care reacționează instant la evenimentele B1 și scriu înregistrări înapoi în B1.
Înainte de a începe
- Un cont Make (planul gratuit acoperă fluxurile de lucru mici)
- Un administrator al bisericii cu permisiunea Editare setări în B1Admin
- O idee generală despre scenariul pe care doriți să îl creați
Module
| Tip | Ce face | Eveniment / endpoint B1 |
|---|---|---|
| Declanșator instant | Urmărește evenimentele | orice eveniment B1 abonat (person.created, donation.created, …) |
| Acțiune | Creează persoană | adaugă o persoană nouă |
| Acțiune | Adaugă donație | înregistrează o donație |
| Acțiune | Adaugă membru în grup | adaugă o persoană într-un grup |
| Căutare | Caută persoane | găsește persoane după nume sau adresă de e-mail |
Declanșatorul instant vă permite să alegeți ce eveniment să urmăriți: câte un modul declanșator pentru fiecare scenariu, configurat pentru fiecare eveniment în parte.
Configurare
1. Creați o cheie API B1
- În B1Admin, mergeți la Setări → Dezvoltator → Chei API.
- Faceți clic pe Cheie API nouă, denumiți-o „Make” și acordați domeniile de acces (scopes) de care aveți nevoie.
- Includeți
settings:writedacă vreunul dintre scenariile dvs. folosește declanșatorul instant. Make înregistrează un webhook în numele dvs. atunci când scenariul este activat. - Acordați și domeniile de acces necesare modulelor de acțiune (de exemplu,
donations:writepentru modulul Adaugă donație). - Salvați și copiați cheia
cak_….
2. Instalați conexiunea
- În Make, creați un scenariu nou și adăugați modulul declanșator B1.church pe pânză.
- Când vi se solicită, alegeți Create a connection. Lipiți cheia API în câmpul API Key și lăsați API Base URL ca
https://api.churchapps.org(cu excepția cazului în care testați pe mediul de staging). - Faceți clic pe Save. Make testează cheia citind profilul bisericii dvs.
Conexiunea este salvată în contul dvs. Make și este reutilizată în toate scenariile.
3. Configurați declanșatorul
- Deschideți setările modulului Watch Events.
- Alegeți evenimentul dorit, de exemplu
donation.created. - Salvați. Make generează un URL unic de webhook și îl stochează intern.
4. Adăugați module în aval
Adăugați oricare dintre sutele de module de aplicații Make pe pânză: Mailchimp, Google Sheets, Slack, HubSpot, propriul dvs. endpoint HTTP etc. Mapați rezultatul declanșatorului (event, churchId, data.id, data.amount, …) în câmpurile de intrare ale acestora. Modulele Make de tip flatten, iterator, router și aggregator vă permit să construiți fluxuri ramificate și paralele, greu de realizat în Zapier.
5. Activați scenariul
Comutați Active în antetul scenariului. Make apelează POST /membership/webhooks din B1 pentru a înregistra URL-ul. De atunci, fiecare eveniment B1 corespunzător trece prin scenariu în timp real.
Dezactivarea scenariului apelează DELETE /membership/webhooks/{id}, astfel încât să nu rămână abonamente orfane.
Rețete frecvente
Sincronizați donațiile într-un Google Sheet pentru verificarea financiară
- Declanșator — B1: Watch Events (
donation.created) - Acțiune — Google Sheets: Add a Row. Mapați
data.donationDate,data.amount,data.personId,data.method,data.batchIdîn coloanele foii de calcul.
Notificare Slack condiționată de suma donației
- Declanșator — B1: Watch Events (
donation.created) - Router:
- Ramura A — Filtru:
data.amount >= 1000→ Slack: postează în#major-gifts - Ramura B — implicită → Slack: postează în
#donations
- Ramura A — Filtru:
Persoană nouă → CRM + e-mail de bun venit + Slack
- Declanșator — B1: Watch Events (
person.created) - Acțiune — HubSpot: Create Contact
- Acțiune — Mailgun: Send Welcome Email
- Acțiune — Slack: Notifică
#new-people(în paralel — folosiți routerul Make)
Cum funcționează declanșatorul instant
Declanșatorul instant se bazează pe webhook, nu pe interogare periodică: la activare, Make apelează POST /membership/webhooks cu URL-ul generat și evenimentul ales. Când evenimentul se produce în B1, B1 trimite mesajul către URL-ul Make, iar scenariul rulează în câteva secunde. Dezactivarea scenariului elimină webhook-ul.
Declanșatorul se activează doar pentru evenimentele care au loc cât timp scenariul este activ. Nu există retroactivitate.
Limite și observații
- Un eveniment pentru fiecare modul Watch Events. Pentru a asculta mai multe evenimente într-un singur scenariu, adăugați mai multe module declanșator în scenarii separate (sau folosiți un singur modul cu lista unificată de evenimente, vezi mai jos).
- Verificarea semnăturii nu este expusă. Make nu transmite
X-B1-Signaturecătre scenariu; limita de încredere este URL-ul de webhook unic și imposibil de ghicit pentru fiecare scenariu. Aceasta este o practică obișnuită în Make. Dacă aveți nevoie de verificări explicite ale semnăturii, construiți o integrare personalizată folosind SDK-ul. - Numărul de operațiuni. Fiecare apel API al unui modul de acțiune se consumă din cota dvs. de operațiuni Make, nu din resursele de pe partea B1.
Depanare
- Testul conexiunii eșuează — cel mai adesea din cauza unei greșeli de scriere în cheia API. Copiați-o din nou din B1Admin (cheia completă este afișată o singură dată; dacă ați pierdut-o, creați o cheie nouă).
- Modulul declanșator nu se activează — verificați Setări → Dezvoltator → Webhooks în B1Admin. Dacă nu vedeți un rând „Make — <event>” după activarea scenariului, cheia nu are
settings:write. Actualizați cheia și reactivați scenariul. - Acțiunea returnează
403 Forbidden— cheia API nu are domeniul de acces pentru acel endpoint. De exemplu, Adaugă donație necesitădonations:write. Actualizați cheia în B1Admin și testați din nou.
Personalizarea aplicației
Aplicația B1.church pentru Make este open source: definițiile JSON se află în repository-ul B1Integrations/Make/. Dacă aveți nevoie de un modul care nu există (de exemplu, o acțiune nouă pentru un endpoint pe care nu l-am acoperit încă), deschideți un issue sau un PR în acel repository.
Vezi și
- Zapier — același model, cu o interfață mai simplă și un catalog mai mare de aplicații
- Slack și Discord — notificări de chat integrate, fără Make
- Webhooks (referință pentru dezvoltatori)