Webhook in flow begrijpen

Wat je leert

Leer meer over webhooks in flow 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 ontwikkelingskennis of ontwikkelingsbronnen te hebben om deze instelling correct uit te voeren. Als je op zoek bent naar deze ontwikkelaanwijzingen, leer dan hoe je een webhook actie toevoegt aan een flow.

Wat zijn webhooks?

Eenvoudig gezegd creëren webhooks een uitgebreide manier voor al je marketing- en gegevenstools om met elkaar te praten. Laten we als voorbeeld eens bedenken hoe online bankieren en fraudebescherming op je creditcard werken. Als iemand frauduleus gebruik maakt van je kaart, wordt de transactie bij de winkelier geregistreerd en vervolgens naar je bank gestuurd, die de transactie analyseert en je via de telefoon of e-mail waarschuwt als er een probleem is met je kaart. Deze aankoop zette een reeks systemen in werking om met elkaar te communiceren, deze gegevens te verplaatsen en jou uiteindelijk te waarschuwen. Deze systemen gebruiken waarschijnlijk webhooks om deze gegevens door te geven. webhook:

• Laat je applicatie informatie doorgeven of andere applicaties, tools en servers "aanroepen" via HTTP-verzoeken.
• Stuur informatie over een gebeurtenis die heeft plaatsgevonden (bijvoorbeeld een geplaatste bestelling, een nieuwe klant aanmelden, etc.).
• Kan je systeem vertellen dat er een gebeurtenis heeft plaatsgevonden of je daarvan op de hoogte stellen.

Deze evenementinformatie wordt dan op de door jou gekozen manier en plaats afgeleverd. Met andere woorden, webhooks bieden waardevolle manieren om gegevens en informatie te delen vanuit Klaviyo, naar je andere marketing en tools op de manier die jij goeddunkt.

Belangrijkste onderdelen van webhook

webhook bestaan uit een paar stukken:

• Trigger
  De gebeurtenis die ervoor zorgt dat een webhook afgaat
• Bericht (of "de payload")
  Wat de webhook verstuurt, zoals belangrijke details over de URL van de gebeurtenis die het bericht triggert of de URL van het systeem dat het bericht ontvangt.
• Koppen
  Een plaats om extra informatie door te geven (zoals verificatie)

webhook in flow

Webhooks zijn op dit moment alleen beschikbaar binnen flow en worden verzonden wanneer een flow een bepaalde fase of stap bereikt. De webhook stuurt dan een POST-verzoek met gegevens over de gebeurtenis of ontvangers die de flow hebben geactiveerd.

Het is belangrijk om op te merken dat slechts één gebeurtenis de webhook kan initiëren om te verzenden. Als een abonnee aan de triggercriteria voldoet, wordt de webhook geactiveerd en wordt het bericht naar de aangewezen URL gestuurd. Bovendien kun je alleen webhooks versturen vanuit flow getriggerde gebeurtenissen, d.w.z. gebeurtenissen die kunnen worden gebruikt als een flow trigger. Je kunt bijvoorbeeld geen webhook sturen na een profielwijziging, omdat een flow niet direct kan reageren op profielwijzigingen.
Voorbeelden van evenementen in Klaviyo zijn:

• Bestelling geplaatst
• Afrekenen gestart
• Aangemeld voor lijst

webhook gebruikssituaties

Het is belangrijk om de flow triggers te begrijpen die webhooks kunnen genereren, evenals enkele praktische use cases over hoe je deze kunt implementeren met je andere applicaties.

Voorbeelden zijn:

• Een bericht sturen om vervallen klanten te re-betrekken.
• Stuur een bericht op de verjaardag van je klant en geef ze een cadeau in de vorm van spaarpunten.
• Stuur de webhook telkens wanneer een nieuwe abonnee zich bij je lijst voegt. Je kunt hun profielgegevens naar een ander platform sturen.
• Een klant een NPS-enquête sturen om meer te weten te komen over je abonnee.
• Het versturen van een bericht of POST-verzoek dat wordt geactiveerd op basis van het toevoegen van een abonnee aan een segment of lijst. Merk echter op dat we support de "Ontvangen Email" gebeurtenis niet als een flow trigger.

Voorbeeld uit de praktijk

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

Hier kan de webhook deze ervaringen samenbrengen. Je zou je webshop al geïntegreerd hebben in Klaviyo. In Klaviyo stel je een flow in die wordt geactiveerd op basis van de gebeurtenis Geplaatste bestelling. Je geeft ons dan de webhook van de direct mail tool en voegt details toe zoals de naam en het adres van de klant en wat ze in het bericht hebben besteld (de payload).

