Eine praktische Funktion von SuperSaaS ist das Guthabensystem, mit dem Endnutzer Guthaben kaufen und damit bequem Termine bezahlen können, ohne den gesamten Zahlungsprozess jedes Mal erneut durchlaufen zu müssen.
Es gibt mehrere Aktionen, die eine Konto-Bilanz des Guthabens beeinflussen können:
- Käufe von Guthaben
- Bezahlung von neuen Terminen
- Rückerstattungen wegen stornierter Termine
- Manuelle Guthabenanpassungen durch Superbenutzer und Administrator
Es kann manchmal hilfreich sein, einen detaillierten Blick auf die Aktionen zu werfen, die den Kontostand eines Benutzers verändert haben. Aus Kaufhistorie und Terminverlauf allein lässt sich jedoch nicht immer leicht nachvollziehen, was passiert ist. In genau solchen Situationen ist die Kombination von Softwareangeboten von Google Sheets und Pipedream als Integration bei SuperSaaS sehr nützlich, um ein Protokoll aller Ereignisse zu zeigen, die eine Gesamt-Bilanz des Guthabens beeinflussen.
Dieser Beitrag ist eine Schritt-für-Schritt-Anleitung, um das Protokollieren von Benutzer-Guthabeninformationen in einem Google Sheet mit Pipedream, einem leistungsstarken API-Integrationsdienst, einzurichten.
Am Ende dieser Anleitung sieht Deine Tabelle etwa so aus:
Pipedream-Konto und Tabellen-Kalkulation erstellen
Die Arbeitsweise von Pipedream besteht darin, dass Du Workflows erstellst, also Informationsabläufe, die mehrere Dienste, wie SuperSaaS und Google Sheets, miteinander verbinden können. Für diesen Anwendungsfall reicht ein einzelner Workflow aus.
Als Erstes musst Du ein Konto bei SuperSaaS und bei Pipedream.com erstellen. Stelle sicher, dass Du vor dem Fortfahren angemeldet bist.
Wenn Du angemeldet bist, gehst Du in Deinem Pipedream-Konto zur Seite Workflows und klickst auf die Schaltfläche New Workflow, um einen neuen Workflow zu erstellen, und anschließend auf Add Trigger, um die Trigger-Bedingung hinzuzufügen.
SuperSaaS verbinden
Konfiguriere als Nächstes den Workflow-Trigger, der auf Guthaben-bezogene SuperSaaS-Ereignisse wartet.
Gib in die Suche SuperSaaS ein und wähle es aus der Ergebnisliste aus. Dann suchst Du den Trigger Credit Balance Changes und klickst darauf. Jetzt hast Du einen Workflow mit einem Trigger und musst diesen noch mit Deinem SuperSaaS-Konto verbinden. Klicke im rechten Bereich auf Connect a SuperSaaS account, gib Deinen Kontonamen und Deinen API-Schlüssel ein.
Folge den Anweisungen im Dialog, um die Verbindung zwischen Deinen Pipedream- und SuperSaaS-Konten herzustellen.
Deinen SuperSaaS-API-Schlüssel findest Du im SuperSaaS-Konto unten auf Deinem Dashboard in den Kontoinfos und trage ihn im Feld api_key ein. Klicke anschließend auf Save.
Wähle nun alle Terminbuchungskalender aus, in denen Deine Benutzer ihr Guthaben ausgeben können. Dieser Workflow verfolgt nicht das Guthaben, das in anderen Terminbuchungskalendern verbraucht wird. Wähle also alle relevanten Terminbuchungskalender aus, damit in Deiner Tabellenkalkulation keine Daten fehlen.
Achte darauf, auf Save and continue zu klicken und in SuperSaaS ein Testereignis für eine Guthabenänderung zu erzeugen, um den Trigger zu testen und zu aktivieren.
Wenn Du einen neuen Kunden mit Guthaben angelegt hast, solltest Du nach ein paar Sekunden Folgendes sehen:
Klicke auf den blauen Button Continue, um fortzufahren und eine Aktion hinzuzufügen, die ausgeführt wird, wenn der Trigger ausgelöst wird.
Füge den Loginschritt von Google Sheets hinzu
Jetzt, da der Trigger konfiguriert ist, kannst Du Google Sheets aus der Liste der verfügbaren Aktionen auswählen. Die vorgefertigte Option Add Single Row wird empfohlen.
Klicke auf die blaue Schaltfläche Connect a Google Sheets account und folge den Anweisungen, um Dein Pipedream-Konto mit einem Konto für Google Sheets zu verbinden, in dem Du Deine Benutzer-Guthabenprotokolle speichern möchtest.
Wenn die Verbindung erfolgreich hergestellt wurde, öffnest Du Google Sheets und erstellst eine Tabelle für Deine Guthabenprotokolle. Diese kannst Du beliebig benennen; der Name wird im nächsten Pipedream-Dropdown angezeigt.
Wählen in der Dropdown-Liste die Tabelle aus, die Du gerade erstellt hast, und anschließend im Feld Worksheet ID den Namen des Blatts der Tabelle.
Je nachdem, ob Deine Tabelle eine Kopfzeile mit Feldnamen enthält, solltest Du im nächsten Feld TRUE oder FALSE auswählen, um fortzufahren.
Im Feld Values (Werte) musst Du aus den Daten des Testereignisses jedes Feld auswählen, das in die neuen Spalten geschrieben werden soll. Eine empfohlene Einrichtung sieht so aus:
Dadurch erhältst Du eine saubere Tabelle mit Werten, wie „Erstellt am“ (Created On), „Ereignis Typ (Neuer Benutzer, Guthabenänderung usw.)“ (Event Type (New User, Credit Change etc.)), „Benutzer-E-Mail“ (User Email) und den „Guthaben Werten“ (Credit Value).
Klicke auf den blauen Button Test und bestätige, dass die Zeile in Deiner Tabelle erstellt wurde. Von da an musst Du nur noch auf Deploy klicken, und Deine Pipeline ist einsatzbereit!
Teste, ob alles funktioniert!
Jetzt, da alles eingerichtet ist, erstellst Du am besten ein neues Test-Benutzer-Konto in SuperSaaS unter Benutzer-Management, gibst diesem Test-Benutzer eine bestimmte Guthaben-Höhe, legst Termine im Namen von diesem Benutzer an und prüfst Deine Tabelle, um sicherzustellen, dass alles funktioniert. Nach jeder Nutzeraktion sollte es weniger als 5 Sekunden dauern, bis Deine Tabelle aktualisiert wird.
Verwende die normalen Google-Sheets-Filter, um die Guthabenhistorie für einen einzelnen Benutzer innerhalb der Datums-/Zeitbereiche zu prüfen, die Dich interessieren.
Mehr geht immer
Wenn Du Dich für diese Art von Automatisierung und Dienstintegration begeisterst, willst Du vielleicht auch etwas anderes bauen, das zu Deinen speziellen Anforderungen passt?
Wirf dafür einen Blick auf die anderen verfügbaren Ereignisse und Trigger (event sources/triggers) von SuperSaaS für Pipedream:
Die Trigger-Konfiguration wird der von Credit balance changes immer sehr ähnlich sein, also hoffen wir, dass Du Lust bekommst, auch mit den anderen Optionen zu experimentieren.
Andere Integrationen für weiteren Output erfordern möglicherweise nicht viel technisches Wissen, etwa wenn Du Dir selbst E-Mails schickst, sobald Termine erstellt oder aktualisiert werden, und zwar kostenlos.
Stattdessen die benutzerdefinierten SuperSaaS-Webhooks verwenden
Wenn Du SuperSaaS-Trigger für Pipedream verwendest, richtest Du im Hintergrund eigentlich SuperSaaS-Webhooks mit den eingebauten HTTP-/Webhook-Triggern von Pipedream ein.
Wenn Du die Premium-Funktion für benutzerdefinierte SuperSaaS-Webhooks einsetzt, kannst Du das auch manuell einrichten und jeden beliebigen SuperSaaS-Webhook-Trigger an Deine Pipedream-Workflows weiterleiten, auch solche, die wir noch nicht in Pipedream integriert haben, wie die Ereignisse Geänderte Daten im Formularm und Sende E-Mail.
Nehmen wir beispielsweise an, Du möchtest einen Workflow einrichten, der jedes Mal ausgelöst wird, wenn einer Deiner Benutzer ein Formular aktualisiert: Klicke dafür in Deinem Pipedream-Konto erneut auf New Workflow und wähle den eingebauten Trigger HTTP/Webhook aus.
Die Standard-Einstellungen für den endpoint (Endpunkt) sind für SuperSaaS-Webhooks in Ordnung. Klicke auf Save and continue (speichern und weiter).
Klicke auf Save and continue, und kopiere den generierten endpoint (Endpunkt) (z. B. https://example.m.pipedream.net) auf die SuperSaaS-Seite für benutzerdefinierte Webhooks. Wähle den Trigger aus, der Dich interessiert, wie z. B. Geänderte Daten im Formular, fülle die Parameter aus, falls vorhanden (z. B. in diesem Fall welches Formular verfolgt werden soll), und verwende Deinen Pipedream-HTTP-endpoint als Ziel URL.
Alle anderen vorhandenen Webhooks im Screenshot wurden automatisch erstellt und werden durch den SuperSaaS-Trigger Credit balance changes verwaltet, den wir zu Beginn dieser Anleitung eingerichtet haben.
Du könntest auch mehrere benutzerdefinierte Webhooks für dieselbe Ziel URL erstellen, wenn das für Deinen Anwendungsfall sinnvoll ist. Beispielsweise benötigen Ereignisse für Credit balance changes beispielsweise folgende Webhooks je Terminbuchungskalender:
- Neue Nutzerdaten, wenn Du neue Benutzer bereits mit Guthaben anlegst
- Geänderte Nutzerdaten, wenn Du oder Superbenutzer dem Benutzer Guthaben hinzufügen oder entfernen
- Kauf von Guthaben, wenn Deine Benutzer (oder Du bzw. Superbenutzer in deren Namen) Guthaben kaufen
- Neue Buchung, wenn bei der Buchung von Benutzern, Dir oder Superbenutzern Guthaben genutzt wird
- Geänderte Buchung, wenn bei der Stornierung/Absage von Buchungen Guthaben zurückgegeben wird
Und alle verweisen auf denselben Workflow-Endpunkt (workflow-endpoint).
Sobald Du Deinen benutzerdefinierten Webhook erstellt hast, kannst Du auf den Link Test webhook und dann auf Post payload now klicken, um ein Testereignis an Deinen Workflow zu senden. Du kannst dieses Testereignis als Referenz verwenden, um den Rest Deines Workflows einzurichten, und es außerdem bequem über die Pipedream-Oberfläche erneut abspielen, um Deinem gesamten Workflow schnell einen Probelauf zu geben.
Sobald das Payload gesendet wurde, solltest Du es bald in Deinem Pipedream-Workflow sehen.
Damit kannst Du beliebige Pipedream-Aktionen hinzufügen, die ausgeführt werden, wenn Dein SuperSaaS-Konto mit dem Webhook Geänderte Daten im Formular Ereignisse für das Formular auslöst, dessen Aktivitäten Du verfolgen willst.
Wenn Du Fragen zu SuperSaaS hast, hilft Dir unser Support-Team gerne weiter.
Dies ist eine überarbeitete Version eines Artikels, der am 2. November 2020 veröffentlicht wurde