Journaliser les modifications de crédit utilisateur avec Google Sheets et Pipedream

Suivez les modifications de crédit utilisateur à l'aide d'un simple tableur
Nov 2, 2020 6 min read
Journaliser les modifications de crédit utilisateur avec Google Sheets et Pipedream

L’une des fonctionnalités pratiques de SuperSaaS est le système de crédits, qui permet aux utilisateurs finaux d’acheter des crédits une seule fois et de régler ensuite facilement leurs rendez-vous sans avoir à effectuer l’intégralité du processus de paiement à chaque fois. Plusieurs événements peuvent affecter le solde de crédits. Les achats de crédits et les nouveaux rendez-vous, évidemment, mais aussi les remboursements dus à des annulations et les ajustements manuels de crédits par un super-utilisateur.

Il peut parfois être utile d’avoir une vue détaillée des actions ayant affecté le solde de crédits d’un utilisateur, mais il n’est pas toujours facile de reconstituer ce qui s’est passé à partir de l’historique des achats et des rendez-vous. C’est dans ces situations que la combinaison de services comme les intégrations Pipedream avec SuperSaaS et Google Sheets peut s’avérer très pratique pour afficher un journal de tous les événements affectant les crédits.

Ce guide est un tutoriel étape par étape pour configurer la journalisation des informations de crédit utilisateur dans une feuille Google Sheets via Pipedream, un puissant service d’intégration d’API.

À la fin de ce tutoriel, votre feuille de calcul ressemblera à ceci :

Capture d’écran Google Sheets montrant les journaux de crédit utilisateur

Création du compte Pipedream et de la feuille de calcul

Pipedream fonctionne en créant des workflows, c’est-à-dire des flux d’informations capables de connecter plusieurs services, tels que SuperSaaS et Google Sheets. Pour ce cas d’utilisation spécifique, un seul workflow suffit.

La première étape consiste à créer un compte dans SuperSaaS et sur Pipedream.com. Assurez-vous d’être authentifié avant de continuer.

Une fois authentifié, accédez à la page Workflows de votre compte Pipedream et cliquez sur le bouton Nouveau workflow pour créer un nouveau workflow, puis sur le bouton Ajouter un déclencheur pour ajouter la condition de déclenchement.

Capture d’écran Pipedream montrant la boîte de dialogue Ajouter un déclencheur

Connexion à SuperSaaS

Configurez ensuite le déclencheur du workflow qui écoutera les événements SuperSaaS liés aux crédits.

Dans la barre de recherche, saisissez SuperSaaS et sélectionnez-le dans la liste des résultats. Intéressez-vous ensuite au déclencheur Modifications du solde de crédits et cliquez dessus. Vous disposez maintenant d’un workflow avec un déclencheur, mais vous devez encore connecter votre déclencheur à votre compte SuperSaaS. Cliquez sur le bouton bleu Connecter un compte SuperSaaS dans le panneau de droite, saisissez le nom de votre compte et la clé API.

Suivez les instructions de la boîte de dialogue pour créer la connexion entre vos comptes Pipedream et SuperSaaS. Obtenez votre clé API SuperSaaS en bas de votre page Informations du compte, saisissez-la dans le champ api_key et cliquez sur le bouton Enregistrer.

Capture d’écran de la boîte de dialogue Pipedream montrant un formulaire pour la création d’une nouvelle connexion à un compte SuperSaaS exemple

Sélectionnez maintenant tous les plannings sur lesquels vos utilisateurs sont susceptibles de dépenser leurs crédits. Ce workflow ne suivra pas les crédits dépensés sur d’autres plannings, alors sélectionnez-les tous pour vous assurer que votre feuille de calcul ne manquera aucune donnée.

Capture d’écran du déclencheur Pipedream montrant le champ « Plannings » et les options disponibles

Assurez-vous de cliquer sur le bouton Enregistrer et continuer et de générer un événement de test de modification de crédits dans SuperSaaS pour tester et activer le déclencheur.

Pipedream en attente d’un événement de test

Après avoir créé un nouveau client avec des crédits, vous devriez voir après quelques secondes :

Succès de l’événement de test Pipedream

Cliquez sur le bouton bleu Continuer pour passer à l’étape suivante et ajouter une action qui se déclenche lorsque le déclencheur se produit.

Ajout de l’étape de journalisation Google Sheets

Maintenant que le déclencheur est configuré, vous pouvez sélectionner Google Sheets dans la liste des actions disponibles. L’action préintégrée Ajouter une ligne est recommandée.

Cliquez sur le bouton bleu Connecter un compte Google Sheets et suivez les instructions pour connecter votre compte Pipedream à un compte Google Sheets où vous souhaitez stocker vos journaux de crédits utilisateur.

Une fois connecté avec succès, ouvrez Google Sheets et créez une feuille de calcul pour stocker vos journaux de crédits. Vous pouvez la nommer comme vous le souhaitez, le nom apparaîtra dans la liste déroulante Pipedream.

Liste déroulante Google Sheets dans Pipedream

Sélectionnez la feuille de calcul que vous venez de créer dans la liste déroulante, puis le nom de la feuille/onglet dans le champ ID de la feuille de calcul.

Selon que votre feuille de calcul contient une ligne d’en-tête avec des noms de champs, sélectionnez VRAI ou FAUX dans le champ suivant pour continuer.

