Problemen met je WooCommerce-integratie oplossen

Wat je leert

Lees hoe je problemen met de installatie van je WooCommerce-integratie kunt oplossen door het relevante probleemoplossingsscenario hieronder te volgen. Als je problemen ondervindt die niet in deze lijst staan, neem dan contact op via de Community of met ons supportteam.

Voordat je van start gaat

Als je dit nog niet hebt gedaan, lees dan onze gids over Aan de slag met WooCommerce voor stapsgewijze instructies over integreren. Als je je plug-in wilt upgraden, bekijk dan ons artikel over hoe je je WooCommerce-plug-in kunt upgraden.

Scenario's voor probleemoplossing

Raadpleeg de volgende scenario’s op basis van de foutmelding die je in de app ontvangt om je probleem op te lossen.

"Om verstoringen in de functionaliteit te voorkomen, moet je mogelijk de volgende plug-ins uitschakelen: Naam/namen van plug-in(s)"

Als je actieve cachingplug-ins of omleidingsplug-ins in WordPress hebt, kunnen die de integratie met Klaviyo verstoren en verbindingsproblemen veroorzaken. We raden aan om deze plug-ins uit te schakelen tijdens het instellen van het integratieproces.

"We kunnen je installatie niet voltooien"

Deze melding betekent dat je firewall de verzoeken van Klaviyo blokkeert, dat je Bot Fight Mode hebt ingeschakeld in Cloudflare, of allebei.

Om dit op te lossen, raden we aan om zowel Klaviyo-integratieverkeer toe te staan als Bot Fight Mode uit te schakelen (als je dit hebt ingeschakeld).

1. Lees hoe je IP-adressen van Klaviyo-integratieverkeer op de positieve lijst zet.
2. Bot Fight Mode uitschakelen in Cloudflare:
   1. Log in op het Cloudflare-dashboard.
   2. Selecteer je account en domein.
   3. Ga naar Beveiliging > Bots.
   4. Selecteer bij Bot Fight Mode Uit.

"Zorg dat je WooCommerce-winkel https heeft en dat SSL is ingeschakeld"

Klaviyo verwacht dat je winkel-URL voldoet aan HTTPS-protocollen, wat betekent dat de website een geldig SSL-certificaat heeft. Als je website HTTP gebruikt in plaats van HTTPS, kun je tegen problemen aanlopen.

Je kunt controleren of je SSL-certificaat geldig is via SSL Server Test (Powered by Qualys SSL Labs).

Klaviyo vereist dat de tests slagen met een A-beoordeling.

"Geen toegang mogelijk tot API met opgegeven referenties"

Je kunt deze fout ontvangen als je aanpassingen hebt ingesteld om API-toegang voor niet-ingelogde gebruikers te voorkomen. Meestal is dit een functie in het functions.php -bestand van WordPress, die een reactie met statuscode 401 triggert.

Als je zo'n aanpassing hebt, verwijder deze dan of zet er commentaartekens voor om de fout te verhelpen. Bekijk voor meer informatie over deze fout de veelgestelde vragen over de WooCommerce REST API.

"Geen toegang tot de API voor bestellingen, controleer de verbindingsinstellingen en probeer het opnieuw"

Deze fout betekent dat wanneer Klaviyo de WooCommerce-integraties probeert te valideren en een orderaantal op te halen, hun API geen waarde retourneert die Klaviyo verwacht of helemaal niets retourneert.

Omdat de integraties nog niet officieel is gekoppeld aan Klaviyo, betekent dit dat dit in WooCommerce moet worden opgelost.

Voor meer informatie over deze fout moet je een API-call doen naar het eindpunt voor het aantal bestellingen, wat meer inzichten geeft in wat er naar Klaviyo wordt doorgestuurd. Hier is een voorbeeld van een cURL-aanvraag. Om dit te gebruiken, vul je je winkel-URL, consumer key en consumer secret in:

curl https://STORE_URL/wp-json/wc/v3/orders \
-u CONSUMER_KEY:CONSUMER_SECRET

"Je Klaviyo-plug-in is verouderd"

Af en toe wordt de webhook vertraagd voordat deze Klaviyo bereikt, waardoor je tijdelijk de oude instellingenpagina ziet. Dit zou na een paar minuten vanzelf opgelost moeten zijn.

404 bij het verbinden met Klaviyo vanuit WordPress

Om dit op te lossen, moet je controleren of je permalinks hebt ingeschakeld voor je WordPress-site. WooCommerce-authenticatie werkt niet, tenzij permalinks zijn ingeschakeld.

1. Navigeer naar je WordPress-site en ga naar Instellingen > Permanente links.
2. Kies onder Algemene instellingen elke linkstructuur behalve Gewoon.
3. Bevestig door op Wijzigingen opslaan te klikken.
   

4. Als je klaar bent, integreer je opnieuw met Klaviyo.

Installatie mislukt - we konden je extensie niet installeren

Je kunt een foutmelding "Installatie mislukt" tegenkomen als je probeert de integratie te installeren via de WooCommerce-marktplaats.

In het geval dat u niet in staat bent om succesvol te installeren vanuit de WooCommerce marktplaats, kunt u ook de plug-in installeren vanuit uw WordPress-plug-in-beheerder.

1. Ga naar je WordPress-beheer en ga naar Plug-ins.
2. Selecteer Plug-in toevoegen.
3. Zoek naar Klaviyo in Plug-ins zoeken.
4. Selecteer Nu installeren.
5. Selecteer Activeren.
6. Selecteer Marketing in de navigatie aan de linkerkant en klik vervolgens op Klaviyo.
7. Klik op Account koppelen om te beginnen en ga daarna verder naar De WooCommerce-integratie inschakelen in het artikel Aan de slag met WooCommerce.