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?

Met webhook kan Klaviyo informatie doorgeven of andere applicaties, tools en servers “aanroepen” via HTTP-verzoeken. Ze kunnen informatie sturen 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).
• Bestemmings-URL
  Het eindpunt dat de webhookaanvraag ontvangt.

Flow-webhooks

Je kunt webhooks in flows toevoegen als actie. Wanneer een profiel een geconfigureerde webhookactie bereikt die is ingesteld op Live, stuurt Klaviyo een POST-verzoek naar je bestemmings-URL met de gegevens die je in de payload opneemt. Dit kan profielgegevens bevatten en, in een door een meetwaarde getriggerde flow, gegevens uit de gebeurtenis die de flow heeft getriggerd.

Je kunt flow-webhooks toevoegen aan flows die worden geactiveerd door een meetwaarde, lijst, segment of datumeigenschap. Berichtgerelateerde gebeurtenissen zoals E-mail ontvangen, E-mail aangeklikt of E-mail als spam gemarkeerd kunnen niet worden gebruikt als flow-triggers.

Voorbeelden van use cases voor flow-webhook

Enkele voorbeeldtoepassingen waarin flow-webhooks het meest effectief zijn, zijn onder andere:

• 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 dienst zoals WhatsApp of Facebook Messenger wanneer klanten iets kopen.

Webhooks in Advanced Klaviyo Data Platform

Webhooks in Advanced Klaviyo Data Platform stellen externe systemen op de hoogte als reactie op gebeurtenissen, onafhankelijk van flow-stappen. Klaviyo bouwt de requestbody voor je. Gebruik deze webhooks wanneer je een vooraf samengestelde event-payload naar een extern systeem wilt verzenden. Dat systeem moet een eindpunt hebben dat de aanvragen kan ontvangen en verwerken.

Advanced Klaviyo Data Platform-webhooks ondersteunen een breder scala aan onderwerpen dan flow-webhooks, waaronder berichtgerelateerde gebeurtenissen die beschikbaar zijn via de Get Events API. Kies afzonderlijke meetwaarden als onderwerpen wanneer je je webhook configureert.

Voorbeelden zijn onder andere:

• 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 events zoals het oudere afmelden -event (een klik op een e-mailafmeldingslink), E-mail ontvangen of E-mail aangeklikt die niet kunnen worden gebruikt als flowtriggers. Afmelden voor e-mailmarketing is een apart event dat een flow kan triggeren.

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 klanten hun afgemeld voor e-mailmarketing -events met 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 inbegrepen bij Advanced Klaviyo Data Platform. Je account heeft toegang nodig tot Advanced Klaviyo Data Platform om deze door events geactiveerde functies te gebruiken. Bekijk onze factureringsgids om te leren hoe je dit abonnement toevoegt of ga aan de slag als je een nieuwe klant bent.

Code gebruikt webhooks om aangepaste functies uit te voeren als reactie op een gebeurtenistrigger. Je kunt Python of JavaScript rechtstreeks in de editor van Klaviyo schrijven, en Klaviyo beheert de uitvoering van de code, monitoring en logging.

Gebruik Code wanneer je de ontwikkelresources hebt om aangepaste functies te schrijven die worden uitgevoerd als reactie op events. Klaviyo host de functies, dus je hoeft niet je eigen eindpunt te hosten om de activerende webhook te ontvangen. Om gegevens naar een ander systeem te sturen, moet je code verbinding maken met de API of service van dat systeem.

Met webhook van zowel Code als Advanced Klaviyo Data Platform kun je afzonderlijke meetwaarden selecteren als triggers.

Use cases voor voorbeeldcode

• Gebruik Python libraries om gebeurtenisgegevens te lezen en waarden zoals een boekingsstad te extraheren voor gebruik in aangepaste logica.
• Stel aangepaste profieleigenschappen in op basis van gebeurtenismetadata met Klaviyo’s API.
• Roep een AI-service aan om een aangepast bericht te maken voor elke winkelwagen verlaten op basis van het profiel en de items in de winkelwagen.

Extra hulpbronnen