Intégration avec un flux de produits (XML, Google Merchant)

Connectez n'importe quelle boutique en ligne à votre chatbot ChatLab grâce à un flux de produits. Si votre plateforme ne dispose pas d'une intégration ChatLab native, le flux est le moyen idéal de transmettre votre catalogue au chatbot : il lit les produits du flux, les indexe avec AI Search et répond avec des fiches produits qui renvoient vers votre boutique.

Exemple de conversation

Cet exemple illustre l'expérience client. Les actions disponibles et les informations renvoyées dépendent de cette intégration et de votre configuration.

Important : bonnes pratiques e-commerce

Après avoir terminé l'intégration ci-dessous, consultez le guide complet sur l'optimisation de votre chatbot pour l'e-commerce : Comment configurer ChatLab pour votre boutique e-commerce

Ce que propose l'intégration

Recherche de produits par IA - Les clients décrivent ce dont ils ont besoin avec leurs propres mots et le chatbot trouve les produits correspondants dans votre catalogue. La réponse contient :

• Nom et description du produit
• Prix (et prix promotionnel s'il figure dans le flux)
• Image du produit
• Lien direct vers la page du produit dans votre boutique
• Marque, disponibilité, GTIN / SKU et autres attributs du flux

Catégories - Lorsque le flux inclut le type de produit (par exemple « Maison > Cuisine > Bouilloires »), le chatbot peut restreindre la recherche à une catégorie.

Actualisation planifiée - Le catalogue est actualisé selon la fréquence que vous avez définie, afin que les nouveaux produits, les prix et les disponibilités soient transmis au chatbot sans aucune intervention de votre part.

Ce que l'intégration ne permet pas

Le flux est un fichier, pas une connexion directe à votre boutique, le chatbot ne peut donc pas :

• vérifier le statut d'une commande
• ajouter des produits au panier ou passer une commande
• lire les niveaux de stock en temps réel entre deux actualisations

Les fiches produits dotées d'une URL produit valide renvoient vers votre boutique, où le client finalise son achat. Pour le suivi des commandes, choisissez une intégration native qui le prend en charge. L'ajout au panier dépend également de la plateforme et de la configuration de la boutique ; il n'est pas disponible sur toutes les intégrations natives.

Prérequis

• L'intégration Feed XML incluse dans votre forfait
• L'accès à AI Search et la capacité de catalogue attribuée au chatbot : vérifiez Shop > Products (Boutique > Produits) pour connaître la capacité disponible
• Aucune autre intégration de boutique connectée au même bot. Vérifiez les conséquences avant de déconnecter une boutique existante.
• Un flux de produits au format XML Google Merchant (Google Shopping), accessible à une adresse https publique. Les flux compressés (.gz) et les flux protégés par un nom d'utilisateur et un mot de passe sont pris en charge.

Étape 1 : Obtenir le flux de produits depuis votre boutique

Demandez à l'administrateur de votre boutique un flux de produits XML contenant les champs Google Merchant. La génération du flux et les éventuels coûts d'extension dépendent de votre plateforme :

• Magento / Adobe Commerce - une extension de flux Google Shopping (par exemple depuis Magento Marketplace) génère le fichier XML à une adresse telle que https://yourstore.com/feeds/google.xml
• IdoSell - ouvrez MARKETING > Produkty i reklamy w Google > Feed produktowy dla Google Shopping do samodzielnego zarządzania reklamami et récupérez l'URL du flux. Vérifiez que ChatLab peut le télécharger, car certains flux restreignent l'accès au service auquel ils sont destinés. Consultez le guide Google Shopping d'IdoSell et les restrictions d'accès au flux.
• OpenCart - si votre version inclut l'extension de flux Google Base, activez-la sous les extensions de flux et copiez son URL de flux de données ; sinon, utilisez une extension d'exportation XML compatible
• BigCommerce - obtenez une URL XML téléchargeable depuis votre application d'exportation de flux. Une simple connexion au canal Google ne constitue pas l'URL de flux dont ChatLab a besoin
• Shopware 6 - ajoutez un canal de vente Comparaison de produits (Product comparison), choisissez Google Shopping (XML) comme modèle, configurez l'exportation et copiez son URL. Consultez le guide d'exportation de Shopware.
• osCommerce et boutiques sur mesure - tout module qui génère un flux RSS 2.0 ou Atom avec les attributs de produit g:

Chaque produit indexé a besoin d'un identifiant unique (g:id par défaut). Un nom et un lien vers le produit sont fortement recommandés : en l'absence de nom, l'identifiant est utilisé par défaut, et en l'absence de lien, il est impossible de générer un lien fonctionnel vers la boutique. Le prix, l'image, la description, la disponibilité et le type de produit améliorent grandement la qualité des réponses.

Étape 2 : Connecter le flux dans ChatLab

1. Connectez-vous à ChatLab et sélectionnez votre bot
2. Accédez à l'onglet Connect (Connecter)
3. Cliquez sur Connect (Connecter) sur la tuile Feed XML
4. Collez l'adresse dans Feed URL (URL du flux)
5. Si le flux nécessite des identifiants, activez l'option The feed requires a username and password (Le flux nécessite un identifiant et un mot de passe) et saisissez vos accès
6. Définissez éventuellement le paramètre Product language (Langue du produit - code à deux lettres de la langue utilisée dans le flux)
7. Cliquez sur Test feed (Tester le flux) - ChatLab télécharge le début du flux et affiche le format, un aperçu du nombre d'articles (jusqu'à 2 000 articles, pas nécessairement le total de l'ensemble du flux), jusqu'à cinq exemples de produits ainsi que d'éventuels avertissements (prix, liens, images ou catégories manquants)
8. Cliquez sur Connect (Connecter)

Si l'indexation automatique du catalogue est activée et que l'accès AI Search requis ainsi que la capacité nécessaire sont disponibles, la configuration de la connexion lance l'indexation en arrière-plan. Sinon, entraînez le catalogue manuellement. Suivez l'avancement et les erreurs dans Shop > Products (Boutique > Produits) ou Training > E-commerce catalog (Entraînement > Catalogue e-commerce) ; la réussite de la connexion ne signifie pas à elle seule que les produits peuvent déjà être recherchés.

Étape 3 : Flux non standard (mappage des champs)

Si votre flux n'est pas au format Google Merchant, ChatLab peut tout de même le lire :

1. Exécutez d'abord Test feed (Tester le flux) - les noms d'éléments trouvés dans votre fichier apparaissent dans les listes déroulantes de mappage
2. Ouvrez Field mapping for non-standard feeds (Mappage des champs pour les flux non standard)
3. Si un produit n'est pas un élément item ou entry, saisissez le nom de l'élément produit (Product element)
4. Choisissez l'élément correspondant à chaque champ : identifiant du produit (Product identifier, obligatoire), nom du produit (Product name), description (Description), URL de la page produit (Product page URL), URL de l'image (Image URL), prix (Price), chemin de la catégorie (Category path) et le reste
5. Exécutez à nouveau Test feed (Tester le flux) et vérifiez les échantillons de produits
6. Cliquez sur Connect (Connecter)

Les champs laissés sur « Default (Google Merchant) » conservent les noms standard, de sorte qu'un flux respectant le standard ne nécessite aucun mappage.

Étape 4 : calendrier d'actualisation

1. Rendez-vous dans Training > E-commerce catalog (Entraînement > Catalogue e-commerce)
2. Sur la carte Feed XML, cliquez sur Retrain (Réentraîner)
3. Retrain now! (Réentraîner maintenant !) actualise immédiatement le catalogue
4. Pour une actualisation automatique, choisissez la fréquence (tous les jours, une fois par semaine ou une fois par mois), le jour et l'heure, puis cliquez sur Schedule retrain (Programmer le réentraînement)

Seuls les produits modifiés depuis la dernière actualisation sont réindexés, et les produits supprimés du flux sont retirés du catalogue du chatbot. L'actualisation programmée dépend de votre plan : les planifications hebdomadaires et mensuelles nécessitent la fonctionnalité de réentraînement programmé, tandis que la planification quotidienne nécessite la fonctionnalité de réentraînement quotidien.

Étape 5 : configurer l'action IA

Lorsque l'indexation automatique du catalogue est activée et que vous disposez des accès requis, la configuration de la connexion active Feed XML - AI product search (recherche de produits par IA). Sinon, activez-la manuellement et entraînez le catalogue. Pour la modifier, accédez à Settings > Actions (Paramètres > Actions) et filtrez par la plateforme Feed XML. Vous pouvez modifier le libellé de l'action, les instructions qui guident l'IA et activer Include product card (Inclure la fiche produit) pour fournir au chatbot la fiche produit complète plutôt que la description courte.

Tester votre intégration

Ouvrez le widget de votre chatbot et essayez :

• « Montre-moi des bouilloires à moins de 50 dollars » (teste la recherche avec filtre de prix)
• « Avez-vous des t-shirts bleus en coton ? » (teste la correspondance des attributs)

Les réponses doivent présenter des produits issus de votre flux accompagnés de liens vers votre boutique.

Conseils

• Indiquez le type de produit dans le flux (g:product_type) sous forme de chemin complet, par exemple « Vêtements > Hommes > T-shirts » - il devient la catégorie par laquelle le chatbot peut filtrer
• Conservez des descriptions complètes dans le flux ; le chatbot les utilise pour faire correspondre les questions des clients
• Les variantes d'un même produit doivent partager un item_group_id - ChatLab regroupe leurs attributs de couleur, taille, matière et motif en un seul produit indexé. Le premier article représente le prix et le lien du groupe, vérifiez donc les détails spécifiques aux variantes dans votre boutique
• Si votre flux est volumineux, un flux compressé (.gz) se télécharge plus rapidement

Installer le chatbot sur votre boutique

Pour ajouter le widget de chat à votre boutique :

1. Dans ChatLab, allez dans l'onglet Deploy (Déployer) de votre bot
2. Sélectionnez Widget et copiez l'extrait de code
3. Collez-le dans le modèle de votre boutique, avant la balise fermante </body>, ou utilisez le paramètre "HTML personnalisé" ou "scripts" de votre plateforme

Articles connexes

• Guide de configuration e-commerce
• Ajouter le chatbot à votre site web