> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://supr-bundles-and-subscriptions.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Klaviyo gebruiken

Klaviyo kan je abonnementsmails en sms'jes versturen in je eigen sjablonen en talen, en wij laten Klaviyo weten wat er gebeurd is. Wanneer een abonnement start, wordt verlengd, wordt gepauzeerd, mislukt of wordt opgezegd, sturen wij Klaviyo een gebeurtenis met het abonnement, de producten en de data. Het bericht bouw je zelf als Klaviyo-flow.

Dat is handig als je marketing al in Klaviyo draait en je wilt dat abonnementsberichten er hetzelfde uitzien en klinken als de rest, of als je sms wilt toevoegen aan je abonnementsberichten.

## Je Klaviyo-account koppelen

1. Ga in Klaviyo naar **Settings > Account > API keys** en maak een **Private API key** aan. **Full Access** werkt. Kies je **Custom**, zet dan **Events** op **Full** en **Accounts** op **Read**. Met een **Read-Only**-sleutel kunnen geen gebeurtenissen worden verstuurd. Klaviyo laat je de toegang van een sleutel achteraf niet wijzigen, dus als je de verkeerde hebt gekozen, maak je een nieuwe sleutel aan.
2. Ga naar [**Supr Bundles & Subscriptions > Instellingen > Integraties > Klaviyo**](https://admin.shopify.com/apps/super-subscriptions/app/settings/integrations/klaviyo). Plak de sleutel in **Privé-API-sleutel** en klik op **Koppelen**.

De pagina toont **Gekoppeld** met de naam van je Klaviyo-account. Voor je klanten verandert er nog niets: we blijven alle e-mails versturen totdat je anders kiest.

## Verstuur eerst een testgebeurtenis

Kies onder **Een gebeurtenis testen** een melding en een abonnement, of gebruik ons voorbeeldabonnement, en klik op **Testgebeurtenis versturen**.

De test gaat naar het contactadres van je winkel, niet naar een klant, en is gemarkeerd met `test: true` zodat je hem buiten een live flow kunt houden. Het werkt ook terwijl wij nog je klantmails versturen, zodat je eerst je flows kunt bouwen en daarna de afzender kunt wisselen.

Een metric verschijnt in Klaviyo zodra de eerste gebeurtenis is aangekomen, en daar dient de test voor. Klaviyo heeft een paar seconden nodig, dus herlaad de pagina als hij er niet meteen staat.

## Bouw een flow voor elke gebeurtenis

Maak in Klaviyo een flow en kies een **Metric** als trigger. Elke melding komt binnen als eigen metric:

| Metric in Klaviyo | Verstuurd wanneer |
|---|---|
| Subscription Started | Een abonnement wordt gestart |
| Subscription Restarted | Een abonnement wordt heractiveerd |
| Subscription Paused | Een abonnement wordt gepauzeerd |
| Subscription Cancelled | Een abonnement wordt opgezegd |
| Subscription Renewed | Een abonnement wordt succesvol verlengd |
| Subscription Updated | Een abonnement wordt gewijzigd |
| Subscription Next Order Date Changed | De datum van de volgende bestelling wordt gewijzigd |
| Subscription Renewing Soon | Vóór een verlenging van een abonnement, op de aanlooptijd die je kiest |
| Subscription Price Changed | De prijs van een abonnement verandert |
| Subscription Item Out Of Stock | Een artikel bij een aankomende verlenging is niet op voorraad |
| Subscription Failed | Een abonnement mislukt |
| Subscription Payment Failed | Een verlenging mislukt door de betaling van de klant, dus de klant moet de kaart oplossen |
| Subscription Renewal Failed | Een verlenging mislukt om een reden die de klant niet kan oplossen |
| Subscription Pause Reminder | Een paar dagen nadat een abonnement is gepauzeerd |
| Subscription Pause Win-Back | Een gepauzeerde klant krijgt een aanbod om terug te komen |
| Subscription Resuming Soon | Een paar dagen voordat een gepauzeerd abonnement vanzelf wordt hervat |
| Subscription Auto Resumed | Een gepauzeerd abonnement wordt vanzelf hervat |
| Subscription Auto Cancelled | Een gepauzeerd abonnement wordt opgezegd na de pauzelimiet |
| Subscription Win-Back 1, 2 and 3 | 14, 30 en 60 dagen nadat een abonnement is opgezegd |
| Subscription Box Revealed | De inhoud van een abonnementsbox wordt onthuld, op de datum die je voor die box hebt ingesteld |

Elke gebeurtenis bevat het abonnement, de producten, de totalen, de datum van de volgende bestelling en een link naar het klantenportaal. Gebruik de velden in je Klaviyo-sjabloon, bijvoorbeeld `{{ event.customerPortalUrl }}` voor de link om het abonnement te beheren, of `{{ event.linesSummary }}` voor een leesbare lijst van wat erin zit. Om elk product met afbeelding en prijs te tonen, loop je over `event.lines`.

Abonnementsbundels zijn inbegrepen. Elke productregel vermeldt bij welke bundel hij hoort en of het een product is dat de klant heeft gekocht of een beloning, zodat een flow een gratis cadeau anders kan behandelen dan het pakket.

## Kies wie je klantmails verstuurt

Kies onder **Wie je klantmails verstuurt** een van deze opties:

- **Supr Bundles & Subscriptions**: wij blijven alle klantmails versturen. Dit is de standaard.
- **Klaviyo**: wij stoppen met het versturen van klantmails en sturen de gebeurtenissen naar Klaviyo.
- **Per melding kiezen**: vink aan welke meldingen Klaviyo moet versturen, de rest blijven wij versturen.

Klik op **Opslaan**. Als de wijziging mails aan Klaviyo overdraagt, vraagt de app om bevestiging en toont hij de lijst met e-mails die niet meer van ons komen.

**Bouw de flow en zet hem aan voordat je een e-mail overdraagt.** Klaviyo accepteert onze gebeurtenissen of er nu een flow naar luistert of niet, dus een klant ontvangt niets totdat de flow voor die metric live staat.

Zodra een e-mail via Klaviyo gaat, toont **Instellingen > Meldingen** er **Verstuurd via Klaviyo** naast, en de sjabloon daar is niet wat de klant ontvangt. Wijzig het bericht dan in Klaviyo.

### Onze e-mails houden en ook elke gebeurtenis sturen

Zet **Klaviyo ook de gebeurtenissen sturen die we niet overdragen** aan. Wij blijven die e-mails zelf versturen, en elke e-mail komt ook in Klaviyo binnen als gebeurtenis, zodat je daar klanten kunt taggen, segmenten kunt bouwen of een vervolg kunt draaien. De klant krijgt onze e-mail en wat je flow verstuurt. Die e-mails tonen **Ook naar Klaviyo gestuurd** onder **Instellingen > Meldingen**.

Een klantmail heeft één afzender. Als Omnisend een e-mail al verstuurt, kan Klaviyo hem niet ook versturen, en de pagina laat zien welke dat zijn. Spiegelen wordt hier niet door beïnvloed: beide kunnen de gebeurtenissen ontvangen.

## Goed om te weten

- Elke klantmail heeft één afzender, wij of Klaviyo. Met **Klaviyo ook de gebeurtenissen sturen die we niet overdragen** aan kan een flow die je op die gebeurtenissen bouwt ook een eigen bericht versturen.
- Meldingen aan medewerkers en de schakelaars **Stuur me een kopie** blijven in beide gevallen van ons komen.
- Een melding die onder **Instellingen > Meldingen** is uitgezet, staat overal uit, ook in Klaviyo. Zet hem daar eerst aan. Zie [Notifications](https://supr-bundles-and-subscriptions.crisp.help/nl/article/notifications-1as6yux/).
- Weigert Klaviyo een gebeurtenis, bijvoorbeeld omdat de sleutel is verwijderd, dan sturen wij die klant onze eigen e-mail, zodat niemand met lege handen blijft. De Klaviyo-pagina toont dan **Klaviyo heeft de laatste gebeurtenis geweigerd** met een knop **Sleutel opnieuw controleren**.
- De gebeurtenissen die we versturen worden onderdeel van je Klaviyo-account, dat je zelf beheert. Vraagt een klant je om zijn gegevens te wissen, verwijder hem dan in Klaviyo en in Shopify. Wissen in Shopify verwijdert hem niet uit Klaviyo.

## Ontkoppelen

Klik op de Klaviyo-pagina op **Ontkoppelen**. Wij verwijderen je sleutel en gaan weer zelf je klantmails versturen. Klaviyo-flows die op deze gebeurtenissen zijn gebouwd, ontvangen ze niet meer.