Hallo zusammen!
Willkommen zu diesem Tutorial darüber, wie Sie einen Automatisierungs-Workflow mit Integromat einrichten, der es Ihnen ermöglicht, automatisch eine E-Mail-Benachrichtigung zu erhalten, sobald sich ein neuer Benutzer in Ihrer Discourse-Community anmeldet.
Um Discourse mit Integromat zu verbinden, benötigen Sie ein Integromat-Konto. Falls Sie noch keines haben, können Sie sich hier anmelden.
Diese Methode nutzt die Webhook-Funktion von Discourse. Daher benötigen Sie vor Beginn Admin-Zugriff auf Ihre Discourse-Community.
Sobald Sie Admin-Zugriff haben, besteht der erste Schritt darin, eine neue Webhook-Anfrage zu erstellen. Klicken Sie dazu auf das Profil-Symbol oben rechts und wählen Sie im Profil-Tab die Option „Zusammenfassung“ aus.
Dies bringt Sie auf Ihre Profilseite. Klicken Sie auf die Schaltfläche „Admin“, um zur Admin-Seite zu gelangen.
Klicken Sie auf die Option „API“.
Wählen Sie den Reiter „Webhooks“ und klicken Sie auf die Schaltfläche „Neuer Webhook“, um eine neue Webhook-Anfrage zu generieren.
Die Konfigurationsseite sollte wie folgt aussehen.
Um dieses Formular auszufüllen, müssen Sie einen neuen Integromat-Webhook generieren, der die Daten empfangen soll, die Discourse jedes Mal sendet, wenn sich ein neuer Benutzer in Ihrer Community anmeldet.
Loggen Sie sich dazu in Ihr Integromat-Konto ein und erstellen Sie ein neues Szenario.
Zunächst müssen Sie ein Trigger-Modul einrichten – also das Modul, das die Ausführung Ihres Szenarios auslöst. In diesem Fall handelt es sich um ein Webhook-Modul. Klicken Sie daher auf das Fragezeichen-Symbol und suchen Sie nach der App „Webhooks“.
Klicken Sie auf die Webhooks-App und wählen Sie das Modul „Benutzerdefinierter Webhook“ aus.
Erstellen Sie nun einen neuen Webhook, damit Ihr Szenario die von Discourse gesendeten Daten empfangen kann. Klicken Sie dazu auf die Webhooks-App, um das Konfigurationsfenster zu öffnen, und dann auf die Schaltfläche „Hinzufügen“, um einen neuen Webhook einzurichten.
Verleihen Sie Ihrem Webhook einen Namen. Dies kann beliebig sein, zum Beispiel „Discourse Webhook“.
Als Nächstes klicken Sie auf die Option „Erweiterte Einstellungen anzeigen“ und wählen „Anfrage-Header abrufen“. Klicken Sie danach auf „Speichern“, um Ihren neuen Webhook zu generieren.
Ihr Webhook sollte nun sichtbar sein. Es ist die in Blau hervorgehobene URL. Klicken Sie auf die Schaltfläche „Adresse in die Zwischenablage kopieren“, um Ihren Webhook zu kopieren, und wechseln Sie zur Seite für die Webhook-Einrichtung in Discourse.
Fügen Sie Ihre Integromat-Webhook-URL im Feld „Payload-URL“ ein.
Wählen Sie nun aus der Liste die Option „Benutzer-Ereignis“ und stellen Sie sicher, dass alles andere deaktiviert ist. Dadurch wird sichergestellt, dass dieser Webhook nur Daten basierend auf benutzerspezifischen Ereignissen empfängt.
Schließlich aktivieren Sie am Ende der Seite die Kontrollkästchen „TLS-Zertifikat der Payload-URL prüfen“ und „Aktiv“ und klicken auf die Schaltfläche „Erstellen“, um diese Verbindung zwischen Ihrer Discourse-Community und Ihrem Integromat-Webhook herzustellen.
Die neue Verbindung sollte nun auf der Webhook-Seite Ihres Discourse-Kontos sichtbar sein.
Der nächste Schritt besteht darin, sicherzustellen, dass die Verbindung zwischen der Discourse-Community und Ihrem Integromat-Webhook hergestellt wurde. Klicken Sie dazu auf „Inaktiv“.
Es erscheint ein kleines Menü, das wie folgt aussieht. Klicken Sie einfach auf „Ping“ und wechseln Sie zu Ihrem Integromat-Szenario, um zu prüfen, ob Ihr Webhook dieses Ereignis erfolgreich erkannt hat.
Wenn ja, sehen Sie eine Meldung mit dem Text „Erfolgreich festgestellt“.
Als Nächstes prüfen Sie, ob der Webhook tatsächlich Daten von Ihrer Discourse-Community empfangen kann. Dazu müssen Sie das Szenario einmal ausführen, indem Sie auf die Schaltfläche „Einmal ausführen“ klicken.
Sobald das Webhook-Modul zu rotieren beginnt, wechseln Sie zu Ihrer Discourse-Community, melden sich ab und erstellen einen neuen Benutzeraccount. Sobald der neue Benutzer erfolgreich erstellt wurde, sollte der Webhook Daten empfangen, was wie folgt aussieht.
Dies hilft Ihnen sicherzustellen, dass der Webhook echte Ereignisse (nicht nur Pings) erkennt, und ermöglicht es Ihnen, die empfangenen Datenelemente später in diesem Tutorial der E-Mail-App zuzuordnen. Wenn Ihr Integromat-Webhook das Ereignis erfolgreich erkannt hat, wurde das Szenario erfolgreich ausgeführt, und es sollte wie folgt aussehen.
Da Sie nun wissen, dass das Webhook-Modul wie erwartet funktioniert und Ihr Integromat-Szenario jedes Mal ausgelöst wird, wenn ein neuer Benutzer erstellt wird, ist es an der Zeit, das Szenario zu erweitern und so zu konfigurieren, dass es Ihnen automatisch eine E-Mail mit allen Benutzerinformationen sendet.
Der erste Schritt besteht darin, ein Iterator-Modul an das Webhook-Trigger-Modul anzuhängen. Sie finden dies im Menü „Tools“ des Szenario-Editors. Die Verwendung dieses Moduls erklären wir später.
Klicken Sie auf das Iterator-Modul, um das Konfigurationsfenster zu öffnen.
Sobald Sie auf das Feld „Array“ klicken, öffnet sich links ein Menü mit einigen Datenelementen, die vom Webhook-Modul abgerufen wurden. Ziehen Sie einfach das Datenelement „Headers“ per Drag & Drop in das Array-Feld des Iterator-Moduls. Dies wird ein Array mit vielen Werten sein.
Als Nächstes fügen Sie die E-Mail-App nach der Iterator-App hinzu. Klicken Sie auf das Plus-Symbol und suchen Sie nach der E-Mail-App. Sobald Sie sie gefunden haben, klicken Sie darauf, um das gewünschte Modul auszuwählen.
Wählen Sie aus der Liste das Modul „E-Mail senden“ aus, um Ihnen jedes Mal eine E-Mail zu senden, wenn ein neuer Benutzer in Ihrer Discourse-Community erstellt wird.
Bevor Sie das E-Mail-Modul konfigurieren, müssen Sie einen Filter zwischen der Iterator- und der E-Mail-App einrichten, der sicherstellt, dass Sie nur E-Mails für Benutzer erhalten, die sich in Ihrer Community anmelden. Dies ist erforderlich, da Discourse standardmäßig Webhook-Anfragen für alle Arten von Benutzeraktivitäten auslöst.
Im Konfigurationsfenster des Filters müssen Sie zunächst eine Beschriftung eingeben. Dies kann beliebig sein, zum Beispiel „Neuer Benutzer“.
Dann müssen Sie eine Bedingung erstellen, die diesen Filter auslöst. Im ersten Feld der Bedingung mappen Sie einfach das Datenelement „Value“ aus dem Iterator-Modul. Wählen Sie als logischen Operator „Gleich“. Geben Sie schließlich im unteren Feld den Wert „user_created“ ein.
Die Funktionsweise dieser Bedingung ist wie folgt:
Die Webhook-Daten, die Integromat von Discourse jedes Mal erhält, wenn ein Benutzer eine Aktion ausführt, enthalten ein „Headers“-Array (ein Array ist eine Sammlung von Werten). Die Aufgabe des Iterators besteht darin, jeden dieser Werte einzeln abzurufen, damit sie verarbeitet und auf den Filter angewendet werden können. Irgendwo in diesem Array von Werten befindet sich ein Wert, der die Art des vom Benutzer durchgeführten Ereignisses angibt. Da das Ereignis, das uns interessiert, „user_created“ heißt (weil dies darauf hinweist, dass die vom Benutzer ausgeführte Aktion die Erstellung eines neuen Kontos war), müssen wir einen Filter einrichten, um sicherzustellen, dass die Header-Werte der Webhook-Daten tatsächlich diesen Wert enthalten. Wenn ja, fahren wir mit der Ausführung der nachfolgenden Szenario-Module fort. Wenn nicht, endet die Szenario-Ausführung kurz darauf, und es wird keine E-Mail gesendet.
Sobald Ihr Filter konfiguriert ist, können Sie auf das E-Mail-Modul klicken, um das Konfigurationsfenster zu öffnen.
Das erste, was Sie tun müssen, ist, das E-Mail-Konto zu verbinden, mit dem Sie E-Mails senden möchten. Wenn Sie Ihr Gmail-Konto verbinden, stellen Sie bitte sicher, dass Sie diesem Leitfaden folgen, der den Prozess Schritt für Schritt erklärt.
Sobald Ihre E-Mail verbunden ist, können Sie fortfahren und die anderen Optionen des E-Mail-Moduls einrichten.
Für das Feld „An“ können Sie auf „Empfänger hinzufügen“ klicken und die E-Mail-Adresse eingeben, an der Sie diese Updates erhalten möchten.
Für das Betrefffeld können Sie einen beliebigen Text eingeben, und für den Inhaltstyp können Sie die Option „Klartext“ auswählen, um die Nachricht zu erstellen, die Sie jedes Mal senden möchten, wenn dieses Modul ausgeführt wird.
Das Inhaltsfeld ist der Ort, an dem Sie die E-Mail-Nachricht erstellen können. Hier können Sie statischen Text eingeben (also Text, der bei jeder Ausführung gleich bleibt), aber Sie können auch dynamische Datenelemente aus dem Webhook-Modul mappen. Der Webhook enthält viele Daten über den Benutzer, die Sie verwenden können, einschließlich Benutzername, Name, E-Mail usw.
Und schon haben Sie es geschafft! Sie haben erfolgreich ein Integromat-Szenario erstellt, das Sie benachrichtigt, sobald sich ein neuer Benutzer in Ihrer Discourse-Community anmeldet.
Wir hoffen, dieses Tutorial war hilfreich! Wenn Sie Fragen haben oder Empfehlungen dafür, was Sie als Nächstes sehen möchten, zögern Sie bitte nicht, uns in den Kommentaren Bescheid zu geben, ein Ticket bei Integromats Support-Team einzureichen oder die Facebook-Community von Integromat mit 10.000 Mitgliedern zu besuchen.
Viel Spaß beim Automatisieren!
LINKS
So verbinden Sie Discourse mit Hunderten von Apps mithilfe von Integromat