Förstå webhookar i Advanced Klaviyo Data Platform

Du kommer att lära dig

Läs mer om webhookar och hur du kan använda dem för att skicka information till dina tredjepartsappar som svar på händelser som registreras i Klaviyo. För mer detaljerad information om hur du tar emot systemwebhookar kan du gå till vår utvecklarresurs om att arbeta med systemwebhookar.

This content requires Functional cookies to be enabled.

Update Cookie Settings

Vad är webhooks?

Webhookar gör att Klaviyo kan skicka information eller ”anropa” andra applikationer, verktyg och servrar via HTTP-begäranden. De kan skicka information om en händelse som har inträffat (t.ex. en lagd beställning, att en ny kund har prenumererat osv.) eller meddela dina externa system att händelsen har inträffat.

Klaviyo har stöd för 2 typer av webhook:

1. Webhookar i Advanced Klaviyo Data Platform
   Webhookar som är tillgängliga som en del av Advanced Klaviyo Data Platform används för att meddela dina externa system att en viss händelse har inträffat och gör att du kan skicka information som svar på en mängd olika händelser utan begränsningarna som finns i ett flöde.
2. Webhook för flöde
   Webhook för flöde är bara tillgängliga i flödesgränssnittet och utlöses när flödet når ett visst steg. De kan användas för att skicka data om händelsen eller mottagaren som utlöste flödet.

Viktiga komponenter i webbhooks

Webhooks består av några viktiga komponenter:

• Ämne
  Händelsen som gör att en webhook utlöses
• Brödtext (eller ”payloaden”)
  De data som webhooken skickar
• Sidhuvuden
  En plats för att skicka ytterligare information (till exempel autentisering)

Hur skiljer sig webhook i Advanced Klaviyo Data Platform från webhook för flöde?

Du kan använda webhookar i Advanced Klaviyo Data Platform eller flödeswebhookar beroende på dina behov.

Inkluderade händelser

Webhookar i flöden kan bara svara på en delmängd av Klaviyo-händelser och har inte stöd för meddelanderelaterade händelser som avsluta prenumeration, Fick e-post eller Klickade på e-post, eftersom flöden vanligtvis slutar med att ett meddelande tas emot snarare än att de börjar med det. Samtidigt kan du med webhookar i Advanced Klaviyo Data Platform skicka information som svar på vilken händelse som helst i ditt Konto.

Dessa inkluderar:

• E-posthändelser (t.ex. Mottagit e-post, Klickat på e-post, Markerat e-post som skräppost, avsluta prenumeration)
• Sms-händelser (t.ex. Skickat sms, Mottaget sms)
• Händelser för pushnotis (t.ex. Tog emot pushnotis, Pushnotis studsade)
• Händelser från integrationer (dvs. händelser från förstapartintegrationer som skapats av Klaviyo)
• API-händelser (t.ex. händelser som synkas via Klaviyo’s API)

Nyttolast

Webhook för flöde gör att du kan anpassa data som ingår i begäran, men du måste manuellt skapa nyttolasten. Samtidigt använder webhookar i Advanced Klaviyo Data Platform en förbyggd nyttolast som inte kräver något manuellt arbete från din sida, och de används för att meddela externa system att en händelse har inträffat.

Begränsningar för flöden

Webhookar för flöden måste konfigureras i flödesgränssnittet och gör det inte möjligt att använda flera utlösare samtidigt. Olika utlösare måste skapas via enskilda flöden och beror på flödets övergripande status (t.ex. skulle ett flöde i utkast inte skicka data via flödets webhook). Samtidigt finns webhookar i Advanced Klaviyo Data Platform utanför flödesgränssnittet och är inte beroende av serien av steg som leder fram till webhook-åtgärden, som en webhook för ett flöde är.

Konfigurera webhook

För att konfigurera en webhook i Klaviyo går du till webhook under Advanced Klaviyo Data Platform > Data managment > Webhooks i Klaviyo.

För att lägga till en ny webhook klickar du på knappen Skapa webhook.

1. I modalfönstret Create a webhook anger du informationen. Detta inkluderar:
   • Namn
     Så här identifierar du din webhook
   • URL för slutpunkt
     URL:en som är associerad med destinationen för webhook-begäran
   • Hemlig nyckel
     En unik identifierare för att identifiera Klaviyo-webhook-begäranden i dina andra system
   • Beskrivning
     En valfri beskrivning av din webhook.
2. I avsnittet Ämnen väljer du de händelser som du vill ska utlösa webhook-aviseringen

När du har skapat din webhook visas den på sidan webhook tillsammans med:

• Namn på webhook
• URL för webhook
• Tidpunkt för den senaste synkroniseringen
• Status

Du kan ta bort eller inaktivera din webhook via menyn bredvid objektet.

Testa systemwebhook

När du konfigurerar en webhook i Klaviyo kan du testa den för att se till att anslutningen fungerar. För att testa din webhook använder du knappen Testa anslutning efter att du har angett de obligatoriska fälten.

En meny visas där du kan välja ett ämne och skicka ett test till din callback-URL.

Efter att du har genomfört testet ser du ett meddelande som anger om det lyckades, tillsammans med sidhuvudet och brödtexten för förfrågan ifyllda på fliken Svar.

Exempel på nyttolast

Nedan är ett exempel på nyttolasten för en webhook-begäran som svar på ämnet E-post levererad.

{
  "meta": {
    "timestamp": "2023-08-10T07:25:23.700369+00:00",
    "klaviyo_webhook_id": "ID",
    "version": "2023-06-03"
  },
  "data": [
    {
      "topic": "event: email_delivered",
      "external_id": "ID",
      "payload": {
        "data": {
          "id": "ID",
          "type": "event",
          "links": {
            "self": "https://a.klaviyo.com/api/events/ID/"
          },
          "attributes": {
            "uuid": "96150200-374e-11ee-8001-a163313bc6c2",
            "datetime": "2023-08-10 07:21:56+00:00",
            "timestamp": 1691652116,
            "event_properties": {
              "$ESP": 0,
              "Subject": "? Free (Cool!) Swag Alert ?",
              "$message": "01H7F525FKR31P27Y7PNGVBBKK",
              "$event_id": "01H7F525FKR31P27Y7PNGVBBKK:125423419905414052533228990613763937641",
              "$group_ids": [
                "V7adxq"
              ],
              "$attribution": {
                "$send_ts": 0,
                "$attributed_event_id": ""
              },
              "Email Domain": "klaviyo-demo.com",
              "Campaign Name": "Daily Newsletter: 2023-08-10",
              "Inbox Provider": "Amazon SES Inbound",
              "$_cohort$message_send_cohort": "1691652081:01H7F525FKR31P27Y7PNGVBBKK"
            }
          },
          "relationships": {
            "metric": {
              "data": {
                "id": "ID",
                "type": "metric"
              },
              "links": {
                "self": "https://a.klaviyo.com/api/events/ID/relationships/metric/",
                "related": "https://a.klaviyo.com/api/events/ID/metric/"
              }
            },
            "profile": {
              "data": {
                "id": "ID",
                "type": "profile"
              },
              "links": {
                "self": "https://a.klaviyo.com/api/events/ID/relationships/profile/",
                "related": "https://a.klaviyo.com/api/events/ID/profile/"
              }
            }
          }
        }
      }
    },
  

Ytterligare resurser