Elke keer dat iemand (zoals Shah) een bestelling plaatst, kan een gebeurtenis ervoor zorgen dat er een printcatalogus naar hun adres wordt gestuurd. De webhook aankoopgebeurtenis zal ervoor zorgen dat er informatie wordt verzonden naar je direct mailing tool in potentiële realtime rechtstreeks vanuit Klaviyo (d.w.z. het bericht of de payload).

Wat kan Klaviyo webhook niet doen?

webhook zijn niet bedoeld als bidirectionele synchronisatie van gegevens. Dit betekent dat u weliswaar andere platforms met Klaviyo kunt verbinden om gegevens van ons naar hen te sturen, maar dat u geen gegevens terug naar Klaviyo kunt sturen. Informatie zal flow van Klaviyo in de aangewezen systemen of applicaties waar je verbinding mee hebt, maar kan niet flow de andere kant op. webhook, in tegenstelling tot API's, werkt alleen in deze eenrichtingswijze.

Het is ook belangrijk om na te denken over de gebeurtenissen die je kiest om je informatie op te vragen, hoe vaak dit zal gebeuren en waar die gegevens uiteindelijk naartoe gaan in je systeem. Klaviyo biedt het raamwerk voor het koppelen van je stroomgegevens aan een platform, maar de uiteindelijke waarde hangt af van waar die informatie naartoe gaat nadat ze Klaviyo heeft verlaten en wat er mogelijk uit voortkomt. Daarom kan Klaviyo alleen in de gaten houden of de webhook werkt en niet waar de gegevens naartoe gaan of wat ze doen nadat ze ons systeem hebben verlaten.

Tot slot is het belangrijk om na te denken over de gegevens die Klaviyo wel en niet kan versturen via een webhook. Klaviyo bepaalde gegevenspunten niet kunnen versturen via een webhook op basis van de manier waarop onze flow triggers werken. We kunnen bijvoorbeeld geen e-mail open betrokkenheidsgegevens sturen voor elke keer dat een abonnee een e-mail opent, omdat je geen flow kunt triggeren op basis van opens.

Op dezelfde manier kun je op gebeurtenissen gebaseerde dynamische variabelen gebruiken in je webhook payload in een gebeurtenisgetriggerde flow, maar de beschikbare variabelen zijn verbonden met de oorspronkelijke gebeurtenis die de flow heeft getriggerd (dus net als bij flow e-mail). Als je bijvoorbeeld een winkelwagen verlaten flow hebt die wordt getriggerd door het evenement Starten afrekenen, kun je dynamische variabelen van dat evenement gebruiken in de payload van de webhook. Maar als je in dezelfde flow ook een flowfilter gebruikt of splitst met behulp van een Aan winkelwagen toegevoegd meetwaarde, kun je deze extra gegevens niet opnemen in de webhook payload.

Bij het instellen van je webhook is het dus belangrijk om te bedenken welke flow support kan gebruiken voor gegevenspunten en wat je wilt bereiken in je webhook setup.

Op dit moment worden couponcode, webfeeds en productfeed niet ondersteund in flow webhook.

Wie moet een webhook instellen?

Zoals hierboven vermeld, bepaalt u zelf welke systemen u met Klaviyo verbindt, op welke manier de informatie of gegevens worden verpakt en welke gegevens of info u ophaalt.

Met dit in gedachten raden we een ontwikkelaar aan om webhooks in te stellen om ervoor te zorgen dat de juiste gebeurtenissen worden verzonden vanaf Klaviyo en correct worden gepost in je applicatie. Klaviyo geeft je ook fouten als een webhook mislukt. Het is echter mogelijk dat we niet in staat zijn om diepere problemen met de webhook setup te diagnosticeren, of hoe de gegevens uiteindelijk naar je applicatie worden verzonden. 

Vereisten en overwegingen

Naast het feit dat je ervoor moet zorgen dat je een ontwikkelaar hebt om je webhook goed in te stellen en te testen op je begeleidende systeem, heeft Klaviyo een aantal belangrijke vereisten voor het gebruik van deze functionaliteit:

• Alleen gebruikersrollen die toegang hebben tot het maken van stromen kunnen webhooks instellen in Klaviyo. Hieronder vallen de rollen beheerder, beheerder en eigenaar.
• Voor extra beveiliging moettweestapsverificatie worden ingeschakeld binnen je account om webhooks te gebruiken of nieuwe webhook acties toe te voegen binnen een bestaande flow.

Klaar om op te stellen?

Webooks bieden krachtige mechanismen voor het communiceren van gegevens van Klaviyo naar uw andere externe systemen of applicaties. Als je klaar bent om je webhook in te stellen, kun je onze documentatiegids voor ontwikkelaars lezen over Hoe voeg ik een webhook actie toe aan een flow.

Extra hulpbronnen

• Inzicht in flowtriggers en -filters
• Een voorbeeld van een flow triggeropstelling bekijken
• Hoe je een webhook actie toevoegt aan een flow