Förstå webhooks i flöden

Du kommer att lära dig

Läs om webhooks i flöden och hur de skickar information från Klaviyo till dina tredjepartsverktyg och applikationer. Det är viktigt att notera att det kan vara komplext att konfigurera webhooks. Vi rekommenderar att du har utvecklingskunskaper eller utvecklingsresurser för att slutföra den här konfigurationen korrekt. Om du letar efter de här utvecklingsinstruktionerna kan du läsa hur du lägger till en webhook-åtgärd i ett flöde.

Vad är webhooks?

Enkelt uttryckt skapar webhook en omfattande metod för alla dina marknadsförings- och dataverktyg att prata med varandra. Som ett exempel kan vi föreställa oss hur internetbank och bedrägeriskydd för ditt kreditkort fungerar. Om någon använder ditt kort bedrägligt loggas transaktionen hos återförsäljaren och skickas sedan till din bank, som analyserar den och varnar dig via telefon eller e-post när det finns ett problem med ditt kort. Det här köpet ledde till att en serie system kommunicerade, flyttade dessa data och till slut meddelade dig. Dessa system använder troligen webhook för att föra vidare dessa data. webhook:

• Låt din applikation skicka information eller ”anropa” andra applikationer, verktyg och servrar via HTTP-begäran.
• Skicka information om en händelse som har inträffat (t.ex. en beställning som har lagts, en ny kund som har prenumererat osv.).
• Kan tala om för ditt system att en händelse har inträffat eller meddela dig om den händelsen.

Den här händelseinformationen levereras sedan på det sätt och till den plats du väljer. Med andra ord ger webhook värdefulla sätt att dela data och information inifrån Klaviyo ut till dina andra marknadsföringsverktyg och andra verktyg på det sätt som du tycker passar.

Viktiga komponenter i webbhooks

Webhook består av några delar:

• Utlösare
  Händelsen som gör att en webhook utlöses
• Meddelande (eller ”payloaden”)
  Det som webhooken skickar, till exempel viktiga detaljer om den utlösande händelsen, URL:en dit meddelandet skickas eller URL:en för systemet som tar emot meddelandet
• Sidhuvuden
  En plats för att skicka ytterligare information (till exempel autentisering)

Webhooks i flöden

Webhooks är för närvarande bara tillgängliga i flöden och skickas när ett flöde når ett visst steg. Webhooken skickar sedan en POST-begäran med data om händelsen eller mottagaren som utlöste flödet.

Det är viktigt att notera att endast en händelse kan initiera att webhooken skickas. När en prenumerant uppfyller utlösarkriterierna kommer webhooken att utlösas och skicka meddelandet till den angivna webbadressen. Dessutom kan du bara skicka webhookar utifrån flödesutlösta händelser, vilket innebär händelser som kan användas som en flödesutlösare. Du kan till exempel inte skicka en webhook utifrån att en profilegenskap ändras, eftersom ett flöde inte kan utlösas direkt från profiländringar.
Exempel på händelser i Klaviyo är:

• Skapade Beställning
• Startade kassaprocessen
• Prenumererar på lista

Användningsfall för webhook

Det är viktigt att förstå vilka flödesutlösare som kan generera webhookar, samt några praktiska användningsfall för hur du kan implementera dessa med dina andra applikationer.

Exempel är:

• Skicka ett meddelande för att återengagera kunder som inte varit aktiva på länge.
• Skicka ett meddelande på dina kunders födelsedag och ge dem en gåva i form av lojalitetspoäng.
• Skicka webhooken när en ny prenumerant går med i dina listor. Du kan skicka deras profildata till en annan plattform.
• Skicka en NPS-undersökning till en kund för att ta reda på mer om dina prenumeranter.
• Skicka ett meddelande eller en POST-begäran som utlöses baserat på att en prenumerant läggs till i ett segment eller en lista. Observera dock att vi inte har stöd för händelsen ”Received Email” som utlösare för ett flöde.

Exempel från verkligheten

Du bestämmer dig för att ansluta Klaviyo till ditt verktyg för direktutskick så att du kan kommunicera med kunder online och via post. Din nya kund Shah gick till din webbplats och köpte några varor från din e-handelsbutik. Du vill skicka Shah en tryckt katalog med hela din kollektion i framtiden.