Dans le champ Valeurs, vous devez sélectionner parmi les données chargées depuis l’événement de test chaque champ que vous souhaitez remplir dans les nouvelles colonnes. Une configuration recommandée est la suivante :

Valeurs des colonnes Google Sheets dans Pipedream

Cela vous donnera une Date de création, un Type d’événement (Nouvel utilisateur, Modification de crédit, etc.), un E-mail utilisateur et la Valeur du crédit.

Cliquez sur le bouton bleu Tester et confirmez que la ligne a été créée dans votre feuille de calcul. À partir de maintenant, il vous suffit de cliquer sur le bouton Déployer et votre pipeline est prêt à fonctionner !

Testez que tout fonctionne !

Maintenant que vous avez tout configuré, assurez-vous de créer un nouveau compte, de prendre des rendez-vous et de vérifier votre feuille de calcul pour voir si tout fonctionne. Après chaque action utilisateur, la mise à jour de votre feuille de calcul devrait prendre moins de 5 secondes.

Utilisez les filtres standard de Google Sheets pour vérifier l’historique du solde d’un seul utilisateur sur les plages de dates/heures qui vous intéressent.

Pour aller plus loin

Si ce type d’automatisation et d’intégration de services vous enthousiasme et que vous souhaitez construire quelque chose qui correspond à vos besoins spécifiques, découvrez les autres sources d’événements/déclencheurs SuperSaaS disponibles pour Pipedream :

Page Nouveau workflow de Pipedream montrant les options de déclencheur SuperSaaS

La procédure de configuration du déclencheur sera toujours très similaire à celle du Modifications du solde de crédits que nous avons créé précédemment, donc n’hésitez pas à explorer les autres options.

D’autres intégrations en sortie peuvent ne pas nécessiter beaucoup de connaissances techniques, comme vous envoyer des e-mails lors de la création ou de la mise à jour de rendez-vous — gratuitement.

Utiliser les webhooks personnalisés SuperSaaS à la place

Si vous utilisez les déclencheurs SuperSaaS pour Pipedream, ce qu’ils font en réalité en coulisses est de configurer des webhooks SuperSaaS contre les déclencheurs HTTP/Webhook intégrés de Pipedream.

Grâce à la fonctionnalité premium de webhooks personnalisés de SuperSaaS, vous pouvez également le faire manuellement et transmettre n’importe quel événement webhook SuperSaaS possible vers vos workflows Pipedream, même ceux que nous n’avons pas encore intégrés dans Pipedream, comme les événements Formulaire modifié et Envoyer un e-mail.

Supposons que vous souhaitiez configurer un workflow qui se déclenche chaque fois que l’un de vos utilisateurs met à jour un formulaire : dans votre compte Pipedream, cliquez à nouveau sur Nouveau workflow et sélectionnez le déclencheur intégré HTTP / Webhook.

Page Nouveau workflow de Pipedream montrant l’option de déclencheur HTTP / Webhook

Les paramètres de l’endpoint par défaut conviennent aux webhooks SuperSaaS. Cliquez sur Enregistrer et continuer.

Formulaire de configuration du déclencheur HTTP / Webhook intégré de Pipedream

Cliquez sur Enregistrer et continuer et copiez l’endpoint généré (par ex. https://example.m.pipedream.net) sur la page des webhooks personnalisés de SuperSaaS. Sélectionnez le déclencheur qui vous intéresse (par ex. Formulaire modifié), renseignez ses paramètres (le cas échéant, par ex. quel formulaire suivre), et utilisez votre endpoint HTTP Pipedream comme URL cible.

Tableau de bord des webhooks personnalisés SuperSaaS montrant les webhooks existants et un formulaire de création de webhook personnalisé

Tous les autres webhooks existants dans la capture d’écran ont été créés automatiquement et sont gérés par la source d’événements Modifications du solde de crédits que nous avons configurée au début de ce tutoriel.

Vous pouvez également créer plusieurs webhooks personnalisés pointant vers la même URL cible si cela convient à votre cas d’utilisation. Par exemple, les sources d’événements Modifications du solde de crédits nécessitent au moins 3 webhooks : Utilisateur modifié, Achat de crédit et Rendez-vous modifié (un pour chaque planning suivi), tous pointant vers le même endpoint de workflow.

Une fois votre webhook personnalisé créé, vous pouvez cliquer sur le lien Tester le webhook, puis sur le bouton Envoyer le payload maintenant pour envoyer un événement de test à votre workflow. Vous pourrez utiliser cet événement de test comme référence pour configurer le reste de votre workflow, ainsi que le rejouer facilement depuis l’interface Pipedream pour tester rapidement l’ensemble de votre workflow.

Lien « Tester le webhook » dans SuperSaaS

Page « Tester le webhook » dans SuperSaaS

Une fois le payload envoyé, vous devriez le voir apparaître dans votre workflow Pipedream.

Workflow Pipedream affichant le payload de l’événement de test reçu

Vous pouvez maintenant ajouter toutes les actions Pipedream que vous jugez appropriées pour être exécutées lorsque votre compte SuperSaaS émet des événements Formulaire modifié pour le formulaire que vous suivez.

Si vous avez des questions relatives à SuperSaaS, notre équipe de support est prête à vous aider.

Il s’agit d’une version réécrite d’un article publié le 2 novembre 2020