De verschillende webhooks in Klaviyo begrijpen

Wat je leert

Lees meer over de verschillen tussen webhook-oplossingen die beschikbaar zijn in Klaviyo en wanneer je elk ervan moet gebruiken.

Voordat je van start gaat

Wat zijn webhooks?

Webhooks stellen Klaviyo in staat om informatie door te geven of andere applicaties, tools en servers te "roepen" via HTTP-verzoeken. Ze kunnen informatie versturen over een gebeurtenis die heeft plaatsgevonden (bijv. een geplaatste bestelling, een nieuwe klant die zich heeft aangemeld, enz.) of je externe systemen laten weten dat de gebeurtenis heeft plaatsgevonden.

Webhooks bestaan uit een paar belangrijke onderdelen:

• Onderwerp
  De gebeurtenis waardoor een webhook wordt geactiveerd.
• Body (of 'de payload')
  De gegevens die de webhook verzendt.
• Kopteksten
  Een plek om aanvullende informatie door te geven (zoals authenticatie).

Flow-webhooks

Je kunt webhooks in flows toevoegen als een actie die plaatsvindt wanneer de flow een bepaald stadium of een bepaalde stap bereikt. Zodra een flow de webhook-actie bereikt, wordt er een POST-verzoek verzonden met gegevens over de gebeurtenis of de ontvanger die de flow heeft geactiveerd, afhankelijk van hoe je de payload opbouwt.

Flow-webhooks kunnen alleen verzenden op basis van door flow getriggerde events (oftewel events die als flowtrigger kunnen worden gebruikt). Daarnaast ondersteunen flow-webhooks geen berichtgerelateerde events (bijv. E-mail ontvangen, E-mail aangeklikt, E-mail als spam gemarkeerd), omdat flows meestal eindigen bij ontvangst van een bericht.

Voorbeelden van use cases voor flow-webhook

Enkele voorbeelden van use cases waarbij flow-webhooks het meest effectief zijn, zijn:

• Verzend een bericht of POST-verzoek dat wordt geactiveerd op basis van het toevoegen van een abonnee aan een segment of lijst.
• Automatiseer onderdrukking wanneer een profiel een niet-betrokken segment binnenkomt.
• Stuur een gepersonaliseerd bedankbericht via een service zoals Whatsapp of Facebook messenger wanneer klanten een aankoop doen.

Webhooks in Advanced Klaviyo Data Platform

Met webhooks in Advanced Klaviyo Data Platform kun je externe systemen op de hoogte stellen als reactie op gebeurtenissen, zonder afhankelijk te zijn van een reeks stappen die voorafgaat aan de webhook-actie. Webhooks in Advanced Klaviyo Data Platform vereisen niet dat je de body van het webhookverzoek handmatig opstelt of specificeert. Als je je externe systemen wilt laten weten dat er een gebeurtenis heeft plaatsgevonden zonder aangepaste ontwikkeling, zijn webhooks in Advanced Klaviyo Data Platform het meest effectief.

Geavanceerde webhooks voor Advanced Klaviyo Data Platform ondersteunen ook een breder scala aan onderwerpen om de aanvraag te triggeren en stellen je in staat om informatie te verzenden als reactie op elke gebeurtenis die je kunt opvragen via de Get Events API.

Deze omvatten:

• E-mailevents (bijv. E-mail ontvangen, Geklikt op e-mail, E-mail als spam gemarkeerd)
• Sms-gebeurtenissen (bijv. Verzonden sms, Ontvangen sms)
• Pushmeldinggebeurtenissen (bijv. Pushmelding ontvangen, pushmelding teruggekaatst)
• Events uit integraties (d.w.z. events uit first-party-integraties die door Klaviyo zijn gemaakt)
• API-events (bijv. events die worden gesynchroniseerd via Klaviyo's API)

Dit omvat berichtgerelateerde gebeurtenissen zoals afmelden, E-mail ontvangen of Op e-mail geklikt die niet worden ondersteund door flow-webhook.

Daarnaast kun je je met Advanced Klaviyo Data Platform-webhooks tegelijk aanmelden voor meerdere triggers, in tegenstelling tot flow-webhooks, die afhankelijk zijn van flows met één trigger.

Voorbeeldusecases voor webhook van Advanced Klaviyo Data Platform

• Synchroniseer afmelden -gebeurtenissen van klanten naar externe systemen.
• Meld Received Email -gebeurtenissen aan helpdesksoftware zodat medewerkers de e-mailgeschiedenis kunnen zien om klanten beter te helpen.
• Synchroniseer alle e-mailverzendingen, opens en clicks naar een datawarehouse dat niet wordt ondersteund door de datawarehouse-synchronisatie van Klaviyo.

Code

Code is een functie die is inbegrepen bij Klaviyo Advanced Klaviyo Data Platform. Het is niet inbegrepen in Klaviyo's standaard marketingtoepassing en je hebt een abonnement op Advanced Klaviyo Data Platform nodig om toegang te krijgen tot de bijbehorende functionaliteit. Bezoek onze factureringsgids voor meer informatie over het toevoegen van deze functionaliteit aan je abonnement of ga aan de slag als je een nieuwe klant bent.

Code maakt gebruik van webhook om het uitvoeren van aangepaste functies mogelijk te maken als reactie op een gebeurtenistrigger. Je kunt code rechtstreeks in de editor van Klaviyo schrijven en Klaviyo beheert de uitvoering, monitoring en logging van de code.

Als je verzoeken naar je externe systemen wilt sturen zonder een openbaar HTTP-eindpunt te hosten, kun je Code gebruiken. Als je daarnaast aangepaste functies wilt uitvoeren als reactie op een gebeurtenis die plaatsvindt, moet je Code gebruiken in plaats van de andere webhook-oplossingen die beschikbaar zijn in Klaviyo.

Code biedt in Advanced Klaviyo Data Platform ook meer granulariteit met eventtriggers via webhook dan via webhooks. Je kunt individuele meetwaarden selecteren die als onderwerp fungeren in plaats van alle integratie- of API-events.

Use cases voor voorbeeldcode

• Importeer Python-JSON-bibliotheken om eventpayloads te parsen en iets te extraheren.
• Stel aangepaste profieleigenschappen in op basis van gebeurtenismetadata met Klaviyo’s API.
• Importeer chatGPT-bibliotheken en maak een aangepast bericht voor elke winkelwagen verlaten op basis van het profiel en de items in de winkelwagen.