Intégrations Bruxel : API publique, webhooks, Adobe Commerce et domaine propre

Par Manuel Mattar4 min de lecture

En bref

Bruxel se connecte à vos systèmes par quatre voies : une API REST avec des clés par permissions, des webhooks signés qui préviennent quand quelque chose change, un module Adobe Commerce qui reçoit le contenu publié et la possibilité d'entrer depuis un sous-domaine de votre entreprise. Chaque appel et chaque notification sont journalisés.

Le problème : le PIM que personne ne voit

Un catalogue bien travaillé sert à peu de chose s'il arrive tard dans la boutique, si quelqu'un doit se connecter pour vérifier qu'un lot est terminé ou si l'ERP apprend les changements par un fichier envoyé le vendredi. Intégrer n'est pas un luxe : c'est ce qui fait arriver le travail de l'équipe là où l'on vend.

Le module Intégrations de Bruxel réunit les pièces pour cela, dans le menu Canaux : Systèmes connectés, Webhooks, Clés API et Domaine personnalisé.

Comment cela fonctionne dans Bruxel, étape par étape

1. L'API publique

L'API est REST et documentée dans le portail développeurs, avec une référence, des exemples en curl, Python et JavaScript et un journal des changements. Avec elle, votre système peut pousser des produits, lire et écrire des attributs, générer des descriptions —une par une ou en lots asynchrones avec clé d'idempotence—, exporter le catalogue en CSV par langue, lire les canaux et savoir si un produit sort complet dans chacun.

Chaque appel porte une clé d'API comme jeton Bearer. Les clés se créent dans Canaux → Clés API, par un administrateur ou le propriétaire ; elles ne s'affichent qu'une fois, et chacune ne porte que les permissions (scopes) dont elle a besoin : lire le catalogue, l'écrire, générer, exporter, lire les canaux. Sans la permission, l'API répond 403. Pour chaque clé, le journal des appels montre ce qu'elle a demandé ou écrit sur chaque produit.

2. Webhooks

Un webhook est une adresse à vous que Bruxel prévient quand il se passe quelque chose : une description est prête, une fiche a changé. En l'enregistrant, vous choisissez les événements à écouter, et chaque notification est signée avec un secret affiché une seule fois ; s'il est perdu, on le fait tourner et l'ancien cesse de fonctionner.

Si votre adresse ne répond pas, Bruxel réessaie, et chaque webhook affiche son dernier succès, sa dernière erreur et le nombre d'échecs consécutifs. La vue des livraisons montre chaque tentative : ce qui a été envoyé, ce que votre adresse a répondu et le temps pris, avec tout ce qui ressemble à un identifiant masqué avant stockage. « Renvoyer » envoie à nouveau la même notification. Le guide des webhooks donne le détail.

3. Systèmes connectés

Dans « Systèmes connectés », vous enregistrez les systèmes de votre activité —votre boutique, votre ERP, votre entrepôt— avec la clé qu'ils utilisent et l'endpoint que Bruxel prévient. L'écran indique quand chacun a appelé pour la dernière fois, combien de notifications attendent d'être livrées et si son canal est sain. Les flux de Bruxel les reconnaissent par leur clé. Il est visible des opérateurs et au-dessus, et c'est une fonction activée par compte.

4. Adobe Commerce avec Bruxel_Sync

Si votre boutique tourne sur Adobe Commerce ou Magento Open Source 2.4.7, 2.4.8 ou 2.4.9, le module Bruxel_Sync s'installe avec Composer et se configure dans le panneau d'administration de Magento. Le module appelle Bruxel ; Bruxel n'entre jamais dans votre boutique. La boutique envoie SKU, nom, catégorie et les attributs que vous choisissez ; Bruxel renvoie le contenu publié, dans la vue de boutique de chaque langue.

La première synchronisation est le moment délicat, c'est pourquoi le module est livré avec deux freins : un mode test qui montre ce qui changerait sans rien écrire, et une option qui n'écrase pas les champs avec du texte que Bruxel n'a jamais touchés. Avant d'écrire un champ pour la première fois, il sauvegarde la valeur précédente, et une commande la restaure. Le guide Adobe Commerce couvre les quatre étapes de configuration.

5. Domaine propre

Votre équipe et vos fournisseurs peuvent entrer depuis un sous-domaine de votre entreprise, comme pim.votreentreprise.com, avec votre logo sur la page de connexion et les liens des e-mails pointant là. Vous le demandez à l'équipe Bruxel via le centre d'aide ; ensuite vous créez deux enregistrements DNS (un CNAME et un TXT) et cliquez sur « Vérifier maintenant ». Cela coûte 100 crédits par mois et par domaine. Le guide du domaine propre explique chaque enregistrement.

Pour qui

Un exemple hypothétique : un distributeur avec sa boutique sur Adobe Commerce et un ERP maison. La boutique reçoit les descriptions dès leur publication via Bruxel_Sync, l'ERP écoute un webhook et relit la fiche quand elle change, et les fournisseurs entrent par le sous-domaine du distributeur.

Cela sert aux équipes qui ont déjà des systèmes et quelqu'un de technique pour les connecter.

Ce qu'il faut pour commencer

  • Une personne avec le rôle administrateur ou propriétaire pour créer des clés et enregistrer des webhooks.
  • Une personne technique du côté de votre système : pour l'API, pour recevoir les notifications ou pour installer le module dans Magento.
  • Pour le domaine propre, un accès au DNS de votre entreprise et un solde de crédits.

Limites honnêtes

  • Les clés d'API ne se limitent pas par marque ni par catégorie : elles autorisent par permissions. Une clé autorisée à écrire des attributs écrit dans tout le catalogue.
  • Un webhook se désactive tout seul après plusieurs échecs consécutifs ; il faut le réactiver.
  • Bruxel_Sync ne couvre pas les boutiques à plusieurs sites web sans vérifier le mappage à la main, ni Adobe Commerce as a Cloud Service. Les images ne voyagent pas vers la boutique, et le webhook du module s'enregistre à la main dans cette version.
  • Si vous utilisez Content Staging, une campagne programmée écrase ce que Bruxel a écrit ; il faut republier ensuite.
  • Le domaine propre est mis en place par l'équipe Bruxel pour l'instant, et l'API publique et les pages publiques restent sur bruxel.ai.

Pour voir le module complet, ouvrez la page Intégrations.

Questions fréquentes

Qui peut créer une clé d'API ?

Un administrateur ou le propriétaire de l'organisation. La clé ne s'affiche qu'une fois à sa création ; Bruxel ne garde que son empreinte, donc si elle est perdue, on la révoque et on en crée une autre.

Que se passe-t-il si mon système ne répond pas à un webhook ?

Bruxel réessaie. Après plusieurs échecs consécutifs, le webhook se désactive tout seul, et on le réactive depuis le même écran une fois que la destination répond.

Le module Adobe Commerce peut-il effacer mes descriptions ?

Non. Il n'efface jamais et n'écrit jamais l'URL du produit, et par défaut il n'écrase pas les champs qui ont déjà du texte. Il inclut aussi un mode test qui montre ce qui changerait sans rien écrire.

Puis-je utiliser mon domaine racine comme domaine propre ?

Non. Cela fonctionne avec un sous-domaine, comme pim.votreentreprise.com. Un domaine racine seul ne peut pas être utilisé.

Sources

  1. Webhook (Wikipedia, en anglais)
  2. Representational state transfer (Wikipedia, en anglais)
  3. CNAME record (Wikipedia, en anglais)

À 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 Mattar

Essayez-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

Intégrations Bruxel : API publique, webhooks, Adobe Commerce et domaine propre