- Blog de Bruxel.AI
- Cas d'usage : synchroniser le contenu avec Adobe Commerce sans éditer la boutique
Cas d'usage : synchroniser le contenu avec Adobe Commerce sans éditer la boutique
Par Manuel Mattar4 min de lecture
En bref
C'est un scénario d'exemple. Une boutique Adobe Commerce installe le module Bruxel_Sync, qui envoie ses produits à Bruxel et reçoit en retour le contenu publié dans les attributs et les vues de magasin qu'elle a associés. La boutique reste propriétaire du catalogue et Bruxel n'écrit que la description.
Ce cas est un exemple, pas un client : une boutique imaginaire et un catalogue de scénario pour montrer comment fonctionne le module Bruxel_Sync du début à la fin. Les versions, les permissions et les garde-fous sont ceux du guide d'aide actuel.
La situation
Une boutique d'articles pour la maison vend 4 000 produits sur Adobe Commerce 2.4.8, avec deux vues de magasin : une en espagnol et une en anglais. Les descriptions sont rédigées par une équipe de deux personnes, collées dans l'administration de Magento produit par produit puis traduites. À chaque saison, le catalogue grandit plus vite que l'équipe.
La boutique veut générer le contenu dans Bruxel et qu'il arrive tout seul sur la bonne fiche, dans la bonne langue, sans écraser ce qui fonctionne déjà.
Ce qui voyage, et dans quel sens
Avant d'installer quoi que ce soit, l'équipe comprend la règle du module : deux choses circulent, chacune dans un sens.
- De la boutique vers Bruxel : les produits — SKU, nom, catégorie et les attributs choisis. C'est la matière première pour générer. Les produits activés et visibles voyagent ; les variantes masquées d'un produit configurable restent dehors, pour ne pas dépenser de crédits sur des fiches que la boutique n'affiche pas.
- De Bruxel vers la boutique : le contenu déjà publié, écrit sur la fiche du produit, dans la vue de magasin de chaque langue.
La boutique est propriétaire du catalogue. Si quelqu'un modifie un nom ou une catégorie dans Bruxel, le prochain envoi depuis la boutique l'écrase.
Étape 1 : la clé et l'installation
Une administratrice crée dans Canaux → Clés API une clé avec les permissions catalogue, attributs et export. Ensuite, le développeur de la boutique installe le module avec Composer. Le module s'installe désactivé : rien ne bouge tant qu'il n'est pas activé.
Dans l'administration de Magento, sous Stores → Configuration → Bruxel → Sincronización, il suit les quatre étapes :
- Coller la clé. « Tester la connexion » confirme qu'elle répond et sur quel compte elle entre.
- Associer chaque langue à sa vue de magasin : l'espagnol à la vue espagnole, l'anglais à l'anglaise.
- Choisir quels attributs voyagent vers Bruxel comme contexte pour générer : matière, dimensions, couleur.
- Associer les champs de contenu : quel champ de Bruxel s'écrit dans quel attribut de Magento.
Étape 2 : générer et publier dans Bruxel
Avec les produits dans Bruxel, l'équipe configure sa voix de marque et génère par lots depuis le catalogue. En lot, chaque produit coûte 7 crédits par langue de sortie ; avec deux langues, 14. Ce qui est publié dans Bruxel est ce que le module écrira ; si l'organisation a activé l'approbation, rien ne sort sans l'accord d'un administrateur.
Étape 3 : la première synchronisation, sans frayeur
La première écriture sur un catalogue qui a déjà des descriptions est le moment délicat. Le module arrive avec deux garde-fous, et l'équipe s'en sert :
- Le mode test montre ce qui changerait — produit, champ, vue de magasin, valeur actuelle et nouvelle — sans rien écrire.
- Une option activée par défaut qui n'écrase pas les champs qui ont déjà du texte et que Bruxel n'a jamais touchés.
En outre, avant d'écrire un champ pour la première fois, le module enregistre la valeur précédente, et une commande de restauration la remet exactement comme elle était. Avant la première grosse synchronisation, le développeur passe les indexeurs en « Update on Schedule », car chaque écriture invalide le cache de la fiche.
Étape 4 : la notification en temps réel
Pour que la boutique soit prévenue dès qu'un contenu est publié, l'administratrice enregistre l'adresse du module dans Canaux → Webhooks, abonnée à l'événement de description mise à jour. Elle le fait après avoir activé le module et collé le secret : si l'endpoint échoue plusieurs fois de suite, Bruxel le désactive tout seul. Même si le webhook échoue, le contenu arrive quand même, car le module vérifie de lui-même toutes les heures.
Ce qui est résolu et ce qui ne l'est pas
Résolu : l'équipe ne copie-colle plus de descriptions dans Magento. Le module n'écrit que dans les attributs texte de portée vue de magasin qu'elle a associés, ne change jamais l'URL du produit et ne supprime jamais : un champ vide ou un produit dépublié laissent la fiche telle quelle.
Tout n'est pas résolu :
- Les images ne voyagent pas vers la boutique dans cette version.
- Plusieurs sites web dans la même boutique imposent de vérifier l'association à la main.
- Adobe Commerce as a Cloud Service n'est pas couvert ; Adobe Commerce ou Magento Open Source 2.4.7, 2.4.8 et 2.4.9 le sont.
- Content Staging : une campagne planifiée qui s'applique écrase ce que Bruxel a écrit ; il faut republier ensuite.
- Les langues synchronisées sont l'espagnol, l'anglais, le français et le portugais.
Les guides Adobe Commerce et webhooks détaillent toute la configuration. Les pages des intégrations, des canaux et du contenu par IA montrent le reste du chemin.
Questions fréquentes
Bruxel entre-t-il dans mon Magento ?
Non. Le module est installé dans votre boutique et c'est lui qui appelle Bruxel. Bruxel n'entre jamais dans votre Magento.
Que se passe-t-il si je modifie le nom du produit dans Bruxel ?
La boutique est propriétaire du catalogue : le prochain envoi depuis la boutique écrase le nom, la marque, la catégorie et les attributs. Ce que Bruxel envoie à la boutique, c'est le contenu généré, et rien d'autre.
Le module envoie-t-il les images à la boutique ?
Pas dans cette version. Les images ne voyagent pas vers la boutique ; le module n'écrit que le contenu texte dans les attributs que vous avez associés.
Sources
À propos de l'auteur
Manuel Mattar
Fondateur de Bruxel.AI
Il a fondé en 2014 Wolf Sellers, agence e-commerce à Mexico, puis Bruxel.AI, le PIM avec IA.
Voir tous les articles de Manuel MattarEssayez-le avec votre catalogue
Créez votre compte gratuit et essayez Bruxel avec vos propres produits grâce aux crédits de bienvenue.
À lire aussi
· 4 min de lecture
Cas d'usage : un catalogue sur trois marketplaces, avec les photos de chacune
Un scénario d'exemple : une marque de chaussures vend sur Amazon, Mercado Libre et Walmart México. Colonnes, photos par destination et limites de Bruxel.
· 4 min de lecture
Canaux et modèles de marketplace dans Bruxel : un fichier prêt par destination
Comment fonctionnent les canaux de Bruxel : colonnes, valeurs par destination, modèles Walmart Mexique et Mercado Libre, manques par produit et flux signés.
· 4 min de lecture
Images par destination dans Bruxel : une photo, le format de chaque marketplace
Comment Bruxel prépare vos photos produit pour chaque marketplace : taille, fond, poids et nom de fichier, avec un assistant en trois étapes et une file.