Här kan webhooken koppla ihop de här upplevelserna. Du har redan integrerat din e-handelsbutik med Klaviyo. I Klaviyo konfigurerar du ett flöde som utlöses baserat på händelsen Genomförd beställning. Du skulle sedan ge oss webhooken för direktpostverktyget och inkludera detaljer som kundens namn, adress och vad de beställde i meddelandet (dvs. nyttolasten).

Nu kan en händelse, varje gång någon (som Shah) lägger en order, starta att en tryckt katalog skickas till personens adress. Webhook-köphändelsen gör att information skickas till ditt verktyg för direktutskick i potentiell realtid direkt från Klaviyo (dvs. meddelandet eller payloaden).

Vad kan Klaviyo-webhookar inte göra?

Webhook är inte avsedda att vara en dubbelriktad synkronisering av data. Det innebär att även om du kan ansluta andra plattformar till Klaviyo för att skicka data från oss till dem, kan du inte skicka data tillbaka till Klaviyo. Informationen kommer att flöda från Klaviyo till de angivna system eller applikationer som du har anslutit till, men kan inte flöda åt andra hållet. Webhook kommer, till skillnad från API:er, bara att fungera på det här enkelriktade sättet.

Det är också viktigt att tänka på vilka händelser du väljer att använda för att trigga din information, hur ofta det sker och vart dessa data i slutändan hamnar i ditt system. Klaviyo tillhandahåller ramverket för att koppla dina flödesdata till en plattform, men det slutliga värdet beror på vart informationen tar vägen efter att den lämnar Klaviyo och vad den kan trigga. Därför kan Klaviyo endast övervaka om webhooken fungerar, inte vart datan tar vägen eller vad den gör efter att den har lämnat vårt system.

Slutligen är det viktigt att tänka på vilka data som Klaviyo kan och inte kan skicka via en webhook. Klaviyo kan inte skicka vissa datapunkter via en webhook baserat på hur våra flödesutlösare fungerar. Till exempel kan vi inte skicka engagemangsdata för e-postöppningar för varje gång en prenumerant öppnar ett e-postmeddelande, eftersom du inte kan utlösa ett flöde baserat på öppningar.

På samma sätt kan du använda händelsebaserade dynamiska variabler i din webhook-payload i ett händelseutlöst flöde, men de tillgängliga variablerna är kopplade till den ursprungliga händelsen som utlöste flödet (dvs. precis som med flödesmejl). Om du till exempel har ett flöde för övergiven kundvagn som utlöses av händelsen Started Checkout kan du använda dynamiska variabler från den händelsen i webhookens payload. Men om du i samma flöde också använder ett flödesfilter eller en delning baserat på ett Added to Cart -mättal kan du inte inkludera den här ytterligare datan i webhook-payloaden.

När du konfigurerar dina webhookar är det därför viktigt att tänka på vilka flöden som kan stödja datapunkter och vad du vill uppnå med din webhook-konfiguration.

För närvarande stöds inte kupongkoder, webbfeeds och produktfeeds i flödeswebhookar.

Vem bör konfigurera webhookar?

Som nämnts ovan är det helt upp till dig vilka system du ansluter till Klaviyo, hur informationen eller datan paketeras och vilka data eller vilken information du väljer att hämta.

Med detta i åtanke rekommenderar vi starkt att du tar in en utvecklingsresurs för att konfigurera webhookar så att rätt händelser skickas från Klaviyo och publiceras korrekt i din applikation. Klaviyo kommer också att ge dig fel om någon webhook misslyckas. Vi kanske däremot inte kan diagnostisera djupare problem med webhook-konfigurationen eller hur data i slutändan publiceras i din applikation.

Krav och saker att tänka på

Förutom att se till att du har en utvecklarresurs som kan konfigurera din webhook korrekt och testa den i ditt tillhörande system har Klaviyo några viktiga krav för att använda den här funktionen:

• Endast användarroller som har åtkomst att skapa flöden kan konfigurera webhookar i Klaviyo. Detta inkluderar rollerna Chef, Administratör och Ägare.
• För extra säkerhet måste tvåstegsautentisering vara aktiverat i ditt Konto för att du ska kunna använda webhook eller lägga till nya webhook-åtgärder i ett befintligt flöde.

Redo att konfigurera?

Webhook erbjuder kraftfulla mekanismer för att kommunicera data från Klaviyo till dina andra externa system eller applikationer. Om du är redo att konfigurera dina webhook kan du läsa vår utvecklardokumentationsguide om Så lägger du till en webhook-åtgärd i ett flöde.

Ytterligare resurser