> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Klaviyo koppelen

> Koppel Klaviyo onder Apps en integraties met een Private API key en kies welke gebeurtenissen over zendingen, bestellingen en track & trace Klaviyo ontvangt voor zijn e-mails en sms-berichten.

Klaviyo ontvangt je gebeurtenissen over zendingen, bestellingen en track & trace als metrics. In Klaviyo kun je ze gebruiken om e-mails en sms'jes te starten, bijvoorbeeld "je pakket is onderweg". Klaviyo verstuurt die berichten vanuit je eigen Klaviyo-account. Zippendo geeft alleen de gebeurtenissen door.

Integraties zijn inbegrepen bij elk abonnement. Testen, het afleverlog, bewerken en ontkoppelen werken voor elke app hetzelfde: zie [Een integratie koppelen](/docs/nl/how-to/connect-an-integration). De uitgebreidere handleiding is [Klaviyo](/docs/nl/integrations/klaviyo).

## Voordat je begint

Je hebt een private API key van Klaviyo nodig. Maak die aan in je Klaviyo-account onder Settings → API keys. Klaviyo laat alleen een Owner of Admin er een aanmaken. Laat de sleutel gebeurtenissen aanmaken, want dat doet Zippendo ermee.

<Frame caption="Het helpartikel van Klaviyo over het aanmaken van een private API key">
  <img src="https://mintcdn.com/zippendo/pwy1g1EbXWJlGtUC/images/how-to/connect-klaviyo/10-klaviyo-create-api-key.png?fit=max&auto=format&n=pwy1g1EbXWJlGtUC&q=85&s=712d5a72dd7598a4666bffb6083e1b7a" alt="Helpartikel van Klaviyo How to create or clone a private API key, waarvoor de rol Owner of Admin nodig is" width="2880" height="2200" data-path="images/how-to/connect-klaviyo/10-klaviyo-create-api-key.png" />
</Frame>

## Klaviyo koppelen

<Steps>
  <Step title="Zoek Klaviyo in de catalogus">
    Klik in de zijbalk op **Apps en integraties** en dan op **Catalogus**. Klaviyo staat onder **Apps**. Klik op **Koppelen**, of op **Koppeling toevoegen** als je er al een hebt.
  </Step>

  <Step title="Bekijk de toegang">
    Lees wat Zippendo met de koppeling gaat doen en klik op **Doorgaan**.
  </Step>

  <Step title="Vul de gegevens van de koppeling in">
    Typ een **Naam koppeling**, zoals "Klaviyo webshop", en plak je sleutel in **Private API key**. De sleutel is verborgen terwijl je typt.
  </Step>

  <Step title="Kies de gebeurtenissen">
    Vink de gebeurtenissen aan die Klaviyo moet ontvangen, of klik op **Alles selecteren**. Zie de lijst hieronder.
  </Step>

  <Step title="Klik op Koppelen">
    Je ziet **Integratie gekoppeld** en Klaviyo staat op het tabblad **Gekoppeld**.
  </Step>
</Steps>

<Frame caption="De Klaviyo-kaart in de catalogus">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-klaviyo/01-catalog-card-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=5fa3fdd7b0894ca7c863aced80c86050" alt="Catalogus met de Klaviyo-kaart en de knoppen Gebruiken in automatiseringen, Meer lezen en Koppelen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-klaviyo/01-catalog-card-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-klaviyo/01-catalog-card-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=1b7944456adbbf08289c85c266d74150" alt="Catalogus met de Klaviyo-kaart en de knoppen Gebruiken in automatiseringen, Meer lezen en Koppelen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-klaviyo/01-catalog-card-dark.png" />
</Frame>

<Frame caption="Klaviyo koppelen: een naam, de Private API key en de gebeurtenissen">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-klaviyo/02-connect-modal-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=7827b03eca3d0c7018efb42eb6e3beab" alt="Koppelvenster voor Klaviyo met een naam voor de koppeling, het veld Private API key en selectievakjes voor gebeurtenissen" className="block dark:hidden" width="2880" height="2800" data-path="images/nl/how-to/connect-klaviyo/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-klaviyo/02-connect-modal-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=6c1df14152e21d31e477367a3341ba9b" alt="Koppelvenster voor Klaviyo met een naam voor de koppeling, het veld Private API key en selectievakjes voor gebeurtenissen" className="hidden dark:block" width="2880" height="2800" data-path="images/nl/how-to/connect-klaviyo/02-connect-modal-dark.png" />
</Frame>

| Veld | Verplicht | Wat je invult |
| - | - | - |
| **Naam koppeling** | Ja | Een naam die je herkent, maximaal 100 tekens. |
| **Private API key** | Ja | De private sleutel van Klaviyo. Zippendo slaat hem versleuteld op en toont hem nooit meer. |

## Gebeurtenissen die Klaviyo kan ontvangen

| Selectievakje | Verstuurd wanneer |
| - | - |
| **Zending aangemaakt** | Een zending wordt aangemaakt |
| **Zending verzonden** | Een zending wordt naar de vervoerder verzonden en heeft zijn verzendlabel |
| **Zending geannuleerd** | Een zending wordt geannuleerd of verwijderd |
| **Bestelling aangemaakt** | Er komt een nieuwe bestelling binnen |
| **Bestelling bijgewerkt** | Een bestelling verandert |
| **Track & trace bijgewerkt** | De vervoerder meldt een nieuwe trackingscan |

