Aller au contenu principal

2.8.2 Configuration complète de l'intégration avec VTEX

Ce guide fournit des instructions pas à pas pour intégrer votre boutique VTEX à Fozzels. Le processus comporte deux grandes étapes : générer les clés API requises dans votre panneau VTEX Admin, puis terminer la configuration dans Fozzels.

Partie 1. Configuration côté VTEX​

Pour permettre à Fozzels de lire la structure de votre catalogue et de réécrire le contenu généré dans votre boutique, vous devez créer un Role dédié avec des autorisations spécifiques et générer une Application Key et un Application Token.

Étape 1. Créer un Role avec les autorisations requises​

  1. Connectez-vous à votre panneau VTEX Admin.

  2. Accédez à Account Settings → User Management → Roles.

  3. Cliquez sur New Role.

  4. Donnez un nom explicite au rôle (par exemple, Fozzels Integration).

  5. Dans la liste des autorisations, ajoutez l'accès aux ressources suivantes :

  • Catalog (License Manager) :

  • Category — Read / Write

  • Brand — Read / Write

  • Product — Read / Write

  • SKU — Read / Write

  • Specification / Attributes — Read / Write

  • CMS (s'il est utilisé pour les médias/images) :

  • Accès Read / Write

  1. Enregistrez le nouveau rôle.

Étape 2. Générer l'Application Key et l'Application Token​

  1. Dans le menu Account Settings, accédez à Account Management → Application Keys.

  2. Cliquez sur Manage Keys ou Generate Key.

  3. Saisissez un Label facilement identifiable (par exemple, Fozzels Connector).

  4. Attribuez à cette clé le rôle créé à l'étape 1 (Fozzels Integration).

  5. Le système génère deux identifiants :

  • Application Key (reste visible dans votre liste).

  • Application Token (affiché une seule fois lors de sa création).

  1. Important : copiez et conservez immédiatement l'Application Token dans un endroit sûr. Une fois la fenêtre modale fermée, il est impossible de le récupérer !

Les utilisateurs peuvent également consulter la base de connaissances officielle de VTEX pour obtenir des instructions détaillées sur la création des Application Keys et Tokens :

Partie 2. Configuration côté Fozzels​

Une fois vos identifiants API prêts, configurez la connexion dans Fozzels.

Étape 1. Créer une nouvelle intégration​

  1. Connectez-vous à Fozzels et ouvrez Integrations depuis le menu de navigation supérieur.

  2. Cliquez sur le bouton vert + Create.

  3. Sélectionnez VTEX dans la liste des plateformes d'intégration disponibles.

Étape 2. Saisir les détails de configuration (onglet 1 : Configuration)​

Remplissez le formulaire de connexion :

  • Name : saisissez un nom pour cette intégration (par exemple, VTEX Main Store).

  • URL : saisissez l'URL/le domaine de votre boutique VTEX.

  • Application Key : collez l'Application Key générée dans VTEX.

  • Application Token : collez l'Application Token généré dans VTEX.

  • Environment (facultatif) : la valeur par défaut est vtexcommercestable. Ne la modifiez que si VTEX vous a demandé d'utiliser un environnement personnalisé.

  • Translation locales (facultatif) : pour les comptes transfrontaliers, indiquez les locales VTEX séparées par des virgules (par exemple, es-AR, en-US). Laissez vide pour les boutiques monolingues.

  • Global Pull Schedule (facultatif) : définissez un planning de récupération automatique personnalisé ou conservez les paramètres par défaut.

  • Pull Throttling / API Delays (facultatif) :

  • Delay between pages : définissez la durée de la pause après chaque page de résultats récupérée lors d'une récupération (100–15,000 ms). Laissez vide pour utiliser la valeur par défaut de la plateforme.

  • Delay between requests : définissez la durée de la pause entre les appels API individuels lors d'une récupération (100–15,000 ms). Laissez vide pour utiliser la valeur par défaut de la plateforme.

  • ⚠️ Remarque : définir ces valeurs en dessous des valeurs par défaut de la plateforme peut déclencher une limitation de débit de la part de VTEX et entraîner l'échec des récupérations du catalogue.

Cliquez sur Save dans le coin inférieur gauche.

Étape 3. Vérifier le statut et récupérer les boutiques (onglet 2 : Websites & Stores)​

  1. Vérifiez que tous les indicateurs de statut dans le coin supérieur droit sont actifs :

  • Active — Activé (commutateur vert).

  • Authorized — Coche verte.

    • REST API Connected — Coche verte.

  1. Cliquez sur le bouton PULL WEBSITES AND STORES dans le coin inférieur gauche.

  2. Vos sites web et les locales de vos boutiques apparaissent dans le tableau. Activez les commutateurs Status pour les sites web et les boutiques que vous prévoyez de traiter.

Étape 4. Récupérer les données du catalogue (Pull Products)​

  1. Repérez votre boutique dans le tableau et cliquez sur Pull products (ou cliquez sur la flèche déroulante située à côté).

  2. Vous pouvez lancer la synchronisation de données pour des entités précises ou les exécuter séquentiellement :

  • Product Attribute

  • Category Attribute

  • Brand Attribute

  • Category

  • Brand

    • Product

  1. Attendez la fin de la synchronisation. Le statut de chaque entité passe au vert et affiche 100%.

  2. Cliquez sur l'icône en forme d'œil (View) à côté de n'importe quel bloc d'entité pour inspecter les données récupérées.

Félicitations ! Votre intégration VTEX est maintenant entièrement configurée et prête à l'emploi. Fozzels synchronise désormais en toute transparence les données de votre catalogue, ce qui vous permet de générer facilement des descriptions produit IA de haute qualité, du contenu localisé et des métadonnées. Si vous devez effectuer des ajustements par la suite, vous pouvez à tout moment revenir à la page Integration Settings.

Bonne automatisation !