---
title: "Aan de slag met Magento 2.x (CE en EE)"
description: "Leer hoe je Klaviyo kunt integreren met je Magento 2 CE- of EE-webshop. Je moet de Klaviyo-extensie installeren in Magento, de extensie configureren en OAuth instellen, en dan de integraties inschakelen in Klaviyo. Deze gids behandelt alle vereiste integraties-stappen, evenals hoe je kunt bevestigen dat je synchronisatie met historische gegevens is gelukt."
canonical_url: "https://help.klaviyo.com/hc/nl-nl/articles/115005254348"
markdown_url: "https://help.klaviyo.com/hc/nl-nl/articles/115005254348.md"
locale: "nl-nl"
category: "Integraties"
section: "Magento 2"
updated: "2026-02-25"
---

# Aan de slag met Magento 2.x (CE en EE)

## Wat je leert

Leer hoe je Klaviyo integreert met je Magento 2 CE- of EE-store. Je moet de Klaviyo-extensie in Magento installeren, de extensie configureren en OAuth instellen. Daarna schakel je de integratie in Klaviyo in. Deze handleiding behandelt alle vereiste integratiestappen en laat ook zien hoe je bevestigt dat de synchronisatie van je historische gegevens is geslaagd. 

## Voordat je van start gaat

**📝 Note:** Houd er rekening mee dat Magento 2-versies lager dan 2.4.0 niet worden ondersteund.

Om ervoor te zorgen dat Klaviyo de nodige API-aanroepen voor integraties kan doen, moet je Magento 2-server een openbaar toegankelijke hostnaam hebben. Lokaal gehoste Magento 2-servers kunnen niet volledig integreren met Klaviyo.

Het wordt sterk aanbevolen om IP's van Klaviyo toe te voegen aan de positieve lijst van je firewallprovider om problemen met verificatie en configuratie te minimaliseren. Ga voor meer informatie naar [Hoe IP-adressen van Klaviyo-integratieverkeer op de positieve lijst zetten](https://help.klaviyo.com/hc/nl-nl/articles/19143781289115.md).

Installeer de Magento 2-extensie van Klaviyo via Composer. Houd er rekening mee dat voor installatie via Composer een IT-beheerder met SSH-toegang nodig is tot de server waarop Magento 2 wordt gehost. 

## Installeer de Klaviyo-extensie in Magento 2.

