Webhooks in flows begrijpen

Wat je leert

Lees meer over webhooks in flows en hoe ze informatie van Klaviyo naar je tools en applicaties van derden sturen. Het is belangrijk om te weten dat het instellen van webhooks complex kan zijn. Het is aan te raden om ontwikkelkennis of ontwikkelresources te hebben om deze instelling correct te voltooien. Als je op zoek bent naar deze ontwikkelrichtingen, lees dan hoe je een webhook-actie toevoegt aan een flow.

Wat zijn webhooks?

Simpel gezegd bieden webhooks een uitgebreide manier om al je marketing- en datatools met elkaar te laten communiceren. Laten we als voorbeeld eens bedenken hoe online bankieren en fraudebescherming op je creditcard werken. Als iemand je kaart frauduleus gebruikt, wordt die transactie bij de retailer geregistreerd en vervolgens naar je bank gestuurd. Je bank analyseert deze en waarschuwt je via telefoon of e-mail wanneer er een probleem is met je kaart. Deze aankoop zorgde ervoor dat een reeks systemen met elkaar communiceerden, deze gegevens verplaatsten en je uiteindelijk waarschuwden. Deze systemen gebruiken waarschijnlijk webhooks om deze gegevens door te geven. webhook:

• Sta je applicatie toe om informatie door te geven of andere applicaties, tools en servers te "aanroepen" via een HTTP-verzoek.
• Verstuur informatie over een gebeurtenis die heeft plaatsgevonden (bijv. een geplaatste bestelling, een nieuwe klant die zich heeft aangemeld, enz.).
• Kan je systeem laten weten dat er een gebeurtenis heeft plaatsgevonden of je op de hoogte stellen van die gebeurtenis.

Deze gebeurtenisinformatie wordt vervolgens geleverd op de manier en op de plek van jouw keuze. Met andere woorden: webhooks bieden waardevolle manieren om data en informatie vanuit Klaviyo te delen met je andere marketingtools en -systemen, op de manier die jij passend vindt.

Belangrijke onderdelen van webhooks

Webhooks bestaan uit een paar onderdelen:

• Trigger
  De gebeurtenis waardoor een webhook wordt geactiveerd
• Bericht (of ‘de payload’)
  Wat de webhook verzendt, zoals belangrijke details over de triggergebeurtenis, de URL waar het bericht naartoe wordt gestuurd of de URL van het systeem dat het bericht ontvangt
• Kopteksten
  Een plek om aanvullende informatie door te geven (zoals verificatie)

Webhooks in flow

Webhooks zijn momenteel alleen beschikbaar binnen flows en worden verzonden wanneer een flow een bepaalde fase of stap bereikt. De webhook stuurt vervolgens een POST-verzoek met gegevens over de gebeurtenis of ontvanger die de flow heeft geactiveerd.

Belangrijk om te weten: slechts één event kan ervoor zorgen dat de webhook wordt verstuurd. Wanneer een abonnee voldoet aan de triggercriteria, wordt de webhook geactiveerd en wordt het bericht naar de opgegeven URL verzonden. Daarnaast kun je webhooks alleen verzenden op basis van door een flow getriggerde events, oftewel events die als flowtrigger kunnen worden gebruikt. Je kunt bijvoorbeeld geen webhook verzenden op basis van een wijziging van profieleigenschappen, omdat een flow niet rechtstreeks kan worden getriggerd door profielwijzigingen.
Voorbeelden van events in Klaviyo zijn onder meer:

• Bestelling geplaatst
• Is begonnen met afrekenen
• Aangemeld voor lijst

Use cases voor webhooks

Het is belangrijk om de flowtriggers te begrijpen die webhooks kunnen genereren, evenals enkele praktische use cases voor hoe je deze implementeert met je andere applicaties.

Voorbeelden zijn:

• Een bericht sturen om afgehaakte klanten opnieuw te activeren.
• Een bericht sturen op de verjaardag van je klanten en ze een cadeau geven in de vorm van loyaliteitspunten.
• De webhook verzenden zodra een nieuwe abonnee zich aanmeldt voor je lijsten. Je kunt hun profielgegevens naar een ander platform sturen.
• Een klant een NPS-enquête sturen om meer te weten te komen over je abonnees.
• Een bericht of POST-verzoek verzenden dat wordt geactiveerd op basis van het feit dat een abonnee wordt toegevoegd aan een segment of lijst. Let er wel op dat we de gebeurtenis “Received Email"” niet ondersteunen als flow-trigger.

Praktijkvoorbeeld

Je besluit Klaviyo te koppelen aan je direct-mailingtool zodat je online en per post met klanten kunt communiceren. Je nieuwe klant Shah ging naar je website en kocht een paar items in je webshop. Je wilt Shah in de toekomst een gedrukte catalogus van je volledige collectie sturen.

