Webhooks in Flows verstehen

Übersicht

Erfahre mehr über Webhooks in Flows und darüber, wie sie Informationen von Klaviyo an deine Drittanbieter-Tools und -Anwendungen senden. Wichtig ist, dass das Einrichten von Webhooks komplex sein kann. Es ist ratsam, über Entwicklungskenntnisse oder Entwicklungsressourcen zu verfügen, um dieses Setup korrekt abzuschließen. Wenn du nach diesen Entwicklungsanleitungen suchst, erfahre wie du eine Webhook-Aktion zu einem Flow hinzufügst.

Was sind Webhooks?

Einfach gesagt schaffen Webhooks eine umfassende Möglichkeit, damit all deine Marketing- und Datentools miteinander kommunizieren können. Als Beispiel stellen wir uns vor, wie Online-Banking und Betrugsschutz bei deiner Kreditkarte funktionieren. Wenn jemand deine Karte betrügerisch nutzt, wird diese Transaktion beim Händler protokolliert und dann an deine Bank gesendet, die sie analysiert und dich per Telefon oder E-Mail benachrichtigt, wenn es ein Problem mit deiner Karte gibt. Dieser Kauf hat eine Reihe von Systemen dazu veranlasst, miteinander zu kommunizieren, diese Daten zu verschieben und dich letztendlich zu benachrichtigen. Diese Systeme nutzen höchstwahrscheinlich Webhooks, um diese Daten weiterzugeben. Webhook:

• Ermögliche es deiner Anwendung, Informationen per HTTP-Anfrage zu übergeben oder andere Anwendungen, Tools und Server „aufzurufen“.
• Sende Informationen über ein Ereignis, das eingetreten ist (z. B. eine aufgegebene Bestellung, eine*n neue*n Kund*in, die*der abonniert hat, usw.).
• Kann deinem System mitteilen, dass ein Ereignis stattgefunden hat, oder dich über dieses Ereignis benachrichtigen.

Diese Ereignisinformationen werden dann auf die von dir gewählte Art und an den von dir gewählten Ort übermittelt. Mit anderen Worten: Webhooks bieten wertvolle Möglichkeiten, Daten und Informationen aus Klaviyo heraus auf die von dir gewünschte Weise mit deinen anderen Marketing-Tools zu teilen.

Hauptkomponenten von Webhooks

Webhook bestehen aus ein paar Bestandteilen:

• Trigger
  Das Ereignis, durch das ein Webhook ausgelöst wird
• Nachricht (oder „Payload“)
  Was der Webhook sendet, z. B. wichtige Details zum auslösenden Ereignis, die URL, an die die Nachricht gesendet wird, oder die URL des Systems, das die Nachricht empfängt
• Header
  Ein Ort, um zusätzliche Informationen (z. B. Authentifizierung) zu übergeben

Webhooks in Flows

Webhook sind derzeit nur innerhalb von Flow verfügbar und werden gesendet, wenn ein Flow eine bestimmte Phase oder einen bestimmten Schritt erreicht. Der Webhook sendet dann eine POST-Anfrage mit Daten zum Ereignis oder zu den Empfänger*innen, das bzw. die den Flow ausgelöst hat.

Wichtig ist, dass nur ein Ereignis das Senden des Webhooks initiieren kann. Wenn ein*e Abonnent*in die Auslösekriterien erfüllt, wird der Webhook ausgelöst und die Nachricht an die festgelegte URL gesendet. Außerdem kannst du Webhooks nur auf Flow-ausgelösten Ereignissen senden, d. h. auf Ereignissen, die als Flow-Auslöser verwendet werden können. Du kannst zum Beispiel keinen Webhook senden, der durch eine Änderung von Profileigenschaften ausgelöst wird, da ein Flow nicht direkt durch Profiländerungen ausgelöst werden kann.
Beispiele für Ereignisse in Klaviyo sind:

• Bestellung aufgegeben
• Bezahlvorgang gestartet
• Liste abonniert

Webhook-Anwendungsfälle

Es ist wichtig, die Flow-Auslöser zu verstehen, die Webhook generieren können, sowie einige praktische Anwendungsfälle, wie du diese mit deinen anderen Anwendungen implementieren kannst.

Hier einige Beispiele:

• Eine Nachricht senden, um inaktive Kund*innen erneut zu aktivieren.
• Eine Nachricht am Geburtstag deiner Kund*innen senden und ihnen ein Geschenk in Form von Treuepunkten geben.
• Den Webhook jedes Mal senden, wenn ein*e neue*r Abonnent*in deine Listen abonniert. Du kannst ihre Profildaten an eine andere Plattform senden.
• Sende Kund*innen eine NPS-Umfrage, um mehr über deine Abonnent*innen zu erfahren.
• Senden einer Nachricht oder eines POST-Requests, der ausgelöst wird, wenn ein*e Abonnent*in zu einem Segment oder einer Liste hinzugefügt wird. Beachte jedoch, dass wir das Event „Received Email“ nicht als Flow-Trigger unterstützen.

Praxisbeispiel

Du entscheidest dich, Klaviyo mit deinem Tool für Direktmailings zu verbinden, damit du mit Kund*innen online und per Post kommunizieren kannst. Dein*e neue*r Kund*in Shah hat deine Website besucht und ein paar Artikel in deinem E-Commerce-Shop gekauft. Du möchtest Shah in Zukunft einen gedruckten Katalog deiner gesamten Kollektion zusenden.

