Klaviyo-integratie

×

Klik ergens of druk op Esc om te sluiten

Klaviyo draait je e-mail- en sms-flows; Personyze weet wat elke bezoeker op je site doet. Gekoppeld worden de doelgroepen die Personyze bouwt brandstof voor Klaviyo: gematchte bezoekers stromen naar Klaviyo-lijsten, en campagneactiviteit komt als events op hun profielen terecht — zodat een welkomstreeks, winback- of nurture-flow kan reageren op gedrag op de site zoals “bezocht twee keer de prijspagina, heeft een e-mailadres, heeft nog niet gekocht.”

De integratie installeren

1. Ga in het panel van Personyze naar Instellingen → Integraties, open de kaart Klaviyo en klik op Verbinden met Klaviyo.
2. Er opent een pop-up met het toestemmingsscherm van Klaviyo. Keur de gevraagde scopes goed:
   • accounts:read — één testaanroep voor de koppeling als je verbindt.
   • lists:read, lists:write, profiles:read, profiles:write — de automatisering “Toevoegen aan Klaviyo-lijst”.
   • events:write — de automatisering “Event versturen”.
3. De pop-up toont Toegang verleend en het paneel toont Gekoppeld. Klaar — geen API-sleutels, niets om te vernieuwen.

Toepassing 1 — gematchte doelgroepen aan een Klaviyo-lijst toevoegen

1. Maak (of kies) in Klaviyo een lijst en noteer de lijst-ID van zes tekens — open de lijst onder Lists & Segments en kopieer de ID uit de URL.
2. Maak in Personyze een automatiseringscampagne (Campagnes → Nieuw → Automatisering) en definieer de doelgroep — elke regel die je wilt: bezochte pagina’s, bekeken producten, CRM-velden, “heeft een e-mailadres”.
3. Voeg de actie Toevoegen aan Klaviyo-lijst toe en plak de lijst-ID. Publiceer.
4. Zodra gebruikers bij de doelgroep passen, verschijnen hun profielen in de Klaviyo-lijst — bijgewerkt op basis van e-mailadres en ontdubbeld door Klaviyo, zodat opnieuw matchen nooit duplicaten oplevert. Het matchen draait ongeveer elke 20 minuten; de QA-stap van de campagne heeft een knop Nu checken om het meteen te draaien.

Hang je Klaviyo-flow aan die lijst, en de segmentatie op de site van Personyze stuurt hem aan.

Toepassing 2 — events naar Klaviyo-profielen sturen

1. Voeg in dezelfde (of een andere) automatisering Event naar analytics versturen (automatisering) toe en vink Klaviyo aan.
2. Geef het event een naam — bijv. Personyze Audience Matched — en voeg eventueel eigenschappen toe. Eigenschapswaarden kunnen putten uit het Personyze-profiel van de persoon (branche, levenscyclusfase, elk eigen veld) en live campagnemetrieken.
3. Als de automatisering afgaat, verschijnt het event in de activiteitenfeed van het gematchte profiel in Klaviyo — klaar om flows te starten of segmenten op te bouwen.

Werkt ook zonder koppeling

• Events op de pagina — de gewone actie Event naar analytics versturen (op de site) kan onsite-events van Klaviyo versturen via klaviyo.js op je pagina, zonder dat er een accountkoppeling nodig is.
• Formulieren voor leadverzameling — de stap Waar de data naartoe gaat van een Personyze-formulier kan elke inzending naar Klaviyo sturen als een Personyze Form Submitted -event op het profiel dat bij het ingezonden e-mailadres past (formulieren zonder e-mailveld worden overgeslagen).

Via OAuth koppelen maakt de automatiseringen op accountniveau hierboven mogelijk, zonder sleutels op welk formulier dan ook.

Loskoppelen

Instellingen → Integraties → Klaviyo → verbinding verbreken (of Toegang intrekken in de koppelingspop-up). Alle API-aanroepen stoppen meteen; opnieuw koppelen herstelt ze. Klaviyo houdt een eigen overzicht bij van geïnstalleerde apps — om het daar ook te verwijderen, ga je in Klaviyo naar Settings → API keys & apps en verwijder je Personyze.

Opmerkingen over beveiliging

Autorisatie gebruikt de OAuth 2.0-autorisatiecode met PKCE (S256). Access- en refreshtokens worden alleen aan de serverkant opgeslagen en nooit aan de browser getoond; refreshtokens roteren bij elke vernieuwing.

Problemen oplossen

• Profiel verschijnt niet in de lijst — de persoon moet een e-mailadres op het Personyze-profiel hebben (dat is de sleutel waarop Klaviyo bijwerkt). Controleer of de lijst-ID de ID van zes tekens uit de URL is, en gebruik Nu checken in de QA-stap in plaats van op de cyclus van ongeveer 20 minuten te wachten.
• Event verschijnt niet — events hangen aan het gematchte profiel; controleer of dezelfde persoon in Klaviyo bestaat (de lijstactie maakt die aan, dus draai die eerst of samen met de events).
• Het paneel zegt na goedkeuring nog steeds niet gekoppeld — de pop-up controleert de toestemming met één GET /api/accounts/ -aanroep; heeft je Klaviyo-gebruiker geen rechten om apps te installeren, dan mislukt de toestemming daar. Koppel opnieuw met een Klaviyo-login van een eigenaar/beheerder.

Gerelateerd

• Campagnetargeting — de doelgroepregels waarop automatiseringen draaien.
• Google Analytics-integratie — dezelfde eventactie kan rapporteren aan GA4, Segment, Tealium en de GTM-datalaag.
• Event naar analytics versturen — elke bestemming die dezelfde actie kan bereiken, en wat elke bestemming nodig heeft.
• ActiveCampaign-integratie — dezelfde actie opnieuw, alleen in de versie voor automatisering: die tagt een contact in plaats van een event te versturen.