In Klaviyo verschijnt elke gebeurtenis als een metric, zoals "Shipment created" of "Tracking updated". **Zending verzonden** komt aan als "Shipment Dispatched". Klaviyo legt elke gebeurtenis vast onder een profiel, op basis van het e-mailadres of telefoonnummer van de klant.

Om een gebeurtenis een andere metricnaam te geven, verstuur je hem vanuit een automatisering en vul je **Eigen gebeurtenisnaam** in (zie hieronder). Het koppelvenster heeft er geen veld voor.

## Controleer de koppeling

Klik op het papieren vliegtuigje in de rij van de koppeling (**Testgebeurtenis verzenden**) en open dan het afleverlog (het stekkerpictogram). Een testgebeurtenis bevat geen klant, dus Klaviyo kan hem weigeren, ook als je sleutel juist is. Toont de rij 401 of 403, dan heeft Klaviyo de sleutel geweigerd: maak een nieuwe aan en plak die in. De zekerste controle is een echte gebeurtenis: verzend een zending en zoek een groen vinkje.

<Frame caption="Een Klaviyo-koppeling op het tabblad Gekoppeld">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-klaviyo/03-connected-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=d5029b5a334ee9c99947f502e686b57e" alt="Tabblad Gekoppeld met een Klaviyo-koppeling en de pictogrammen voor testen, afleverlog, bewerken en verwijderen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-klaviyo/03-connected-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-klaviyo/03-connected-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=be98864da58e48f79afb1130c59c3912" alt="Tabblad Gekoppeld met een Klaviyo-koppeling en de pictogrammen voor testen, afleverlog, bewerken en verwijderen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-klaviyo/03-connected-dark.png" />
</Frame>

<Frame caption="Het afleverlog voor de eerste gebeurtenis">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-klaviyo/05-delivery-log-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=cc391dd76dd810ceaf34ff31f235586f" alt="Venster met het afleverlog van een Klaviyo-koppeling met de tekst Nog geen afleveringen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-klaviyo/05-delivery-log-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-klaviyo/05-delivery-log-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=c0db5c107b5bb43a480c757b9980e50b" alt="Venster met het afleverlog van een Klaviyo-koppeling met de tekst Nog geen afleveringen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-klaviyo/05-delivery-log-dark.png" />
</Frame>

## De sleutel wijzigen of ontkoppelen

Klik op het schuifregelaarpictogram om **Je koppeling met Klaviyo bewerken** te openen. Laat **Private API key** leeg om de opgeslagen sleutel te behouden, of plak een nieuwe sleutel om hem te vervangen. Klik op **Wijzigingen opslaan**.

<Frame caption="Een Klaviyo-koppeling bewerken">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-klaviyo/04-edit-modal-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=f34967e4817b9291db27831d22551b3e" alt="Bewerkvenster voor een Klaviyo-koppeling met de naam van de koppeling, een leeg sleutelveld en de gebeurtenissen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-klaviyo/04-edit-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-klaviyo/04-edit-modal-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=43e3621b41f7f257321cbbf7edcbf4ea" alt="Bewerkvenster voor een Klaviyo-koppeling met de naam van de koppeling, een leeg sleutelveld en de gebeurtenissen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-klaviyo/04-edit-modal-dark.png" />
</Frame>

Om te ontkoppelen klik je op de prullenbak, typ je DELETE en klik je op **Ontkoppelen**. Dit stopt alle gebeurtenissen naar Klaviyo en verwijdert het afleverlog.

<Frame caption="Typ DELETE om te ontkoppelen">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-klaviyo/06-disconnect-modal-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=e45ceb9af2be035c7c5a97f94f9ac684" alt="Venster Integratie ontkoppelen dat vraagt om DELETE te typen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-klaviyo/06-disconnect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-klaviyo/06-disconnect-modal-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=f4bb337ceb62592bcc84c73a59362daf" alt="Venster Integratie ontkoppelen dat vraagt om DELETE te typen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-klaviyo/06-disconnect-modal-dark.png" />
</Frame>

## Klaviyo gebruiken in een automatisering

Voeg in **Automatiseringen** de stap **Klaviyo-gebeurtenis verzenden** toe. Die stuurt de gebeurtenis die de automatisering heeft gestart naar Klaviyo, maar alleen als je voorwaarden overeenkomen.

| Veld | Verplicht | Wat het doet |
| - | - | - |
| **Koppeling** | Ja | Kies je Klaviyo-koppeling uit de lijst. Zonder koppeling zie je **Koppeling is verplicht**. |
| **Eigen gebeurtenisnaam** | Nee | De metricnaam die Klaviyo toont in plaats van de standaardnaam, zoals "Parcel on its way". |
| **Eigen eigenschappen** | Nee | Klik op **Toevoegen** om extra gegevens met de gebeurtenis mee te sturen, zoals de referentie van de zending. |

Zie [Automatiseringen](/docs/nl/how-to/automations) om de rest van de automatisering te bouwen.

## Gerelateerd

* [Een integratie koppelen](/docs/nl/how-to/connect-an-integration) - testen, afleverlog, bewerken en ontkoppelen voor elke app
* [Klaviyo](/docs/nl/integrations/klaviyo) - de uitgebreidere handleiding
* [Problemen met integraties oplossen](/docs/nl/integrations/troubleshooting)
* [Automatiseringen](/docs/nl/how-to/automations)
* [Een vervoerder of integratie koppelen](/docs/nl/how-to/connect-index)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.