Résoudre les problèmes liés à votre intégration WooCommerce

Objectif de cet article

Découvrez comment résoudre les problèmes liés à la configuration de votre intégration WooCommerce en suivant le scénario de dépannage pertinent décrit ci-dessous. Si vous rencontrez des problèmes qui ne figurent pas dans cette liste, veuillez contacter la Communauté ou notre équipe d’assistance.

Avant de commencer

Si vous ne l’avez pas encore fait, lisez notre guide sur Démarrer avec WooCommerce pour obtenir des instructions étape par étape sur l’intégration. Si vous souhaitez mettre à niveau votre plug-in, consultez notre article sur comment mettre à niveau votre plug-in WooCommerce.

Scénarios de résolution de problèmes

Consultez les scénarios suivants en fonction du message d’erreur reçu dans l’application afin de résoudre votre problème.

« Pour éviter des perturbations de fonctionnalités, vous devrez peut-être désactiver les plug-ins suivants : Nom(s) du plug-in»

Si vous avez des plug-ins de cache ou de redirection actifs dans WordPress, ils peuvent interférer avec l’intégration de Klaviyo et engendrer des problèmes de connexion. Nous vous recommandons de désactiver ces plug-ins lors de la procédure d’intégration.

« Nous ne pouvons pas terminer votre configuration »

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 à la fois d’autoriser le trafic des intégrations Klaviyo et de désactiver le mode Bot Fight (si vous l’avez activé).

1. Découvrez comment mettre sur liste d’autorisation les adresses IP du trafic d’intégration Klaviyo.
2. Pour désactiver le Bot Fight Mode dans Cloudflare :
   1. Connectez-vous au tableau de bord Cloudflare.
   2. Sélectionnez votre compte et votre domaine.
   3. Accédez à Sécurité > Bots.
   4. Pour Bot Fight Mode, sélectionnez Off.

« Assurez-vous que votre boutique WooCommerce dispose de https et que 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 la note A.

« Impossible d’accéder à l’API avec les identifiants fournis »

Vous pouvez recevoir cette erreur si des personnalisations sont en place pour empêcher l’accès à l’API pour les utilisateurs non connectés. En général, il s’agit d’une fonction dans le fichier WordPress functions.php, qui déclenche une réponse avec un code d’état 401.

Si vous avez une personnalisation de ce type, supprimez-la ou mettez-la en commentaire pour éliminer l’erreur. Pour en savoir plus sur cette erreur, consultez la FAQ de l’API REST WooCommerce.

"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 WooCommerce et d’obtenir un nombre de commandes, l’API ne renvoie pas la valeur attendue par Klaviyo ou ne renvoie aucune valeur.

Comme l’intégration n’a pas encore été officiellement connectée à Klaviyo, le problème doit être résolu dans WooCommerce.

Pour obtenir plus d’informations sur cette erreur, vous devez effectuer un appel d’API au point de terminaison du nombre de commandes, ce qui vous donnera plus d’insights sur ce qui est transmis à Klaviyo. Voici un exemple de requête cURL. Pour l’utiliser, renseignez l’URL de votre boutique, la clé de consommateur et le secret de consommateur :

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

« Votre plug-in Klaviyo est obsolète »

Il arrive que le webhook tarde à atteindre Klaviyo, ce qui vous amène temporairement à voir l’ancienne page des paramètres. Cela devrait se résoudre tout seul après quelques minutes.

404 lors de la connexion à Klaviyo depuis WordPress

Pour résoudre ce problème, vous devez vérifier que les permaliens sont activés pour votre site WordPress. L’authentification WooCommerce ne fonctionnera pas à moins que les permaliens soient activés.

1. Accédez à votre site WordPress et accédez à Paramètres > Permaliens.
2. Sous Paramètres courants, choisissez une structure de liens autre que Par défaut.
3. Confirmez en cliquant sur Enregistrer les modifications.
   

4. Lorsque vous avez terminé, réintégrez avec Klaviyo.

Échec de l’installation – nous n’avons pas pu installer votre extension

Vous pourriez rencontrer une erreur « Installation Failed » lorsque vous tentez d’installer l’intégration via la marketplace WooCommerce.

Si vous ne parvenez pas à installer l’application depuis la marketplace WooCommerce, vous pouvez également installer le plug-in depuis l’administration des plug-ins Wordpress.

1. Accédez à votre interface d’administration WordPress, puis allez dans Plug-ins.
2. Sélectionnez Ajouter un plug-in.
3. Recherchez Klaviyo dans Rechercher des plug-ins.
4. Sélectionnez Installer maintenant.
5. Sélectionnez Activer.
6. Sélectionnez Marketing sur la gauche, puis cliquez sur Klaviyo.
7. Cliquez sur Connect Account pour commencer, puis passez à Activer l’intégration WooCommerce dans l’article Démarrer avec WooCommerce.
   

Ressources supplémentaires