Hier kan de webhook deze ervaringen aan elkaar koppelen. Je zou je e-commerce-webshop al hebben geïntegreerd met Klaviyo. In Klaviyo stel je een flow in die wordt geactiveerd op basis van de gebeurtenis Placed Order. Je geeft ons vervolgens de webhook van de direct mail-tool en neemt in het bericht gegevens op, zoals de naam en het adres van de klant en wat diegene heeft besteld (d.w.z. de payload).

Nu, elke keer dat iemand (zoals Shah) een bestelling plaatst, kan een event een printcatalogus starten die naar zijn adres wordt gestuurd. De webhook-aankoopgebeurtenis zorgt ervoor dat informatie mogelijk vrijwel in realtime rechtstreeks vanuit Klaviyo naar je direct mailing-tool wordt verzonden (d.w.z. het bericht of de payload).

Wat kunnen Klaviyo-webhooks niet doen?

Webhooks zijn niet bedoeld voor een bidirectionele synchronisatie van data. Dit betekent dat je, hoewel je andere platforms kunt verbinden met Klaviyo om data van ons naar hen te sturen, geen data terug naar Klaviyo kunt sturen. Informatie stroomt van Klaviyo naar de aangewezen systemen of applicaties die je hebt verbonden, maar kan niet de andere kant op stromen. Webhooks werken, in tegenstelling tot API's, alleen op deze eenrichtingsmanier.

Het is ook belangrijk om rekening te houden met de gebeurtenissen die je kiest om je informatie te activeren, hoe vaak dit gebeurt en waar die gegevens uiteindelijk in je systeem terechtkomen. Klaviyo biedt het framework om je flowgegevens met een platform te verbinden, maar de uiteindelijke waarde hangt af van waar die informatie na het verlaten van Klaviyo naartoe gaat en wat het mogelijk in gang zet. Daarom kan Klaviyo alleen monitoren of de webhook werkt, en niet waar de gegevens naartoe gaan of wat ermee gebeurt nadat ze ons systeem hebben verlaten.

Tot slot is het belangrijk om rekening te houden met de gegevens die Klaviyo wel en niet via een webhook kan verzenden. Klaviyo kan bepaalde datapunten niet via een webhook verzenden op basis van de manier waarop onze flowtriggers werken. We kunnen bijvoorbeeld geen betrokkenheidsgegevens voor het openen van e-mails verzenden voor elke keer dat een abonnee een e-mail opent, omdat je geen flow kunt activeren op basis van opens.

Op dezelfde manier kun je eventgebaseerde dynamische variabelen gebruiken in je webhook-payload in een eventgetriggerde flow, maar de beschikbare variabelen zijn gekoppeld aan de oorspronkelijke event die de flow heeft getriggerd (dus net als bij flow-e-mails). Als je bijvoorbeeld een flow voor winkelwagen verlaten hebt die wordt getriggerd door de event Started Checkout, kun je dynamische variabelen van die event gebruiken in de payload van de webhook. Maar als je in dezelfde flow ook een flowfilter of splitsing gebruikt met een meetwaarde Added to Cart, kun je deze extra data niet opnemen in de webhook-payload.

Wanneer je je webhooks instelt, is het daarom belangrijk om te overwegen welke flow data points kunnen ondersteunen en wat je wilt bereiken met je webhook-configuratie.

Momenteel worden couponcodes, webfeeds en productfeeds niet ondersteund in flow-webhooks.

Wie moet webhooks instellen?

Zoals hierboven vermeld, zijn de systemen die je koppelt aan Klaviyo, de manier waarop de informatie of data wordt verpakt en welke data of info je kiest om op te halen, volledig aan jou.

Met dit in gedachten raden we sterk aan om een ontwikkelresource te gebruiken om webhooks in te stellen, zodat de juiste gebeurtenissen vanuit Klaviyo worden verzonden en correct in je applicatie worden gepost. Klaviyo geeft je ook fouten door als een webhook mislukt. We kunnen echter mogelijk geen diepere problemen diagnosticeren met de webhook-instelling of hoe de gegevens uiteindelijk naar je applicatie worden gepost.

Vereisten en overwegingen

Naast dat je zorgt dat je een developer resource hebt om je webhook goed in te stellen en te testen op je bijbehorende systeem, heeft Klaviyo een aantal belangrijke vereisten voor het gebruik van deze functionaliteit:

• Alleen gebruikersrollen die toegang hebben om flows te maken kunnen webhooks instellen in Klaviyo. Dit omvat de rollen manager, Beheerder en eigenaar.
• Voor extra beveiliging moet tweestapsauthenticatie ingeschakeld zijn in je account om webhooks te gebruiken of nieuwe webhook-acties toe te voegen binnen een bestaande flow.

Klaar om te beginnen?

Webhooks bieden krachtige mechanismen om data van Klaviyo naar je andere externe systemen of applicaties te communiceren. Als je klaar bent om je webhooks in te stellen, kun je onze handleiding in de documentatie voor developers lezen over Hoe je een webhook-actie aan een flow toevoegt.