Dépannage de votre intégration Magento 2

Vous apprendrez

Apprenez à résoudre les problèmes liés à la configuration de Magento 2 OAuth en suivant les étapes de dépannage décrites ci-dessous. Si vous rencontrez toujours des problèmes après avoir suivi ces étapes, veuillez contacter notre communauté ou notre équipe d'assistance. 

Avant de commencer

Si vous ne l'avez pas encore fait, lisez notre guide " Getting started with Magento 2 " pour obtenir des instructions pas à pas sur la mise en place de l'intégration de Magento 2.

Klaviyo utilise le protocole OAuth pour générer un jeton d'accès et récupérer les données de votre boutique Magento 2. Si vous avez personnalisé votre installation Magento 2, cela peut faire échouer la procédure OAuth de Klaviyo. Cet article vous guidera à travers une série d'étapes de dépannage afin d'identifier l'origine de la panne.

Étapes générales de résolution de problèmes

Assurez-vous que votre site est accessible au public avec un certificat SSL valide.

La procédure OAuth de Klaviyo exige que votre site web soit accessible au public, sinon les appels API nécessaires pour générer les jetons d'accès échoueront. 

1. Assurez-vous que l'accès à votre magasin n'est pas protégé par un mot de passe ou qu'il n'est pas soumis à des restrictions de propriété intellectuelle.
2. Assurez-vous que votre boutique est accessible via HTTPS avec un certificat SSL valide. Vous pouvez tester votre certificat ici.

Assurez-vous que votre pare-feu ne bloque pas les requêtes de Klaviyo.

Tout le trafic sortant de l'intégration de Klaviyo se trouve derrière un ensemble d'adresses IP statiques et prévisibles, de sorte que vous pouvez être certain que ce trafic provient de Klaviyo. Lisez notre article pour savoir comment autoriser les adresses IP du trafic de l'intégration Klaviyo. 

Vérifiez les versions de vos extensions Magento 2 et Klaviyo

1. Si vous utilisez Magento v2.2.0, vous devrez activer manuellement OAuth.
2. Assurez-vous que vous avez installé l'extension Klaviyo correcte (il se peut que vous deviez faire une mise à jour).

S'assurer que les points de terminaison OAuth sont accessibles

Vous pouvez avoir des règles de réécriture supplémentaires ou manquantes qui peuvent rendre les points de terminaison OAuth par défaut de Magento 2 inaccessibles. Klaviyo doit accéder à ces points finaux pour générer les informations d'identification nécessaires au processus d'autorisation.

Veillez à ce que les URL ci-dessous soient accessibles pour votre magasin :

https://[Store URL]/oauth/token/request

https://[Store URL]/oauth/token/access

1. Vous pouvez vérifier qu'ils sont accessibles en effectuant une requête POST comme celle-ci :

   curl --location --url 'https://[Store URL]/oauth/token/request' --request 'POST' -v

   curl --location --url 'https://[Store URL]/oauth/token/access' --request 'POST' -v

2. Vous devez vous attendre à une réponse similaire à la suivante. Il est normal de voir une erreur lors d'une requête de cette manière, et cela permet de valider que les points d'accès répondent correctement. 
   
3. Si vous ne recevez pas de réponse liée à OAuth, vous devez vérifier qu'il n'y a pas de redirection, de règles de réécriture invalides ou d'erreurs internes du serveur empêchant l'accès à ces URL.

Cela peut être dû à un sous-chemin de magasin dans votre URL. Testez la présence d'un problème de sous-chemin de magasin en accédant aux points d'extrémité :

https://[Store URL]/[Store Path]/oauth/token/request

https://[Store URL]/[Store Path]/oauth/token/access

Si ces points de terminaison sont résolus, incluez les règles de réécriture suivantes dans votre fichier .htaccess pour résoudre le problème.

RewriteEngine sur
RewriteRule /oauth/token/request$ https://%{HTTP_HOST}/[Store Path]/oauth/token/request [L,R=301]
RewriteRule /oauth/token/access$ https://%{HTTP_HOST}/[Store Path]/oauth/token/access [L,R=301]

Supprimer l'intégration et la recréer

Si vous avez apporté des modifications après l'échec d'une précédente tentative d'intégration, il est conseillé de supprimer l'intégration OAuth d'origine. Les clés utilisées peuvent être invalides et devront être régénérées.

1. Dans Magento, naviguez vers Systèmes
2. Sélectionnez les intégrations
3. Localisez l'enregistrement d'intégration Klaviyo et supprimez-le.

Une fois l'enregistrement d'intégration supprimé, suivez les étapes de notre guide sur l'intégration avec Magento 2 pour créer un nouvel enregistrement d'intégration et réessayer.

Problèmes spécifiques à la version de Magento

Défaillance spécifique à Magento 2.4.2

Si vous utilisez Magento 2.4.2, il y a un problème connu où les activations OAuth échouent. Lors de l'activation de l'intégration, il se peut que vous receviez un message d'erreur tel que celui présenté ci-dessous. Même si vous ne recevez pas d'erreur, il se peut que l'activation d'OAuth ait échoué. Normalement, l'erreur peut être trouvée dans les journaux de votre Magento.

Pour résoudre cette erreur, vous devrez soit

• Mettez à jour vers Magento 2.4.3. Consultez la documentation de Magento 2 pour mettre à jour votre version. 
• Appliquez un correctif tel que décrit sur le dépôt github de Klaviyo pour Magento 2.

Erreur d’authentification spécifique à Magento 2.4.6

Vous utilisez Magento 2.4.6 et rencontrez une erreur d’authentification 401 suite à l’intégration de Klaviyo ? Cela peut être dû à un bug connu qui affecte la version 2.4.6 de Magento. Pour résoudre ce problème, vous devez activer l’authentification par jeton porteur afin que Klaviyo puisse effectuer des requêtes par ce biais (au lieu d’utiliser OAuth 1.0). Pour activer l’authentification par jeton porteur :

1. Dans l’interface d’administration de Magento, accédez à Stores > Configuration > Services > OAuth > Consumer Settings.
2. Pour le paramètre Allow OAuth Access Tokens to be used as stand-alone Bearer tokens, sélectionnez Yes.
3. Cliquez sur Save config.
   

Après cette mise à jour, vous ne devriez plus rencontrer d’erreur d’authentification, et les synchronisations par le biais de l’intégration reprendront.

Ressources complémentaires

Référence de données Magento 2
Guide de prise en charge de plusieurs magasins Magento (pour Magento 2.x)