L’une des fonctionnalités intéressantes de SuperSaaS est le système de crédits, qui permet aux utilisateurs finaux d’acheter des crédits une fois, puis de payer facilement leurs rendez-vous sans avoir à passer par tout le processus de paiement à chaque fois. Plusieurs éléments peuvent affecter un solde de crédits. Les achats de crédits et les nouveaux rendez-vous, bien entendu, mais aussi les remboursements dus aux annulations de rendez-vous, et les ajustements manuels de crédits effectués par un superutilisateur.
Il peut parfois être utile d’examiner en détail les actions qui ont 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 de l’historique 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.
Cet article est un tutoriel étape par étape pour configurer la journalisation des informations de crédits utilisateurs dans une feuille Google à l’aide de Pipedream, un puissant service d’intégration d’API.
À la fin de ce tutoriel, votre feuille de calcul ressemblera à ceci :
Création d’un compte Pipedream et d’un tableur
Le fonctionnement de Pipedream repose sur la création de workflows, qui sont des flux d’informations capables de connecter plusieurs services, comme SuperSaaS et Google Sheets. Pour ce cas d’utilisation particulier, un seul workflow suffit.
La première chose à faire est de créer un compte sur 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 New Workflow pour créer un nouveau workflow, puis sur le bouton Add Trigger pour ajouter la condition de déclenchement.
Connexion à SuperSaaS
Ensuite, configurez le déclencheur du workflow qui écoutera les événements SuperSaaS liés aux crédits.
Dans la barre de recherche, tapez SuperSaaS et sélectionnez-le dans la liste des résultats. Vous souhaitez utiliser le déclencheur Credit Balance Changes, cliquez dessus. Vous avez maintenant un workflow avec un déclencheur, mais vous devez encore connecter votre déclencheur à votre compte SuperSaaS. Cliquez sur le bouton bleu Connect a SuperSaaS account dans le panneau de droite, entrez le nom de votre compte et votre clé API.
Suivez les instructions dans 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 Save.
Maintenant, sélectionnez tous les plannings sur lesquels vos utilisateurs peuvent 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.
Assurez-vous de cliquer sur le bouton Save and continue et de générer un événement de test de changement de crédit dans SuperSaaS pour tester et activer le déclencheur.
Après avoir créé un nouveau client avec des crédits, vous devriez voir après quelques secondes :
Cliquez sur le bouton bleu Continue pour passer à l’étape suivante et ajouter une action qui se produit lorsque le déclencheur se déclenche.
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é-construite Add Single Row est recommandée.
Cliquez sur le bouton bleu Connect a Google Sheets account et suivez les instructions pour connecter votre compte Pipedream à un compte Google Sheets où vous souhaitez stocker vos journaux de crédits utilisateurs.
Une fois la connexion établie, ouvrez Google Sheets et créez un tableur pour stocker vos journaux de crédits. Vous pouvez lui donner le nom que vous souhaitez. Il apparaîtra dans la liste déroulante Pipedream ci-après.
Sélectionnez le tableur que vous venez de créer dans la liste déroulante, puis le nom de la feuille/onglet dans le champ Worksheet ID.
Selon que votre tableur contient une ligne d’en-tête avec les noms des champs, vous devez sélectionner TRUE ou FALSE dans le champ suivant pour continuer.
Dans le champ Values, vous devez sélectionner parmi les données chargées depuis l’événement de test chaque champ que vous souhaitez utiliser pour remplir les nouvelles colonnes. Une configuration recommandée est la suivante :
Vous obtiendrez ainsi les colonnes Created On, Event Type (New User, Credit Change, etc.), User Email et Credit Value.
Cliquez sur le bouton bleu Test et vérifiez que la ligne a bien été créée dans votre tableur. À partir de maintenant, il ne vous reste plus qu’à cliquer sur le bouton Deploy et votre pipeline est prêt à fonctionner !
Testez pour vous assurer que ça fonctionne !
Maintenant que tout est configuré, assurez-vous de créer un nouveau compte, de prendre des rendez-vous et de vérifier votre tableur pour voir si tout fonctionne. Après chaque action utilisateur, la mise à jour de votre tableur devrait prendre moins de 5 secondes.
Utilisez les filtres standard de Google Sheets pour vérifier l’historique des soldes d’un utilisateur sur les plages de dates/heures qui vous intéressent.
Aller plus loin
Si vous êtes enthousiaste à propos de ce type d’automatisation et d’intégration de services, vous souhaitez peut-être créer quelque chose d’autre qui répond à vos besoins spécifiques ?
Dans ce cas, n’hésitez pas à explorer les autres sources d’événements/déclencheurs SuperSaaS disponibles pour Pipedream :
La procédure de configuration du déclencheur sera toujours très similaire à celle des Credit balance changes que nous avons créée précédemment, alors n’hésitez pas à jouer avec les autres options.
D’autres intégrations en sortie peuvent ne pas nécessiter beaucoup de connaissances techniques, comme l’envoi d’e-mails lorsque des rendez-vous sont créés ou mis à jour — gratuitement.
Utiliser les webhooks personnalisés de SuperSaaS à la place
Si vous utilisez les déclencheurs SuperSaaS pour Pipedream, ce qu’ils font réellement en coulisses, c’est configurer des webhooks SuperSaaS contre les déclencheurs HTTP/Webhook intégrés de Pipedream.
En utilisant la fonctionnalité premium de webhooks personnalisés de SuperSaaS, vous pouvez également le faire manuellement et transférer 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 Changed form et Send mail.
Supposons que vous souhaitiez configurer un workflow qui se déclenche chaque fois qu’un de vos utilisateurs met à jour un formulaire : Sur votre compte Pipedream, cliquez à nouveau sur New Workflow et sélectionnez le déclencheur intégré HTTP / Webhook.
Les paramètres d’endpoint par défaut conviennent aux webhooks SuperSaaS, cliquez sur Save and continue.
Cliquez sur Save and continue et copiez l’endpoint généré (par ex. https://example.m.pipedream.net) sur la page webhooks personnalisés de SuperSaaS. Sélectionnez le déclencheur qui vous intéresse (par ex. Changed form), remplissez ses paramètres (le cas échéant, par ex. dans ce cas, quel formulaire suivre), et utilisez votre endpoint HTTP Pipedream comme URL cible.
Tous les autres webhooks existants dans la capture d’écran ont été créés automatiquement et sont gérés par le déclencheur Credit balance changes de SuperSaaS que nous avons configuré au début de ce tutoriel.
Vous pouvez également créer plusieurs webhooks personnalisés pour le même URL cible si cela est pertinent pour votre cas d’utilisation particulier. À titre d’exemple, les sources d’événements Credit balance changes nécessitent au moins 3 webhooks, par exemple : Changed user, Credit purchase et Changed appointment (un pour chaque planning suivi), et tous pointent vers le même endpoint de workflow.
Une fois votre webhook personnalisé créé, vous pouvez cliquer sur le lien Test webhook, puis sur le bouton Post payload now 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, et le rejouer facilement depuis l’interface Pipedream pour tester rapidement l’ensemble de votre workflow.
Une fois le payload envoyé, vous devriez bientôt le voir dans votre workflow Pipedream.
Avec cela, vous êtes prêt à ajouter les actions Pipedream que vous jugez appropriées à exécuter lorsque votre compte SuperSaaS émet des événements Changed form pour le formulaire que vous suivez.
Si vous avez des questions relatives à SuperSaaS, notre équipe d’assistance est prête à vous aider.
Il s’agit d’une version réécrite d’un article publié le 2 novembre 2020