🎬 [Watch video on Wistia](https://klaviyo.wistia.com/medias/yc7dejd9jw)

1. Log in op je Magento 2-server en ga vanuit de opdrachtprompt naar de hoofddirectory van je Magento-app. Deze gids toont voorbeelduitvoer voor Terminal, maar deze stappen kunnen worden aangepast voor elke opdrachtregeltool van je keuze.

2. Voer de volgende opdracht uit om toegang te krijgen tot de nieuwste versie van de Klaviyo-extensie via Packagist. Packagist is een repository voor PHP-codelibraries waarmee je eenvoudig de nieuwste versie van de extensie kunt installeren.
`composer require klaviyo/magento2-extension`

3. Voer de volgende opdracht uit om de Klaviyo-extensie die je net hebt gedownload in te schakelen:
`php bin/magento module:enable Klaviyo_Reclaim  --clear-static-content`



![composer2.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c0b9b103e993b26b8c180dcc16438a8e6077f53e-1566x262.png?auto=format)

4. Zoals in de voorbeeldoutput wordt weergegeven, moet je nu eventuele extra modules inschakelen. Voer de volgende opdracht uit om ze in te schakelen:
`php bin/magento setup:upgrade`

5. Scan de output op `Module 'Klaviyo_Reclaim'` om te bevestigen dat de Klaviyo-module is ingeschakeld en wordt uitgevoerd.

6. Om ervoor te zorgen dat de CSS en JS op je Magento 2-store goed blijven werken, moet je een opdracht voor het implementeren van statische content uitvoeren.
`php bin/magento setup:static-content:deploy -f`



![composer3.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/102ed3a25f541567742413f296e80f9fc791d02a-1562x264.png?auto=format)

7. Je kunt nu terugkeren naar het Magento-beheerdashboard vanuit je browser.



Installatie via Composer is voltooid! Ga naar het volgende gedeelte voor configuratie-instructies.

## De Klaviyo-extensie configureren

### Instructievideo

🎬 [Watch video on Wistia](https://klaviyo.wistia.com/medias/m7vqtc4psz)

1. Navigeer in je Klaviyo-account naar het tabblad [API-sleutels](https://www.klaviyo.com/settings/account/api-keys).

2. Ga in een nieuw tabblad naar je Magento-webshopbeheer.

3. **Klik** onder Instellingen op *Webshops*  **> Configuratie.**

4. Klik in het dropdownmenu van Klaviyo op Algemeen.

5. Stel **Klaviyo-extensie inschakelen** in op **Ja**.

6. Kopieer je publieke Klaviyo API-sleutel (site-ID) van het tabblad API-sleutels en plak deze in het bijbehorende vak in Magento.

7. Maak op het tabblad API-sleutels van Klaviyo [een nieuwe private API-sleutel](https://help.klaviyo.com/hc/nl-nl/articles/7423954176283.md) aan en kopieer deze in het bijbehorende vak in Magento. Door je te authenticeren met je private API-sleutel kun je nieuwsbriefabonnementen synchroniseren van Magento naar Klaviyo.



In het volgende gedeelte stel je OAuth in, waarmee andere aspecten van de integraties worden ingeschakeld.

![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/b6c04a8983befb3b4de367ec9f1043a954b73e09-1560x698.png?auto=format)

### OAuth instellen

Vervolgens schakel je OAuth-verificatie in om je Klaviyo-account veilig te verbinden met de Magento 2-extensie. 

1. Ga naar het **tabblad OAuth** instellen in Magento.

2. Geef je integratie een naam die je gemakkelijk kunt onthouden, want je moet de naam later terugvinden.

3. Klik **op Save Config** om verder te gaan.




![OAUTHtab.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/43febae7f999918b764c73d3375b6a79fa32e513-1926x614.png?auto=format)

4. Zoek **Systeem** in het linkernavigatiepaneel en selecteer **integraties** in het  systeemvak.

5. Zoek de naam van je integraties en **klik** op Activeren. Het activeren van de integraties opent een venster waarin je wordt gevraagd de toegang goed te keuren.




![activateoauth.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/0742e1a5f6f5de9b7312177c2c9ff49996a513d1-1892x312.png?auto=format)

6.  Klik op Toestaan om te worden doorgestuurd naar Klaviyo, waar je het instellen van de integraties voltooit.




![oauthperms.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/dfed353d025ccc34ae79aa263fd80a93b084a244-2518x842.png?auto=format)

7. Log in bij Klaviyo als daarom wordt gevraagd, of bevestig dat je accountnaam correct is en klik op **Integreren.** Dit voegt Magento 2 integraties toe aan het Klaviyo-account dat is gekoppeld aan de API-sleutel die je voor het instellen hebt gebruikt. Als je bent ingelogd op meerdere Klaviyo-accounts en het juiste account niet wordt weergegeven, log dan uit bij alle andere sessies.




![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/9e556b43ab190092403ac9d6fa0262cbbbd45d67-1106x492.png?auto=format)

Als het venster automatisch wordt gesloten, is de verbinding tot stand gebracht. Je kunt het succes ook bevestigen door je Klaviyo-account in een nieuw browsertabblad of nieuw venster te openen, het tabblad **integraties** te selecteren en Magento 2 in de lijst te zoeken.

Als je de foutmelding "Klaviyo-account komt niet overeen met bedrijfs-ID" ziet, controleer dan of de API-sleutels die je in Magento hebt ingevoerd bij het Klaviyo-account horen waar je momenteel bij bent ingelogd en probeer het daarna opnieuw.

![apierror.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/3a8c5fe6e74f9c85769e0732311851549af7fc97-1400x458.png?auto=format)

Als je bij het tot stand brengen van de verbinding tussen Magento en Klaviyo in plaats daarvan een lijst met fouten ontvangt, kun je op elke fout klikken om meer over de oorzaak te weten te komen.

![oauthgenerror.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c83829dcbc34ed3b6d90f4d8245da142cb7b5b71-1450x850.png?auto=format)

### Lijst voor nieuwsbrieven instellen

Vervolgens selecteer je een Klaviyo-lijst om je nieuwsbriefabonnee mee te synchroniseren. Je hebt ook de optie om toestemmingsinstellingen van Klaviyo of Magento 2-toestemmingsinstellingen te gebruiken voor de door jou gekozen lijst.

1. Klik in Magento op Nieuwsbrief.

2. Selecteer in het dropdownmenu de Klaviyo-lijst waarmee je je Magento-aanmeldingsformulier wilt synchroniseren.

3. Klik **op Configuratie** opslaan.



![newsletterm2.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/a12fc2f088bd9e1c1357c0c460fe24d435f497b8-2598x1040.png?auto=format)

### Toestemming bij afrekenen inschakelen

Je kunt bij het afrekenen toestemming verzamelen voor e-mail en voor mobiele kanalen (sms, WhatsApp of allebei).

Houd er rekening mee dat als je toestemming bij het afrekenen inschakelt, je ook webhook moet inschakelen (zie hieronder) om toestemming bij het afrekenen goed te laten functioneren. 

1. Ga op de *configuratiepagina* onder *Klaviyo* **naar Toestemming bij** het afrekenen.




![m2cac-new.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c64fbdf2d6bdac7f722908c4a387d2e0778cc0fa-2070x736.png?auto=format)

2. Je ziet een sectie voor het verzamelen van toestemming voor e-mail en mobiel (sms/WhatsApp). Deze twee worden afzonderlijk behandeld, zodat je alleen e-mail, alleen sms/WhatsApp of beide kunt verzamelen. Als je zowel sms/WhatsApp als e-mailabonnees verzamelt, kies dan een andere lijst voor sms/WhatsApp dan voor e-mail. Dit zorgt ervoor dat toestemming altijd op juiste wijze aan het juiste kanaal wordt toegekend.

   - Toestemming wordt niet gesynchroniseerd (voor e-mail en sms/WhatsApp) totdat de klant klaar is met het plaatsen van de bestelling en, indien van toepassing, het abonnement bevestigd is vanwege dubbele toestemming.

   - Houd er rekening mee dat voor gebruikers die al zijn ingelogd bij je Magento 2-webshop, het selectievakje voor e-mailtoestemming niet standaard verschijnt bij het afrekenen.

3. Selecteer onder *E-mail* **Ja** voor *Contactpersonen aanmelden voor e-mailmarketing bij het* afrekenen.

4. Selecteer een e-maillijst om op te synchroniseren, zoals een nieuwsbrief.

5. Voer de tekst van het selectievakje voor toestemming voor e-mail in die je wilt gebruiken.




![2021-03-24_13-00-56.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/15ee0f77e8e9eb576484dcd38981c420d8905384-1424x612.png?auto=format)

6. Selecteer onder  **Mobiel Ja** voor *het verzamelen van tekstberichten en WhatsApp-abonnee.*

7. Kies de lijst waarmee je je sms-/WhatsApp-contacten wilt synchroniseren. Bekijk voor meer informatie over deze instellingen onze handleiding voor [het verzamelen van sms- en/of WhatsApp-toestemming bij het afrekenen](https://help.klaviyo.com/hc/nl-nl/articles/360058698511.md).




![Een pagina met mobiele instellingen voor het verzamelen van toestemming voor tekstberichten en WhatsApp, met opties voor kanaal, abonneelijsten en toestemmingstekst.](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/179c6fdbf1d9f96b559e1a2a1a1f282dea85126b-946x978.png?auto=format)

8. Met sorteervolgorde kun je de plaatsing van de toestemmingsvelden voor e-mail en sms wijzigen. Standaard verschijnen deze vakken onder respectievelijk het eerste veld voor het invoeren van e-mail en telefoonnummer voor bezorging. Zo hoef je de sorteervolgorde niet te wijzigen als je de afrekenpagina niet opnieuw hebt gerangschikt. Als je de indeling hebt gewijzigd, pas dan de sorteervolgorde dienovereenkomstig aan.

9. Als je klaar bent, klik je rechtsboven **op Configuratie opslaan.**



### Webhook inschakelen

**📝 Note:** Vervolgens schakel je Klaviyo webhook in in je Magento 2-account. Houd er rekening mee dat het inschakelen van webhook vereist is om toestemming bij het afrekenen correct te laten functioneren.

1. Ga vanuit het beheerdersdashboard naar **Webshops > Configuratie.**

2. **Klik** op Klaviyo en selecteer het tabblad **webhook.**

3. Maak een webhookgeheim en voer dit in in het bijbehorende veld **Geheim webhook.** Het webhookgeheim is een sleutel die Klaviyo gebruikt voor validatie. Dit geheim kan van alles zijn, maar we raden je aan om een veilige reeks letters en cijfers te maken. Magento verbergt om veiligheidsredenen het geheim van je webhook met sterretjes, dus zorg ervoor dat je het correct invoert.

Als je een multi-store integraties gebruikt, moet het webhookgeheim in dit veld worden ingevoerd in je standaardconfiguratie en wordt hetzelfde geheim gebruikt als validatie voor elke webshopconfiguratie. Het webhook-geheim moet alleen worden toegevoegd aan de standaardconfiguratie en mag niet per webshop worden toegevoegd.



![m2webhooktab.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/bd7ba0d0018c75d8d27d5e6a6a6df87ee174c8b8-2610x1084.png?auto=format)

4. Selecteer naast de webhooks die je wilt inschakelen **Ja** in het dropdownmenu. Wil je meer lezen over de webhooks die door Klaviyo worden ondersteund, bekijk dan onze [gids voor webhooks voor Magento 2](https://help.klaviyo.com/hc/nl-nl/articles/360055336451.md).

5. Klik **op Configuratie** opslaan.



## Zet Magento 2 integraties aan in Klaviyo

### Instructievideo

🎬 [Watch video on Wistia](https://klaviyo.wistia.com/medias/evlfi7fbya)

1. Open Klaviyo, selecteer dan **integraties** in de linkernavigatie. Zoek Magento 2 in de lijst en selecteer deze.

2. Op de volgende pagina kun je ervoor kiezen om Magento 2-klanten toe te voegen aan een Klaviyo-lijst. Selecteer **Nieuwe Magento 2-klanten toevoegen aan een Klaviyo-lijst** en selecteer een lijst in de dropdown. Door een klant toe te voegen aan een lijst, wordt er op zichzelf geen marketingtoestemming verleend. Gebruik de instellingen voor nieuwsbrief- en checkouttoestemming in Magento om die toestemming te verzamelen.

Bestaande klantprofielen zijn opgenomen in de synchronisatie van historische gegevens. Volg de handleiding voor [bestaande Magento 2-abonnees uploaden naar een Klaviyo-lijst](https://help.klaviyo.com/hc/nl-nl/articles/115005082407.md) om bestaande nieuwsbriefabonnees te uploaden vanuit een CSV.



![Instellingenpagina voor Magento 2 en Klaviyo integraties met opties voor gegevenssynchronisatie, winkelweergaven en geavanceerde functies.](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c03434d8b88d70812b062012c3e31ec7bf1715c7-686x983.png?auto=format)

3. Selecteer vervolgens welke winkelweergaven uit Magento 2 je wilt synchroniseren met Klaviyo. Alle winkelweergaven worden standaard gesynchroniseerd met Klaviyo. Met deze instelling kun je kiezen met welke winkels je integreert. Als je Multi-Source Inventory (MSI) in Magento 2 gebruikt, selecteer je *Specifieke Magento 2-winkelweergaven* en selecteer je de winkels die je wilt synchroniseren om je voorraad correct weergegeven te zien in Klaviyo.

4. Configureer onder **Geavanceerd** de volgende instellingen naar behoefte:

   - **Speciale prijsinstellingen**
Deze instelling verwijst naar een speciale aanbiedingsprijs voor items die optioneel kan gelden binnen een bepaalde datumbereik. Schakel dit in vóór je eerste catalogussync als je van plan bent speciale prijzen te gebruiken. Als je dit later inschakelt, [sync je catalogus opnieuw](#h_01JYSCX35A6AA1XSG38E9YDBQ2) om bestaande producten te vernieuwen. Wanneer je **Speciale prijs gebruiken voor productprijzen wanneer van toepassing** inschakelt, wordt in het productblok de speciale prijs weergegeven wanneer van toepassing. Bij gebruik van een dynamische productfeed wordt de speciale prijs ingevuld op het verzendmoment. Wanneer je items handmatig selecteert uit je catalogus, wordt de speciale prijs ingevuld zodra je het/de product(en) selecteert. Voor elk product worden er 4 metagegevensvelden gesynchroniseerd:

     - **prijs**
(verplicht, zwevend) De standaardprijs van het artikel.

     - **special_prijs**
(optioneel, zwevend) Dit is een speciale uitverkoopprijs voor het artikel. Wanneer deze prijs van kracht is, zie je deze speciale_prijs naast een doorgestreepte prijs.

     - **special_from_date** 
(optioneel, datum) Dit specificeert een begindatum voor het van kracht worden van speciale_prijs.

     - **speciale_prijs** 
(optioneel, datum) Dit specificeert een einddatum voor speciale_prijs die van kracht is.

   - **Media-root-URL**
Als je het standaardpad voor je websiteafbeeldingen wilt wijzigen, selecteer je **Media-root-URL wijzigen** en voer je je media-root-URL in. Gebruik deze instelling als je afbeeldingen worden gehost op een andere URL dan je website. 

   - **Synchronisatie beperken tot recente bestellingen**
Periodieke synchronisaties van bestellingen halen bestellingen op die sinds de vorige synchronisatie zijn bijgewerkt. Als je deze synchronisaties wilt beperken op basis van wanneer bestellingen zijn aangemaakt, selecteer je **Synchronisatie beperken tot recente bestellingen** en kies je een tijdsvenster in de dropdown. Alleen bijgewerkte bestellingen die binnen dat tijdvenster zijn aangemaakt, worden opgenomen in periodieke bestelsynchronisaties. Dit helpt voorkomen dat oudere bestellingen na kleine updates opnieuw worden opgehaald. Alle bestellingen die vóór het geselecteerde venster zijn aangemaakt, worden echter uitgesloten, zelfs als ze belangrijke updates hebben. Deze instelling heeft geen invloed op je initiële synchronisatie van historische gegevens.

5. Klik op **Installatie afronden**.



Je Magento 2-integratie is nu ingeschakeld en de synchronisatie van je historische gegevens is gestart.

Nadat de initiële synchronisatie van historische gegevens voltooid is, wordt Magento 2 integraties elke 30 minuten gesynchroniseerd.

### Bevestig de synchronisatie van je historische gegevens

1. Selecteer in Klaviyo **integraties** en open daarna je Magento 2-integratie.

2. Selecteer het tabblad **Gegevens**.

3. Controleer de sectie **historische gegevens**. Terwijl de import wordt uitgevoerd, zie je de synchronisatievoortgang. Wanneer de import is voltooid, bevestigt de sectie dat je historische bestellingen, klanten en producten zijn gesynchroniseerd en wordt er een datum voor **Laatst gesynchroniseerd op** weergegeven.



## Gegevens die zijn gesynchroniseerd met Magento 2 integraties

Magento 2 integraties van Klaviyo haalt belangrijke klantinformatie uit je Magento-platform.

Hier zijn enkele gegevens die we vanuit Magento synchroniseren:

- Klantgegevens, waaronder voornaam, achternaam en locatie.

- Verkoop- en bestelgegevens, waaronder welke artikelen zijn gekocht, afbeeldingen van artikelen, artikelcategorieën en eventuele toegepaste kortingen.

- Gegevens over afhandeling, terugbetaling en geannuleerde bestelling.

- Wanneer mensen je website bezoeken en welke items ze bekijken; webtracking wordt afgehandeld door de extensie.



Ga voor meer informatie naar onze [Magento 2-datareferentie](https://help.klaviyo.com/hc/nl-nl/articles/115003458852.md). 

## Magento-bestellingswaarden converteren naar een enkele valuta

Klaviyo ondersteunt de conversie van alle vreemde valuta in Magento naar één primaire valuta in Klaviyo. Neem contact op met [Support](https://help.klaviyo.com/hc/nl-nl/articles/115001002272.md) om deze functies in te schakelen. Dit is vooral handig als je meerdere winkels hebt met transacties in verschillende valuta.

Als deze functies is ingeschakeld:

- De conversie vindt plaats wanneer Magento bestelgegevens synchroniseert met Klaviyo. 

- Klaviyo controleert of de *order_valuta_code* hetzelfde is als de ingestelde global_currency_code. Zo niet, dan rekent Klaviyo het bestellingstotaal om van de bestelvaluta naar de opgegeven wereldwijde valuta om ervoor te zorgen dat je financiële analyses nauwkeurig zijn. Houd er rekening mee dat regelartikelen van bestellingen in de valutacode van de bestelling blijven staan en niet worden geconverteerd. 



## Je extensie upgraden

Om je Klaviyo Magento 2-extensie te upgraden, herhaal je de stappen in [De Klaviyo-extensie installeren in Magento 2](#h_01HGGJNFJT8CTEQ8PVGDVNB6GB) hierboven, inclusief de Magento-upgrade- en statische-content-deploymentopdrachten. Met deze stappen vervang je je huidige extensieversie. Je hoeft de extensie niet opnieuw te configureren of de integratie in Klaviyo opnieuw in te schakelen.

## Je catalogus opnieuw synchroniseren

Je kunt op elk moment een volledige historische hernieuwde synchronisatie van je Magento 2-catalogus starten. Door je catalogus opnieuw te synchroniseren, kun je profiteren van Klaviyo-updates voor voorraad- en variatiegerelateerde functies. Synchroniseer je catalogus opnieuw nadat je de synchronisatie-instellingen van de catalogus hebt gewijzigd, zodat die wijzigingen worden toegepast op bestaande producten.

Je catalogus opnieuw synchroniseren:

1. Selecteer in Klaviyo het tabblad **Integraties**.

2. Selecteer je Magento 2 integraties in de lijst.

3. Klik op het tabblad **Gegevens**.

4. Klik onder **Catalogusgegevens synchroniseren** op **Opnieuw synchroniseren**.





![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/53b866961db9078dc95f5a9b82cf77b8460cef17-1318x214.png?auto=format)

Bekijk **Synchronisatievoortgang** in dezelfde sectie terwijl de resynchronisatie wordt uitgevoerd. Wanneer dit is voltooid, toont de sectie een datum **Laatst gesynchroniseerd op**.

## Extra hulpbronnen

- [Magento 2-datareferentie](https://help.klaviyo.com/hc/nl-nl/articles/115003458852.md)
  Ontdek welke gegevens Klaviyo uit je Magento 2-winkel importeert wanneer je de twee platforms integreert. Klaviyo's integratie met Magento 2 haalt alle historische gegevens uit je Magento 2-winkel op met de eerste historische synchronisatie. Zodra de integraties zijn ingeschakeld, begint de integratie ook elke 30 minuten bestel- en klantgegevens te synchroniseren. Voorbeelden van deze gegevens zijn de informatie die gekoppeld is aan eerder geplaatste bestellingen, afgehandelde bestellingen, enz.
- [Klaviyo Community: Magento 2 "Ask Me Anything" Question and Answer Video](https://community.klaviyo.com/integrations-39/ama-magento2-updated-with-video-response-5450)
