Vous apprendrez
Apprenez à résoudre les problèmes liés à l'intégration de WooCommerce en suivant le scénario de dépannage décrit ci-dessous. Si vous rencontrez des problèmes qui ne figurent pas dans cette liste, veuillez vous adresser à la Communauté ou à notre équipe d'assistance.
Avant de commencerAvant de commencer
Si vous ne l'avez pas encore fait, lisez notre guide sur les débuts avec WooCommerce pour obtenir des instructions étape par étape sur l'intégration. Si vous souhaitez mettre à jour votre plugin, consultez notre article, Comment mettre à jour votre plugin WooCommerce.
Scénarios de dépannageScénarios de dépannage
Consultez les scénarios suivants en fonction du message d'erreur reçu dans l'application pour résoudre votre problème.
Veuillez noter que si vous choisissez de supprimer votre intégration et de la réintégrer ensuite, vos données WooCommerce ne seront pas supprimées de Klaviyo.
"Pour éviter toute perturbation des fonctionnalités, il se peut que vous deviez désactiver les plugins suivants : Nom du (des) plugin(s)"
Si vous avez des plugins de cache ou de redirection actifs dans WordPress, ils peuvent interférer avec l'intégration de Klaviyo et causer des problèmes de connexion. Nous vous recommandons de désactiver ces plugins au cours de la procédure d'intégration.
"Nous ne pouvons pas terminer votre installation"
Ce message signifie que votre pare-feu bloque les requêtes de Klaviyo, que vous avez activé le mode "Bot Fight" dans Cloudflare, ou les deux.
Pour résoudre ce problème, nous vous recommandons d'autoriser le trafic d'intégration de Klaviyo et de désactiver le mode de lutte contre les robots (si vous l'avez activé).
- Apprenez comment autoriser les adresses IP du trafic de l'intégration Klaviyo.
- Pour désactiver le Bot Fight Mode dans Cloudflare :
- Connectez-vous au tableau de bord de Cloudflare.
- Sélectionnez votre compte et votre domaine.
- Allez à la page Sécurité > Bots.
- Pour le mode combat de robots, sélectionnez Désactivé.
"Assurez-vous que votre boutique WooCommerce dispose d'une connexion https et que le SSL est activé.
Klaviyo s'attend à ce que l'URL de votre boutique respecte les protocoles HTTPS, ce qui signifie que le site web dispose d'un certificat SSL valide. Si votre site web est en HTTP plutôt qu'en HTTPS, vous risquez de rencontrer des problèmes.
Vous pouvez vérifier si votre certificat SSL est valide sur SSL Server Test (Powered by Qualys SSL Labs).
Klaviyo exige que les tests soient réussis avec des notes A.
"Impossible d'accéder à l'API avec les informations d'identification fournies""Impossible d'accéder à l'API avec les informations d'identification fournies"
Vous pouvez recevoir cette erreur si vous avez mis en place des personnalisations pour empêcher l'accès à l'API pour les utilisateurs non connectés. Il s'agit généralement d'une fonction du fichier WordPress functions.php, qui déclenche une réponse de type code d'état 401.
Si vous avez une telle personnalisation, supprimez-la ou commentez-la pour éliminer l'erreur. Pour plus d'informations sur cette erreur, consultez la FAQ de l'API REST de WooCommerce.
"Impossible d'accéder à l'API des commandes, veuillez vérifier les paramètres de connexion et réessayer.""Impossible d'accéder à l'API des commandes, veuillez vérifier les paramètres de connexion et réessayer."
Cette erreur signifie que lorsque Klaviyo tente de valider l'intégration de WooCommerce et d'obtenir un nombre de commandes, l'API ne renvoie pas la valeur attendue par Klaviyo ou ne renvoie rien du tout.
Comme l'intégration n'a pas encore été officiellement connectée à Klaviyo, cela signifie que le problème doit être résolu dans WooCommerce.
Pour obtenir plus d'informations sur cette erreur, vous devez faire un appel API au point de terminaison du nombre de commandes, ce qui vous donnera plus d'informations sur ce qui est transmis à Klaviyo. Voici un exemple de requête cURL. Pour l'utiliser, indiquez l'URL de votre magasin, la clé du consommateur et le secret du consommateur :
curl https://STORE_URL/wp-json/wc/v3/orders \
-u CONSUMER_KEY:CONSUMER_SECRET
"Votre plugin Klaviyo est obsolète"
Il peut arriver que le webhook ne parvienne pas à Klaviyo dans les délais impartis, ce qui fait que vous voyez temporairement l'ancienne page de paramètres. Le problème devrait se résoudre après quelques minutes.
404 lors de la connexion à Klaviyo depuis WordPress404 lors de la connexion à Klaviyo depuis WordPress
Pour résoudre ce problème, vous devez vous assurer que les liens permanents sont activés sur votre site WordPress. L'authentification WooCommerce ne fonctionnera pas si les Permaliens ne sont pas activés.
- Naviguez sur votre site WordPress et allez dans Réglages > Permalinks.
- Sous Paramètres communs, choisissez une structure de lien autre que "simple".
- Confirmez en cliquant sur Enregistrer les modifications.
- Lorsque vous avez terminé, réintégrez Klaviyo.