Envoyer les achats Curling IO à Zapier ou n8n

Cet article fait partie de notre série d’aperçus de Curling IO v3, où nous explorons certaines fonctions offertes dans la prochaine version.

Les clubs doivent souvent envoyer des renseignements sur les achats à des systèmes externes à Curling IO. Il peut s’agir de mettre à jour un tableur, d’aviser le personnel ou de lancer un processus dans un autre service.

Les locations en sont un exemple. Quelqu’un peut devoir préparer le salon, réserver des tables, organiser un service de traiteur ou ajouter la réservation au tableur du personnel.

Les webhooks de Curling IO v3 peuvent envoyer cet achat de produit à Zapier, n8n ou un autre point de terminaison HTTPS lorsqu’il est soumis, payé, annulé ou déplacé à une autre heure.

Choisir les produits à surveiller

Un webhook envoie un seul type de notification à une seule destination. Un club peut envoyer :

• tous les produits;
• les produits de certains types sélectionnés, comme les locations;
• des produits individuels, comme quatre options précises de location pour entreprises.

Le filtre de produits offre ces trois portées. Si deux destinataires doivent recevoir des produits différents, l’administrateur crée un webhook distinct pour chaque destinataire et chaque portée.

Les locations et leurs extras sont des produits. La même configuration de webhook fonctionne aussi pour les adhésions, les ligues, les programmes et les autres produits.

Un webhook peut envoyer tous les produits, certains types de produits ou des produits individuels. Celui-ci envoie les achats de locations payés à Zapier.

Choisir le moment de l’envoi

Un webhook utilise un seul déclencheur :

• Un produit est soumis après la finalisation de la commande.
• Un produit est payé en totalité la première fois que sa ligne de commande est entièrement payée.
• Un produit est annulé lorsqu’une affectation de remboursement annule la ligne de commande. Réduire sa quantité ou sa valeur n’envoie pas cette notification.
• Un produit est replanifié lorsqu’un administrateur change l’heure de début du produit acheté dans le calendrier.

Un processus qui exige plusieurs déclencheurs peut utiliser des webhooks distincts vers la même destination.

Choisir ce que reçoit le destinataire

Le club choisit les champs d’achat envoyés par chaque webhook. Les nouveaux webhooks commencent avec 16 champs recommandés qui couvrent la commande, l’inscription, le produit, les prix et l’horaire. Les renseignements sur l’acheteur et le participant ne sont pas sélectionnés par défaut.

Les champs sont regroupés et peuvent être recherchés. Un administrateur peut sélectionner un groupe entier, le désélectionner ou revenir à la sélection recommandée. L’aperçu de la charge utile se met à jour immédiatement. Le club peut donc voir les clés JSON et des valeurs représentatives avant d’enregistrer ou d’envoyer un test.

Cet exemple utilise une petite sélection de champs pour montrer toute la charge utile. Les détails de livraison sont toujours inclus; les autres clés suivent la sélection enregistrée.

Les champs sur l’acheteur et le participant portent la mention Sensible. Les questions personnalisées sur les participants et les inscriptions portent la mention Peut être sensible, puisque cela dépend de la question. Curling IO avertit l’administrateur, mais laisse le club décider si la destination doit recevoir ces renseignements. Les mots de passe, les jetons d’authentification, les données de carte de paiement et les secrets des fournisseurs de paiement ne peuvent pas être sélectionnés.

Curling IO accepte uniquement des URL HTTPS publiques comme destinations, ce qui chiffre la requête pendant son transport. Curling IO ne contrôle pas la façon dont Zapier, n8n ou un autre service destinataire traite les données après leur livraison et n’est pas responsable de ce traitement par un tiers. Le club est responsable du choix du service et des champs qu’il lui envoie.

Tester le destinataire avant d’activer le webhook

L’administrateur peut laisser un webhook désactivé et sélectionner Envoyer un test. Le test utilise la sélection de champs enregistrée et le véritable parcours de livraison. Il contient une location représentative pour que Zapier ou n8n puisse découvrir les champs JSON sélectionnés avant l’activation du webhook.

Dans Zapier, utilisez un déclencheur Webhooks by Zapier > Catch Hook. Dans n8n, utilisez un nœud Webhook. Copiez l’URL HTTPS du destinataire dans Curling IO, envoyez le test et associez les champs avant d’activer l’automatisation.

Fiabilité des livraisons

Les appels de webhook s’exécutent en arrière-plan. Curling IO réessaie jusqu’à cinq fois en cas de panne réseau, de délai d’attente dépassé, de limite de débit ou d’erreur du serveur. Le destinataire peut utiliser l’identifiant stable de publication du webhook pour éliminer un doublon si une requête réussit, mais que sa réponse se perd.

Chaque requête est signée avec HMAC-SHA256 pour les destinataires qui peuvent vérifier la signature. Un déclencheur Catch Hook de Zapier repose normalement plutôt sur son URL difficile à deviner. Cette URL doit donc être traitée comme un mot de passe.

Les administrateurs peuvent consulter les Livraisons récentes, voir les tentatives et les codes d’état HTTP, réessayer une livraison échouée encore conservée, renouveler le secret de signature ou désactiver le webhook. Les données détaillées de charge utile et de livraison sont supprimées après 30 jours. Chaque livraison conserve le corps exact de sa requête, et chaque nouvelle tentative renvoie ce même corps, même si la sélection de champs ou les données d’achat changent par la suite.

Les livraisons récentes montrent les requêtes réussies, les tentatives échouées, les codes d’état HTTP et le moment où une livraison échouée peut être réessayée.

Consultez le guide de configuration des webhooks pour la charge utile, les étapes dans Zapier et n8n, les règles de nouvelle tentative et la vérification des signatures.