Zapier

Zapier est la façon la plus simple de pousser les événements GCM vers le reste de votre stack. Nouveau membre ajouté ? Acheminez-le dans votre Google Sheet de visites pastorales. Don enregistré ? Postez un remerciement dans le canal Slack de votre église. Membre ayant terminé un workflow ? Étiquetez-le dans votre CRM.

GCM livre une app Zapier native construite sur REST Hooks — ce qui signifie que Zapier s'abonne à un webhook de notre côté, et nous poussons les événements au fur et à mesure. Pas de polling, pas de délai, pas de tâches Zap gaspillées.

Comment fonctionne l'intégration

1. Vous créez une clé API dans GCM (Integrations → Zapier → API Keys).
2. Dans Zapier, vous créez un nouveau Zap et choisissez GCM comme application déclencheur.
3. Zapier demande votre clé API et la valide auprès de notre endpoint /v1/me.
4. Vous choisissez un événement déclencheur (par ex. Member created).
5. Zapier enregistre un abonnement auprès de notre endpoint /v1/subscriptions — c'est le REST Hook.
6. À partir de là, chaque fois que l'événement se déclenche, GCM POST le payload vers le target_url de l'abonnement (une URL de webhook opaque hébergée par Zapier).

Vous pouvez avoir autant d'abonnements que vous voulez, sur autant de Zaps. Ils vivent tous sous une même clé API.

Étape 1 — Générer une clé API

Dans GCM, allez dans Integrations → Zapier. Dans l'onglet API Keys, cliquez sur New key.

Donnez-lui une étiquette que vous reconnaîtrez plus tard — Zapier — Production est un bon défaut. Quand vous cliquez sur créer, GCM vous montre la clé brute une seule fois. Copiez-la immédiatement et collez-la quelque part en sécurité (un gestionnaire de mots de passe, l'écran de connexion Zapier).

WARNING

Nous ne montrons pas la clé brute à nouveau — pour des raisons de sécurité, nous ne stockons qu'un hash. Si vous la perdez, révoquez la clé et créez-en une nouvelle.

La clé commence par un préfixe reconnaissable (gcm_live_…) pour que vous puissiez voir d'un coup d'œil à quel environnement elle appartient. La portion visible dans la liste des clés est le préfixe plus des points de suspension — utile pour « quelle clé ce Zap utilise-t-il » sans fuiter le secret.

Étape 2 — Se connecter dans Zapier

Dans Zapier, cherchez l'application Genius Church Manager, cliquez sur + Create Zap, et choisissez un déclencheur. Quand Zapier demande l'authentification :

• API Key : collez la clé gcm_live_… de l'Étape 1.
• Organization : détectée automatiquement depuis la clé. Pas besoin de saisir le slug de votre organisation.

Zapier appelle notre endpoint /v1/me, confirme que la clé est valide, et stocke la connexion.

Étape 3 — Choisir un événement déclencheur

L'application Zapier expose ces déclencheurs :

Événement	Se déclenche quand
member.created	Un nouveau membre est ajouté (toute source — manuelle, formulaire visiteur, import)
member.updated	Tout champ suivi sur un membre change
donation.created	Un don est enregistré (en ligne, manuel ou prélèvement récurrent)
attendance.recorded	Un pointage ou une ligne d'assiduité est enregistré
workflow.completed	Un membre termine une exécution de workflow
form.submitted	Un formulaire public est soumis
group.member_added	Quelqu'un est ajouté à un petit groupe ou un ministère

Chaque événement envoie un payload JSON qui reflète la ressource GCM correspondante. Voir la référence des webhooks API pour la forme exacte des champs.

Abonnements actifs

Une fois votre Zap activé, il apparaît dans l'onglet Subscriptions.

Chaque ligne affiche le type d'événement, l'URL du webhook Zapier (pour que vous puissiez confirmer qu'elle pointe vers le bon Zap), la dernière livraison et un compteur d'échecs. Après 10 échecs consécutifs nous désactivons automatiquement l'abonnement — Zapier fait la même chose de son côté, donc cela vous protège d'un Zap incontrôlé qui se déclencherait des milliers de fois sur un endpoint supprimé.

Un abonnement désactivé obtient un badge rouge. Éteignez puis rallumez le Zap dans Zapier pour le recréer.

Livraisons récentes

L'onglet Recent deliveries affiche les 50 derniers événements que GCM a poussés.

Chaque ligne contient :

• Une coche verte (HTTP 2xx) ou un point d'exclamation rouge (4xx / 5xx).
• Le type d'événement.
• Le statut de réponse HTTP renvoyé par Zapier.
• Un court extrait du corps de la réponse (généralement l'ID Zapier et un hash).
• Un compteur de réessais — nous réessayons les livraisons échouées avec un délai exponentiel jusqu'à 4 fois avant de marquer la ligne comme échouée.

Ce journal est votre source unique de vérité quand un Zap « a arrêté de fonctionner ». Vérifiez ici d'abord.

Révoquer une clé

Quand un membre du personnel part ou que vous soupçonnez qu'une clé a fuité, cliquez sur l'icône poubelle dans l'onglet API Keys.

WARNING

Révoquer une clé casse instantanément chaque Zap qui l'utilise. Le Zap affiche une bannière rouge dans Zapier (« authentication failed ») et vous devrez vous reconnecter avec une nouvelle clé. Planifiez une fenêtre de rotation.

Ce que Zapier peut lire

Les clés API créées via cette interface ont par défaut une portée en lecture seule (read:*). Cela signifie qu'un Zap peut lister membres, dons, assiduité — mais ne peut pas en créer ni les modifier. Des portées d'écriture sont disponibles via les clés d'API mais devraient être utilisées avec parcimonie.

Limites

Limite	Par défaut
Clés API par organisation	20
Abonnements actifs par organisation	100
Débit de livraison	60 événements / minute / abonnement
Taille du payload	256 Ko
Tentatives de réessai	4 (1 min, 5 min, 25 min, 2 h)

Si vous atteignez la limite d'abonnements, vous avez presque certainement des Zaps orphelins — supprimez les inutilisés dans Zapier et ils tomberont de notre côté en moins d'une heure.

Références croisées

• Clés d'API — référence complète des portées et politique de rotation.
• Webhooks sortants — même infrastructure de livraison, mais pointée vers votre propre endpoint au lieu de Zapier.
• Référence des webhooks — formes exactes des payloads pour chaque événement.