Connectez votre chatbot ChatLab à votre boutique CS-Cart afin que vos clients puissent trouver des produits et vérifier leurs commandes directement dans le chat. Les produits sont trouvés via AI Search, qui effectue une recherche sémantique dans votre catalogue CS-Cart indexé, ou via la recherche en direct dans la boutique, qui interroge l'API du magasin. Le moyen le plus rapide de vous connecter est d'utiliser l'add-on ChatLab pour CS-Cart, qui ajoute également le widget de chat à votre vitrine. La connexion manuelle à l'aide d'une clé API reste disponible comme alternative.
Exemple de conversation
Vérifier une commande
Nécessite une boutique connectée et son action de commande activée. Les champs disponibles dépendent de l'intégration. La correspondance d'une adresse e-mail ne constitue pas une preuve d'identité.
Visiteur: Où est ma commande ?
Lancez la lecture de l'exemple ou lisez-le ci-dessous. Aucune donnée client réelle n'est utilisée.Le client pose une question sur une commande existante.
La lecture se met en pause lorsque cet exemple quitte l'écran. Il s'agit d'une simulation, pas d'un chat en direct. Les commandes du widget dans la lecture ne sont pas interactives.Lire l'exemple complet
- Le client pose une question sur une commande existante.
Visiteur: Où est ma commande ?
- La recherche par défaut nécessite les deux identifiants.
Assistant: Veuillez me fournir votre numéro de commande ainsi que l'adresse e-mail utilisée lors du paiement.
- Utilisez des données fictives dans cet exemple.
Visiteur: 41982, anna@example.com
- L'action interroge la boutique connectée.
Vérification de la commande 41982...
- Ne transmettez que les informations renvoyées par la boutique.
Assistant: La commande 41982 est indiquée comme expédiée. Le transporteur est DPD. Veuillez consulter la page de suivi pour connaître l'état de la livraison.
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.
Avant de commencer
Créez ou sélectionnez d'abord un chatbot. Vous devez disposer des autorisations nécessaires pour gérer ses intégrations et de l'accès aux paramètres de connexion du compte externe. Si la vignette Connect (Connecter) affiche une invite de mise à niveau ou de contact, vérifiez que votre abonnement inclut cette intégration. Gardez vos identifiants API confidentiels ; ne les collez jamais dans le code d'intégration d'un site web.
Pour l'add-on, vous avez besoin de CS-Cart 4.18.1 ou d'une version plus récente, ainsi que d'un compte administrateur CS-Cart autorisé à installer des modules complémentaires et à gérer les administrateurs et les groupes d'utilisateurs. L'add-on est conçu pour l'édition standard de CS-Cart, et non pour Multi-Vendor.
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 le commerce en ligne : Comment configurer ChatLab pour votre boutique e-commerce
Comment le chatbot trouve des produits sur CS-Cart : AI Search et recherche en direct
Il existe deux manières pour un chatbot ChatLab de trouver des produits dans une boutique CS-Cart. Le chatbot utilise l'une ou l'autre, jamais les deux à la fois.
AI Search (recommandé) - ChatLab conserve son propre index de votre catalogue CS-Cart et le chatbot y effectue des recherches par le sens.
- Les clients posent des questions en langage naturel, par exemple « une robe rouge à moins de 300 ». Une fourchette de prix est appliquée comme filtre strict, et les codes produits exacts (SKU, EAN) sont également pris en compte.
- Le prix, le stock et les variantes sont lus en direct depuis CS-Cart au moment de la réponse, afin que les clients voient des données à jour même entre deux rafraîchissements de l'index.
- Les résultats s'affichent sous forme de fiches produits dans le chat, jusqu'à 5 par réponse.
- L'indexation démarre automatiquement lorsque la boutique est connectée. Le catalogue ne consomme pas de crédits d'entraînement.
- Plan requis : chaque plan E-commerce l'inclut (Free 100 produits, Start 2 000, Grow 5 000, Scale 20 000). Sur un plan Universal, ajoutez l'add-on Intégrations e-commerce (30 $ par mois) plus un pack de produits AI Search (29 $ par mois, 5 000 produits) attribué au chatbot.
Recherche en direct dans la boutique - le chatbot transmet l'expression du client au moteur de recherche de CS-Cart via l'API de la boutique et répond avec les données renvoyées par celle-ci.
- Rien n'est indexé et aucune synchronisation n'est nécessaire. Les données sont toujours en temps réel.
- Il s'agit d'une recherche par mots-clés : elle trouve ce que le moteur de recherche interne de votre boutique trouverait pour cette requête. Elle ne comprend pas les descriptions d'un besoin, les synonymes ou les fautes de frappe comme le fait AI Search.
- Plan requis : un plan Universal avec l'add-on Intégrations e-commerce (30 $ par mois). Aucun pack de produits n'est nécessaire.
Lorsque AI Search est activé, il remplace la recherche en direct dans la boutique. Le suivi des commandes fonctionne de la même manière dans les deux cas. Une troisième option, l'entraînement sur des pages explorées de la boutique, est accessible sur tous les plans et se destine aux contenus informatifs tels que la livraison et les retours, et non aux fiches produits. Pour une comparaison détaillée, consultez AI Search : comment votre chatbot trouve des produits, et pour les limites de produits, consultez Plans e-commerce et limites.
Ce que fournit l'intégration
Recherche en direct dans la boutique (recherche de produits par expression) - Le chatbot transmet la requête du client au moteur de recherche de CS-Cart et renvoie les produits correspondants avec :
- Nom et description du produit
- Prix
- SKU (code produit)
- Lien direct vers le produit dans votre boutique
- Image du produit
- Variantes disponibles (tailles, couleurs, etc.)
Vous pouvez configurer les champs de produits analysés lors de la recherche (nom, description courte, description complète, mots-clés) ainsi que le nombre de résultats à renvoyer.
Détails de la commande - Les clients peuvent vérifier le statut de leur commande en fournissant leur numéro de commande et leur adresse e-mail. Le chatbot renvoie :
- Le statut de la commande
- Les articles commandés avec leurs noms, prix, quantités, images de produits et variantes sélectionnées
- Le montant total de la commande et les frais de livraison
- Le transporteur, le numéro de suivi et le statut de l'expédition
- Le nom du destinataire et l'adresse complète de livraison
- Le numéro de téléphone du client
Recommandé : Se connecter avec l'add-on ChatLab
L'add-on ChatLab pour CS-Cart est la méthode de connexion la plus simple. Un add-on est une extension que vous installez dans votre panneau d'administration CS-Cart. Celui-ci connecte votre boutique à votre chatbot (recherche de produits et statut des commandes) et ajoute le widget de chat à votre vitrine en une seule étape, sans aucune clé à copier. Vous le téléchargez depuis ChatLab sous la forme d'un fichier .tgz et vous l'importez sur votre boutique.
Télécharger l'add-on
Sélectionnez votre chatbot et accédez à Test & Deploy (Tester et déployer). Dans la section Deploy (Déployer), développez Online store platforms (Plateformes de boutique en ligne) et cliquez sur CS-Cart. L'onglet Plugin Installation (Installation du plugin) est sélectionné par défaut. Cliquez sur Download the ChatLab add-on (.tgz) (Télécharger l'add-on ChatLab (.tgz)).
Votre navigateur enregistre le module sous le nom chatlab.tgz. Ne le décompressez pas - CS-Cart a besoin de l'archive telle quelle. Le bouton fournit toujours la version actuelle de l'add-on (1.0.2 au moment de la rédaction).
Le même bouton de téléchargement est disponible à deux autres endroits :
- Onglet Connect (Connecter) - cliquez sur Connect (Connecter) sur la vignette CS-Cart. La boîte de dialogue CS-Cart Integration (Intégration CS-Cart) s'ouvre avec les instructions relatives à l'add-on et le bouton Download the ChatLab add-on (.tgz). Sur un plan E-commerce, la même vignette se trouve également dans l'onglet Shop (Boutique) sous Connect your store (Connecter votre boutique).
- Assistant de configuration - lorsque vous créez un chatbot et choisissez CS-Cart comme plateforme, l'étape Connect CS-Cart (Connecter CS-Cart) propose la méthode Plugin or app (Plugin ou application) avec le même lien Download the ChatLab add-on (.tgz).
Installer l'add-on dans CS-Cart
- Connectez-vous à votre panneau d'administration CS-Cart.
- Accédez à Add-ons > Downloaded add-ons (Modules > Modules téléchargés).
- Ouvrez le menu avec l'icône d'engrenage et choisissez Manual installation (Installation manuelle).
- Importez le fichier
chatlab.tgzque vous avez téléchargé. CS-Cart installe l'add-on.
Connecter votre boutique
- Dans votre panneau d'administration CS-Cart, accédez à Marketing > ChatLab AI Chatbot.
- Cliquez sur Continue (Continuer). Un nouvel onglet de navigateur s'ouvre sur ChatLab.
- Connectez-vous à votre compte ChatLab, ou créez-en un, et choisissez le chatbot associé à cette boutique lorsque cela vous est demandé.
- Vous êtes automatiquement redirigé vers CS-Cart. La page affiche désormais ChatLab is connected (ChatLab est connecté), votre compte ChatLab, le nom du chatbot ainsi qu'un aperçu en direct (Live preview) du chatbot.
- Ouvrez votre vitrine et envoyez un message test. Pour vérifier les données de la boutique, posez également une question sur un produit et sur une commande que vous pouvez contrôler dans le panneau d'administration.
Si vous avez commencé la configuration depuis l'assistant ChatLab, revenez à cet onglet de navigateur. Il affiche Waiting for the connection... (En attente de la connexion...) et poursuit automatiquement le processus dès que la boutique est connectée.
Si CS-Cart indique que la demande de connexion est invalide ou a expiré, votre session CS-Cart a pris fin pendant que vous vous connectiez à ChatLab. Ouvrez à nouveau Marketing > ChatLab AI Chatbot et cliquez une nouvelle fois sur Continue.
Ce que configure l'add-on
- Connexion à la boutique - l'add-on crée un utilisateur API dédié en lecture seule dans votre boutique. Cet utilisateur appartient à un groupe d'utilisateurs nommé ChatLab API et peut uniquement consulter le catalogue, les commandes, les langues et les statuts de commande. Votre propre clé API d'administrateur n'est pas modifiée. La recherche de produits et les détails des commandes sont automatiquement activés pour le chatbot.
- Widget de chat - le widget est ajouté à chaque page de votre vitrine, sans aucun code à coller. Si votre boutique utilise le bandeau de consentement aux cookies de l'add-on CS-Cart GDPR, le widget y est répertorié en tant que service fonctionnel et respecte le choix de chaque visiteur.
- Langue du catalogue - à partir de la version 1.0.2, l'add-on transmet la langue par défaut de votre vitrine, afin que le chatbot lise les noms de produits, descriptions et catégories dans la langue que voient vos clients. ChatLab l'affiche sous le nom Shop Language (Langue de la boutique) dans la boîte de dialogue CS-Cart Integration. Toute langue que vous avez déjà définie manuellement pour cette boutique est conservée.
- Devise de la boutique - à partir de la version 1.0.2, l'add-on envoie également la devise principale de votre boutique, afin que les prix affichés dans le chat utilisent la devise correcte. ChatLab l'indique sous le libellé Shop currency (Devise de la boutique) dans cette même boîte de dialogue, accompagnée de la mention Sent by the ChatLab add-on (Envoyé par l'add-on ChatLab). Une devise définie manuellement est conservée.
Pour vérifier ces paramètres dans ChatLab, sélectionnez votre chatbot, ouvrez l'onglet Connect et cliquez sur Modify (Modifier) sur la vignette CS-Cart. Lorsque AI Search est activé pour le chatbot, l'indexation de votre catalogue démarre automatiquement une fois la boutique connectée.
La connexion à la boutique CS-Cart est proposée en tant que fonctionnalité premium. Si votre plan ne l'inclut pas, l'add-on ajoutera tout de même le widget de chat à votre vitrine, mais la recherche de produits et le statut des commandes resteront désactivés jusqu'à ce que vous passiez à un plan supérieur.
Si vous avez précédemment collé le code du widget ChatLab dans votre thème, les clients verront deux widgets de chat. La page de l'add-on vous alerte avec le message A ChatLab widget is already on your storefront (Un widget ChatLab est déjà présent sur votre vitrine). Supprimez le code de votre thème, ou décochez Show the chat widget on the storefront (Afficher le widget de chat sur la vitrine) dans la section Storefront widget (Widget de vitrine) et cliquez sur Save (Enregistrer).
Mettre à jour depuis une version antérieure
Les versions antérieures à la 1.0.2 ne transmettent pas la langue du catalogue ni la devise de la boutique. Pour effectuer la mise à jour :
- Téléchargez la dernière version de l'add-on depuis ChatLab en suivant les étapes décrites plus haut.
- Dans votre panneau d'administration CS-Cart, accédez à Add-ons > Downloaded add-ons, choisissez Manual installation dans le menu d'engrenage, importez le nouveau fichier
chatlab.tgzet cliquez sur Upload & install (Téléverser et installer). - CS-Cart détecte que l'add-on est déjà présent et demande comment le remplacer. Cliquez sur Use the safe way (Utiliser la méthode sécurisée) : CS-Cart désinstalle l'ancienne version et installe la nouvelle. Les paramètres de l'add-on dans CS-Cart sont alors réinitialisés, déconnectant ainsi temporairement la boutique.
- Ouvrez Marketing > ChatLab AI Chatbot, cliquez sur Continue, connectez-vous à ChatLab et sélectionnez à nouveau le même chatbot. L'add-on transmet la langue du catalogue et la devise de la boutique à cet instant précis.
Votre compte ChatLab, le chatbot et l'historique des conversations restent intacts lorsque vous vous déconnectez puis vous reconnectez. Au lieu de vous reconnecter, vous pouvez également définir vous-même Shop Language et la devise dans la boîte de dialogue CS-Cart Integration dans ChatLab.
Masquer le widget, déconnecter ou désinstaller
- Masquer uniquement le widget - sous Marketing > ChatLab AI Chatbot, décochez Show the chat widget on the storefront et cliquez sur Save. La boutique reste connectée.
- Déconnecter la boutique - sur la même page, cliquez sur Disconnect (Déconnecter) et confirmez. Le chatbot cesse d'apparaître sur votre vitrine, la connexion à la boutique est coupée pour le chatbot et la clé API de l'utilisateur en lecture seule est révoquée. Votre compte ChatLab et les données du chatbot restent accessibles dans ChatLab.
- Désinstaller l'add-on - désinstallez ChatLab dans Add-ons > Downloaded add-ons. Cette action supprime également de votre boutique l'utilisateur API en lecture seule ainsi que son groupe d'utilisateurs.
- Déconnecter dans ChatLab - ouvrez l'onglet Connect, cliquez sur Modify sur la vignette CS-Cart et cliquez sur Disconnect. Cela désactive la recherche de produits et le statut des commandes du côté de ChatLab uniquement. Pour retirer également le widget de votre vitrine, déconnectez-le dans CS-Cart.
Alternative : Se connecter avec une clé API
Si vous ne pouvez pas ou ne souhaitez pas installer l'add-on, connectez vous-même la boutique à l'aide d'une clé API CS-Cart en suivant les étapes 1 à 3 ci-dessous. Ne créez pas de seconde connexion si l'add-on a déjà connecté la boutique. Avec cette méthode, le widget de chat n'est pas ajouté automatiquement à votre vitrine - ajoutez-le manuellement en suivant la procédure décrite dans Installer le chatbot sur votre boutique CS-Cart à la fin de cet article.
Étape 1 : Activer l'accès API dans CS-Cart
- Connectez-vous à votre panneau d'administration CS-Cart
- Accédez à Customers > Administrators (Clients > Administrateurs)
- Cliquez sur le compte administrateur qui servira à la connexion API
- Basculez sur l'onglet API access (Accès API)
- Cochez "Yes, allow this user to use the API" (« Oui, autoriser cet utilisateur à utiliser l'API »)
- Cliquez sur Save
- Copiez la clé API (API key) affichée après l'enregistrement - conservez-la en lieu sûr
- Notez l'adresse e-mail (email address) associée à ce compte administrateur
Étape 2 : Connecter CS-Cart dans ChatLab
- Connectez-vous à ChatLab et sélectionnez votre chatbot
- Rendez-vous dans l'onglet Connect et cliquez sur Connect sur la vignette CS-Cart
- La boîte de dialogue CS-Cart Integration suggère d'abord l'add-on. Cliquez sur Continue manual setup (Poursuivre la configuration manuelle) pour ouvrir le formulaire de connexion
- Saisissez votre API Key (obtenue à l'étape 1)
- Renseignez votre CS-Cart Account Email (l'adresse e-mail de l'administrateur disposant de l'accès API)
- Entrez l'URL de votre boutique CS-Cart Shop URL (par ex.
https://votreboutique.com) - Sous Shop Language, cliquez sur Load languages (Charger les langues) et sélectionnez la langue de votre catalogue de produits. Cette étape est obligatoire si votre boutique gère plusieurs langues. Les noms de produits, descriptions et catégories sont extraits de votre boutique dans cette langue, et toute modification ultérieure relance l'indexation complète du catalogue
Vous pouvez également ajuster les paramètres de recherche :
- Searchable fields (Champs interrogeables) - activez ou désactivez les champs de produits dans lesquels le chatbot effectue ses recherches (CS-Cart Product name, CS-Cart Short description, CS-Cart Full description, CS-Cart Keywords)
- Number of search results (Nombre de résultats de recherche) - nombre de produits renvoyés par requête (par défaut : 5)
- Cliquez sur Connect
Une fois la connexion établie, un message de confirmation s'affiche avec la possibilité de configurer les actions IA. Lorsque vous rouvrirez cette boîte de dialogue plus tard via Modify, vous y trouverez également Shop currency, la devise détectée dans votre boutique. Si elle est manquante ou erronée, cliquez sur Set the currency manually (Définir la devise manuellement) et indiquez le code de devise à trois lettres, par exemple EUR.
Étape 3 : Configurer les actions CS-Cart
Après la connexion, activez et personnalisez chaque action IA. Rendez-vous dans Settings > Actions (Paramètres > Actions) et appliquez un filtre sur la plateforme CsCart.
Les actions standard comprennent :
- CsCart - product search - permet au chatbot d'effectuer des recherches dans votre catalogue de produits
- CsCart - order details - permet au chatbot de consulter les informations relatives à une commande
La procédure de connexion active les actions standard par défaut. Vérifiez leur état et désactivez celles que vous ne souhaitez pas mettre à disposition des clients. Ouvrez une action pour la modifier, puis utilisez Enable (Activer) ou Update (Mettre à jour) dans sa boîte de dialogue. Vous pouvez également adapter le libellé de l'action (le message présenté aux utilisateurs pendant son exécution) ainsi que les instructions qui guident l'utilisation de chaque action par l'IA.
AI Search pour CS-Cart : catalogue, réindexation et paramètres
Sur un plan E-commerce, ou sur un plan Universal lorsqu'un pack de produits AI Search est attribué au chatbot, AI Search est activé et remplace la recherche en direct dans la boutique. L'indexation démarre automatiquement dès que la boutique est connectée.
- Vérifier le catalogue - ouvrez Training > E-commerce catalog (Entraînement > Catalogue e-commerce) et consultez les onglets Products (Produits) et Categories (Catégories). Shop > Products présente le panneau Product catalog ainsi que la carte AI Search packs on this chatbot (Packs AI Search sur ce chatbot).
- Planifier la réindexation - utilisez Schedule auto-retrain (Planifier le réentraînement automatique) dans Training > E-commerce catalog. La réindexation peut être exécutée jusqu'à une fois par jour et est disponible avec tous les plans E-commerce et l'ensemble des packs de produits. Train now (Entraîner maintenant) ou Retrain (Réentraîner) lance la réindexation à la demande. Les mises à jour sont incrémentielles : les produits inchangés sont ignorés et les produits supprimés sont retirés de l'index.
- Vérifier l'action - dans Settings > Actions, ouvrez CsCart - AI product search. Ses options sont Include product card (Inclure la fiche produit), Products in stock only (Produits en stock uniquement) et Number of products to return (Nombre de produits à renvoyer).
- Afficher les fiches produits - activez Enable Offer Cards dans Settings > Model & Advanced. Consultez Offer Cards.
Si le catalogue dépasse la limite autorisée de produits, l'indexation s'arrête au plafond et le propriétaire du chatbot reçoit un e-mail. Les options de l'action de recherche en direct décrites précédemment ne s'appliquent pas nécessairement à AI Search.
Tester votre intégration
Après avoir activé les actions, ouvrez Test & Deploy et essayez :
- « Montre-moi des gants d'entraînement » (teste la recherche de produits)
- « Quel est le statut de ma commande 12345 ? » (teste les détails de la commande ; renseignez l'adresse e-mail associée à une commande à laquelle vous avez le droit d'accéder)
Vérifiez que les réponses correspondent bien aux données de votre boutique CS-Cart.
Conseils pour la configuration de la recherche
- Activez Product name et Short description pour un équilibre optimal entre rapidité et précision
- Ajoutez Keywords si vos fiches produits possèdent des métadonnées riches en mots-clés
- N'activez Full description que si les champs plus courts ne donnent pas de résultats satisfaisants - cela risque de ralentir les requêtes de recherche
- Commencez par 5 résultats par requête et adaptez selon la taille de votre catalogue
Installer le chatbot sur votre boutique CS-Cart
Si vous vous êtes connecté à l'aide de l'add-on, ignorez cette section - le widget est déjà présent sur votre boutique. Si vous vous êtes connecté à l'aide d'une clé API, ajoutez vous-même le widget de chat à votre vitrine CS-Cart :
- Dans ChatLab, accédez à l'onglet Test & Deploy (Tester et déployer) de votre chatbot
- Développez Online store platforms (Plateformes de boutique en ligne), cliquez sur CS-Cart et ouvrez l'onglet Manual Installation (Installation manuelle)
- Cliquez sur Copy to clipboard (Copier dans le presse-papiers) pour copier l'extrait de code
- Dans votre panneau d'administration CS-Cart, accédez à Design > Layouts (Design > Mises en page)
- Ajoutez un HTML block (Bloc HTML) dans la mise en page par défaut et collez l'extrait du widget dans son onglet Content (Contenu)
- Enregistrez les modifications du bloc et de la mise en page. Vérifiez les pages ayant des mises en page distinctes, comme la page de paiement, ainsi que toutes les langues de la vitrine
Si vous utilisez un bloc HTML avec prise en charge de Smarty, entourez l'extrait des balises {literal} et {/literal}. Consultez les instructions de CS-Cart relatives au code personnalisé. Ouvrez la boutique publiée et vérifiez le widget sur ordinateur et sur mobile.
Le code permet uniquement d'afficher le widget de chat. La recherche de produits et le statut des commandes proviennent de la connexion à la boutique : soit via l'add-on, soit via la connexion par clé API dans l'onglet Connect (Connecter).