Hier kann der Webhook diese Erlebnisse miteinander verknüpfen. Du hättest deinen E-Commerce-Shop bereits in Klaviyo integriert. In Klaviyo richtest du einen Flow ein, der basierend auf dem Ereignis Placed Order ausgelöst wird. Anschließend stellst du uns den Webhook des Direktwerbung-Tools bereit und fügst Details wie den Namen und die Adresse der Kund*innen sowie das, was sie bestellt haben, in die Nachricht ein (d. h. die Payload).

Jetzt könnte jedes Mal, wenn jemand (wie Shah) eine Bestellung aufgibt, ein Ereignis den Versand eines gedruckten Katalogs an die Adresse dieser Person veranlassen. Das Webhook-Kaufereignis veranlasst, dass Informationen potenziell in Echtzeit direkt aus Klaviyo an dein Direktwerbung-Tool gesendet werden (d. h. die Nachricht oder Payload).

Was können Klaviyo-Webhook nicht tun?

Webhooks sind nicht für die bidirektionale Synchronisierung von Daten gedacht. Das bedeutet, dass du zwar andere Plattformen mit Klaviyo verbinden kannst, um Daten von uns an sie zu senden, aber du kannst keine Daten an Klaviyo zurückgeben. Die Informationen fließen von Klaviyo in die entsprechenden Systeme oder Anwendungen, mit denen du dich verbunden hast, aber nicht in die andere Richtung. Webhook funktioniert im Gegensatz zu APInur in eine Richtung.

Es ist auch wichtig zu bedenken, welche Ereignisse du auswählst, um deine Informationen abzurufen, wie oft dies geschieht und wo diese Daten letztendlich in deinem System landen. Klaviyo bietet den Rahmen, um deine Flow-Daten mit einer Plattform zu verbinden, aber der letztendliche Wert hängt davon ab, wohin die Informationen nach dem Verlassen von Klaviyo gehen und was sie potenziell bewirken können. Deshalb kann Klaviyo nur überwachen, ob der Webhook funktioniert und nicht, wohin die Daten gehen oder was sie tun, nachdem sie unser System verlassen haben.

Schließlich ist es wichtig, die Daten zu berücksichtigen, die Klaviyo über einen Webhook senden kann und nicht senden kann. Aufgrund der Funktionsweise unserer Flow-Auslöser kann Klaviyo bestimmte Datenpunkte nicht über einen Webhook senden. Wir können z.B. nicht jedes Mal, wenn ein Abonnent eine E-Mail öffnet, E-Mail-Öffnungsdaten an die Kundenengagement senden, da du keinen Flow auf der Basis von Öffnungen auslösen kannst.

Auch wenn du in einem ereignisgesteuerten Flow ereignisbasierte dynamische Variablen in deiner Webhook-Nutzlast verwenden kannst, sind die verfügbaren Variablen mit dem ursprünglichen Ereignis verbunden, das den Flow ausgelöst hat (d.h. genau wie bei Flow-E-Mails). Wenn du zum Beispiel einen Warenkorbabbruch Flow hast, der durch das Ereignis Started Checkout ausgelöst wird, kannst du dynamische Variablen aus diesem Ereignis in der Webhook-Nutzlast verwenden. Wenn du aber im selben Flow auch einen Flow-Filter oder einen Split mit einer Added to Cart -Metrik verwendest, kannst du diese zusätzlichen Daten nicht in die Webhook-Nutzlast aufnehmen.

Wenn du deinen Webhook einrichtest, ist es also wichtig zu überlegen, welche Datenpunkte Flow unterstützen kann und was du mit deinem Webhook-Setup erreichen willst.

Derzeit werden Gutscheincodes, Web-Feeds und Produkt-Feeds in Flow-Webhooks nicht unterstützt.

Wer sollte Webhooks einrichten?

Wie oben erwähnt, liegt es völlig in deinem Ermessen, welche Systeme du mit Klaviyo verbindest, wie die Informationen oder Daten verpackt sind und welche Daten oder Infos du abrufen möchtest.

Vor diesem Hintergrund empfehlen wir dringend, eine Entwicklungsressource hinzuzuziehen, um Webhooks einzurichten und sicherzustellen, dass die richtigen Events von Klaviyo gesendet werden und korrekt in deiner Anwendung gepostet werden. Klaviyo stellt dir außerdem Fehler bereit, falls ein Webhook fehlschlägt. Wir können jedoch möglicherweise keine tiefergehenden Probleme mit der Webhook-Einrichtung oder damit diagnostizieren, wie die Daten letztlich in deiner Anwendung gepostet werden.

Anforderungen und zu bedenkende Aspekte

Zusätzlich dazu, dass du sicherstellst, dass dir eine Entwicklerressource zur Verfügung steht, um deinen Webhook ordnungsgemäß einzurichten und ihn in deinem begleitenden System zu testen, hat Klaviyo einige wichtige Anforderungen für die Nutzung dieser Funktionalität:

• Nur Benutzerrollen, die Zugriff zum Erstellen von Flows haben, können Webhooks in Klaviyo einrichten. Dazu gehören die Rollen Manager, Administrator und Kontoinhaber.
• Für zusätzliche Sicherheit muss die Zwei-Faktor-Authentifizierung in deinem Konto aktiviert sein, um Webhooks zu verwenden oder neue Webhook-Aktionen in einem bestehenden Flow hinzuzufügen.

Bereit zum Einrichten?

Webhooks bieten leistungsstarke Mechanismen, um Daten von Klaviyo an deine externen Systeme oder Anwendungen zu übermitteln. Wenn du bereit bist, deine Webhooks einzurichten, kannst du in unserem Leitfaden in der Entwicklerdokumentation nachlesen, wie du eine Webhook-Aktion zu einem Flow hinzufügst.

Weitere Ressourcen