Make
Make (anciennement Integromat) est une plateforme visuelle d'automatisation de flux de travail — proche de Zapier dans son esprit, avec une logique plus souple et une facture moins élevée à grande échelle. L'application officielle B1.church pour Make vous permet de créer des « scénarios » qui réagissent instantanément aux événements B1 et y écrivent des enregistrements.
L'application B1.church pour Make n'est pas encore publiée dans le répertoire d'applications de Make : vous ne pouvez donc pas ajouter les modules B1.church décrits ci-dessous à un scénario aujourd'hui. D'ici là, utilisez Zapier, ou appelez l'API REST de B1 depuis le module HTTP — Effectuer une requête de Make avec une clé API. Tout ce qui suit décrit le fonctionnement de l'application une fois publiée.
Avant de commencer
- Un compte Make (l'offre gratuite couvre les petits flux de travail)
- Un administrateur d'église disposant de l'autorisation Modifier les paramètres dans B1Admin
- Une idée générale du scénario que vous souhaitez créer
Modules
| Type | Quoi | Événement / point de terminaison B1 |
|---|---|---|
| Déclencheur instantané | Surveiller les événements | tout événement B1 auquel vous êtes abonné (person.created, donation.created, …) |
| Action | Créer une personne | ajoute une nouvelle personne |
| Action | Ajouter un don | enregistre un don |
| Action | Ajouter un membre de groupe | ajoute une personne à un groupe |
| Recherche | Rechercher des personnes | trouve des personnes par nom ou par courriel |
Le déclencheur instantané vous permet de choisir l'événement à surveiller — un seul module déclencheur par scénario, configuré pour chaque événement.
Configuration
1. Créer une clé API B1
- Dans B1Admin, allez dans Paramètres → Développeur → Clés API.
- Cliquez sur Nouvelle clé API, nommez-la « Make », et accordez les autorisations dont vous avez besoin.
- Incluez
settings:writesi l'un de vos scénarios utilise le déclencheur instantané — Make enregistre un webhook en votre nom lorsque le scénario est activé. - Accordez également les autorisations nécessaires aux modules d'action (par exemple
donations:writepour le module Ajouter un don). - Enregistrez et copiez la clé
cak_….
2. Installer la connexion
- Dans Make, créez un nouveau scénario et déposez le module déclencheur B1.church sur le canevas.
- Lorsque vous y êtes invité, créez une connexion. Collez la clé API dans le champ Clé API et laissez le champ URL de base de l'API sur
https://api.churchapps.org(sauf si vous testez sur l'environnement de préproduction). - Cliquez sur Enregistrer — Make teste la clé en lisant le profil de votre église.
La connexion est enregistrée dans votre compte Make et réutilisée d'un scénario à l'autre.
3. Configurer le déclencheur
- Ouvrez les paramètres du module Surveiller les événements.
- Choisissez l'événement souhaité — par exemple
donation.created. - Enregistrez. Make génère une URL de webhook unique et la stocke en interne.
4. Ajouter les modules en aval
Déposez sur le canevas l'un des centaines de modules d'applications de Make — Mailchimp, Google Sheets, Slack, HubSpot, votre propre point de terminaison HTTP, etc. Associez la sortie du déclencheur (event, churchId, data.id, data.amount, …) aux champs de saisie. Les modules Aplatir / Itérateur / Routeur / Agrégateur de Make vous permettent de construire des flux en embranchement et en parallèle, difficiles à réaliser avec Zapier.
5. Activer le scénario
Basculez sur Actif dans l'en-tête du scénario. Make appelle POST /membership/webhooks de B1 pour enregistrer l'URL. À partir de ce moment, chaque événement B1 correspondant parcourt le scénario en temps réel.
Désactiver le scénario appelle DELETE /membership/webhooks/{id} afin qu'aucun abonnement orphelin ne subsiste.
Recettes courantes
Synchroniser les dons vers un Google Sheet pour la revue financière
- Déclencheur — B1 : Surveiller les événements (
donation.created) - Action — Google Sheets : Ajouter une ligne. Associez
data.donationDate,data.amount,data.personId,data.method,data.batchIdaux colonnes de la feuille.
Notification Slack conditionnelle selon le montant du don
- Déclencheur — B1 : Surveiller les événements (
donation.created) - Routeur :
- Branche A — Filtre :
data.amount >= 1000→ Slack : publier dans#major-gifts - Branche B — par défaut → Slack : publier dans
#donations
- Branche A — Filtre :
Nouvelle personne → CRM + courriel de bienvenue + Slack
- Déclencheur — B1 : Surveiller les événements (
person.created) - Action — HubSpot : Créer un contact
- Action — Mailgun : Envoyer un courriel de bienvenue
- Action — Slack : Avertir
#new-people(en parallèle — utilisez le routeur de Make)
Fonctionnement du déclencheur instantané
Le déclencheur instantané repose sur un webhook, et non sur une interrogation périodique : lors de l'activation, Make appelle POST /membership/webhooks avec son URL générée et l'événement choisi. Lorsque l'événement se produit dans B1, B1 envoie l'enveloppe à l'URL de Make, et votre scénario s'exécute en quelques secondes. Désactiver le scénario supprime le webhook.
Le déclencheur ne se déclenche que pour les événements qui surviennent pendant que le scénario est actif. Il n'y a pas de rattrapage des événements passés.
Limites et remarques
- Un événement par module Surveiller les événements. Pour écouter plusieurs événements, créez un scénario par événement.
- La vérification de signature n'est pas exposée — Make ne transmet pas
X-B1-Signatureau scénario ; la limite de confiance est l'URL de webhook propre à chaque scénario, impossible à deviner. C'est une pratique courante avec Make. Si vous avez besoin de vérifications de signature explicites, créez plutôt une intégration sur mesure avec le SDK. - Nombre d'opérations — chaque appel d'API effectué par un module d'action est décompté de votre quota d'opérations Make, et non de quoi que ce soit côté B1.
Dépannage
- Le test de connexion échoue — le plus souvent, il s'agit d'une faute de frappe dans la clé API. Recopiez-la depuis B1Admin (la clé complète n'est affichée qu'une seule fois ; si vous l'avez perdue, créez-en une nouvelle).
- Le module déclencheur ne s'active pas — vérifiez Paramètres → Développeur → Webhooks dans B1Admin. Si vous ne voyez pas de ligne « Make — <événement> » après l'activation du scénario, la clé ne comporte pas
settings:write. Mettez la clé à jour et réactivez le scénario. - L'action renvoie
403 Forbidden— la clé API ne comporte pas l'autorisation nécessaire pour ce point de terminaison. Par exemple, Ajouter un don nécessitedonations:write. Mettez la clé à jour dans B1Admin et refaites le test.
Module manquant ?
Si vous avez besoin d'un module qui n'existe pas (par exemple, une nouvelle action pour un point de terminaison que nous n'avons pas encore couvert), écrivez à support@churchapps.org. En attendant, le module HTTP — Effectuer une requête de Make peut appeler n'importe quel point de terminaison de B1 avec un en-tête Authorization: Bearer cak_….
Voir aussi
- Zapier — même principe, avec une interface plus simple et un catalogue d'applications plus vaste
- Slack et Discord — notifications de messagerie intégrées, sans Make
- Webhooks (référence développeur)