Connectez votre boutique BigCommerce à votre chatbot ChatLab. Une fois connecté, le chatbot recherche vos produits, indexe l'ensemble du catalogue pour AI Search, permet aux clients d'ajouter des produits au panier depuis le chat et vérifie le statut de leurs commandes directement dans votre boutique.
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.
L'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 pour l'e-commerce
Après avoir terminé l'intégration ci-dessous, lisez le guide détaillé sur l'optimisation de votre chatbot pour l'e-commerce : Comment configurer ChatLab pour votre boutique e-commerce
Ce que fournit 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 :
- Le nom et la description du produit
- Le prix actuel dans la devise de votre boutique, et pour les produits en promotion, également le prix habituel
- L'image du produit
- Un lien direct vers la page du produit dans votre boutique
- La disponibilité, le SKU, la marque, les catégories et les options du produit (tailles, couleurs) lorsque le produit en dispose
Recherche de produits par mot-clé - Une simple recherche par mots-clés dans votre catalogue BigCommerce. La recherche de produits par IA la remplace automatiquement dès que le catalogue est indexé.
Statut de la commande - Le client indique le numéro de commande ainsi que l'adresse e-mail utilisée lors du paiement, et le chatbot répond en donnant le statut de la commande, les articles commandés, les montants totaux et les détails de suivi lorsque la commande a été expédiée. Les commandes sont toujours associées à l'e-mail du client, de sorte qu'un numéro de commande deviné au hasard ne révèle jamais la commande d'une autre personne.
Ajouter au panier - Les fiches produits dans le chat peuvent afficher un bouton Add to cart (Ajouter au panier). Sur votre vitrine BigCommerce, le bouton place directement le produit dans le panier du client et le compteur du panier dans l'en-tête de la page se met à jour. Pour les produits proposant des options comme la taille ou la couleur, le client choisit d'abord la variante dans le chat. Pour les produits avec des options que le chat ne peut pas renseigner (par exemple un champ texte obligatoire pour une gravure), le bouton ouvre la page du produit.
Widget de chat sur votre vitrine - ChatLab ajoute automatiquement le widget de chat sur votre vitrine grâce au BigCommerce Script Manager, vous n'avez donc aucun code à coller.
Découvrir l'expérience d'ajout au panier
Pour un exemple de panier et les instructions de test sur votre vitrine, consultez Ajouter des produits au panier. La séquence ci-dessous est donnée à titre d'illustration ; elle n'exécute pas de véritable opération de panier BigCommerce.
Choisissez une variante avant d'ajouter au panier
Séquence illustrative : les boutons de panier et les sélecteurs de variantes réels dépendent de la plateforme et de la boutique. Cette démonstration n'exécute aucune opération de panier.
Robe portefeuille émeraude, $79. Viscose, longueur midi.
Lancez la lecture de l'exemple ou lisez-le ci-dessous. Aucune donnée client réelle n'est utilisée.Les résultats de recherche affichent une fiche produit avec un bouton d'ajout au panier sur les boutiques compatibles.
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
- Les résultats de recherche affichent une fiche produit avec un bouton d'ajout au panier sur les boutiques compatibles.
Robe portefeuille émeraude, $79. Viscose, longueur midi.
- Le client choisit un produit et une taille à l'aide des options de panier disponibles.
Visiteur: Robe portefeuille émeraude, taille 38.
- Ne confirmez le succès qu'une fois que la boutique a validé l'opération de panier.
Assistant: Exemple de résultat : la variante sélectionnée a été ajoutée au panier de votre boutique.
- Le paiement et la commande restent gérés dans la boutique.
Assistant: Vérifiez votre panier dans la boutique pour confirmer la quantité, le prix et la livraison, puis procédez au paiement.
Ce que l'intégration ne fournit pas
- Le paiement dans le chat. Le client finalise son achat dans votre boutique BigCommerce.
- Les alertes de stock en temps réel. Les prix et la disponibilité sont lus depuis BigCommerce au moment où le chatbot répond, mais le chatbot n'informe pas les clients des modifications ultérieures.
- L'ajout au panier sur les vitrines headless. Le bouton de panier fonctionne sur les vitrines basées sur les thèmes BigCommerce. Sur une vitrine headless, il ouvre à la place la page du produit, et le widget de chat doit être ajouté manuellement à ce site.
Prérequis
- Une boutique BigCommerce dont vous êtes le propriétaire ou un utilisateur autorisé à installer des applications ou à créer des comptes d'API.
- L'intégration BigCommerce incluse dans votre forfait ChatLab.
- Pour la recherche de produits par IA : une capacité AI Search attribuée au chatbot suffisamment grande pour vos produits visibles. Vérifiez la capacité disponible dans Shop > Products (Boutique > Produits).
- Aucune autre intégration de boutique connectée au même chatbot.
Choisissez l'une des deux méthodes ci-dessous. Toutes deux mènent au même résultat.
Option A : Installer l'application ChatLab
- Dans votre panneau de configuration BigCommerce, allez dans Apps (Applications), trouvez ChatLab et cliquez sur Install (Installer).
- Vérifiez les autorisations et cliquez sur Confirm (Confirmer). ChatLab demande un accès en lecture seule aux produits, aux commandes, aux clients et aux informations de la boutique, ainsi qu'un accès au contenu de la vitrine pour ajouter son widget de chat.
- La page ChatLab s'ouvre dans votre panneau de configuration. Cliquez sur Continue setup (Poursuivre la configuration). L'onboarding de ChatLab s'ouvre dans un nouvel onglet de votre navigateur.
- Connectez-vous à votre compte ChatLab, ou créez-en un si vous n'en avez pas encore.
- Choisissez un chatbot existant ou créez-en un nouveau pour cette boutique.
C'est tout. ChatLab connecte la boutique au chatbot sélectionné, active les actions de recherche de produits et de statut de commande, commence à indexer votre catalogue et ajoute le widget de chat sur votre vitrine. Vous pouvez rouvrir ChatLab à tout moment depuis le menu Apps de votre panneau de configuration.
Désinstaller l'application dans BigCommerce désactive l'intégration dans ChatLab et supprime le widget de chat de votre vitrine. Votre chatbot et ses conversations restent conservés dans votre compte ChatLab.
Option B : Se connecter avec un compte d'API au niveau de la boutique
Utilisez cette option si vous préférez créer vous-même les accès, ou si vous souhaitez connecter un chatbot sans installer l'application.
Étape 1 : Créer le compte d'API dans BigCommerce
- Dans votre panneau de configuration BigCommerce, allez dans Settings (Paramètres), puis dans Store-level API accounts (Comptes d'API au niveau de la boutique).
- Cliquez sur Create API account (Créer un compte d'API) et donnez-lui un nom, par exemple ChatLab.
- Définissez les autorisations :
- Products (Produits) - lecture seule (read-only)
- Orders (Commandes) - lecture seule (read-only)
- Customers (Clients) - lecture seule (read-only)
- Information & settings (Informations et paramètres) - lecture seule (read-only)
- Content (Contenu) - modifier (modify)
- Cliquez sur Save (Enregistrer). BigCommerce affiche les identifiants une seule fois et les télécharge sous forme de fichier texte.
- Copiez l'API path (Chemin d'API) et le Access token (Jeton d'accès).
Le chemin d'API ressemble à api.bigcommerce.com/stores/abc123/v3/. La partie située entre stores/ et /v3/ correspond au hash de votre boutique.
Gardez le jeton d'accès secret. Vous pouvez le révoquer à tout moment en supprimant le compte d'API dans BigCommerce.
Étape 2 : Connecter la boutique dans ChatLab
- Ouvrez votre chatbot dans ChatLab et allez dans Shop (Boutique).
- Cliquez sur la vignette BigCommerce.
- Collez le chemin d'API (ou seulement le hash de la boutique) dans Store hash or API path (Hash de la boutique ou chemin d'API) et le jeton dans Access token (Jeton d'accès).
- Cliquez sur Check connection (Vérifier la connexion). ChatLab lit le profil de la boutique et affiche le nom de la boutique, l'adresse de la vitrine et la devise.
- Cliquez sur Connect (Connecter).
ChatLab teste la connexion et active les actions de recherche de produits et de statut de commande. Si une capacité AI Search est attribuée au chatbot, l'indexation du catalogue démarre immédiatement et la fenêtre de confirmation vous en informe. Cette même fenêtre vous indique également si le widget de chat a été ajouté à votre vitrine. Le jeton d'accès est stocké de manière chiffrée et n'est plus jamais affiché ; laissez le champ du jeton vide si vous souhaitez uniquement mettre à jour la connexion.
Configurer les actions
Allez dans Settings > AI Actions (Paramètres > Actions IA). Trois actions sont disponibles pour BigCommerce :
- BigCommerce - AI product search - recherche sémantique dans le catalogue indexé. Dans ses paramètres, vous pouvez inclure la fiche produit complète dans la réponse, limiter les résultats aux produits en stock et activer le bouton Add to cart.
- BigCommerce - product search - recherche par mots-clés dans le catalogue BigCommerce, utilisée lorsqu'AI Search n'est pas disponible pour le chatbot. Elle peut également être limitée aux produits en stock et afficher le bouton Add to cart.
- BigCommerce - order details - consultation du statut de la commande. Une limitation du débit et le masquage des données personnelles sont disponibles dans les paramètres de l'action.
Chaque action dispose d'un prompt modifiable et d'une étiquette d'action affichée dans le chat pendant que le chatbot travaille.
Vérifier le catalogue
Ouvrez Training > E-commerce catalog (Entraînement > Catalogue e-commerce) pour suivre la progression de l'indexation, parcourir les produits indexés et réentraîner le catalogue après des modifications importantes dans la boutique. Les produits qui ne sont pas visibles dans votre boutique ne sont pas indexés.
Les produits sans description sont indexés uniquement d'après leur nom, leur marque, leurs catégories et leurs attributs. Si vos produits n'ont pas de description dans BigCommerce, l'ajout d'une description, même courte, améliore sensiblement les résultats de recherche.
Si vous entraînez également le chatbot sur les pages de votre site web, ChatLab reconnaît une boutique BigCommerce et ignore les pages de produits, de catégories et de marques. Les données des produits proviennent du catalogue, il n'est donc pas nécessaire de les lire une seconde fois sur les pages.
Le widget de chat sur votre vitrine
Lorsque la boutique est connectée via l'application, ou via un compte d'API disposant d'un accès de modification à Content, ChatLab ajoute le widget pour vous. Vous pouvez le voir dans Storefront > Script Manager sous le nom de ChatLab chatbot. Il est placé dans le pied de page de toutes les pages de la vitrine, dans la catégorie de consentement Functional (Fonctionnel), et il est supprimé lorsque vous déconnectez la boutique.
Si le compte d'API a été créé sans accès à Content, créez un nouveau compte d'API disposant de cet accès et reconnectez-vous, ou ajoutez le widget vous-même :
- Dans ChatLab, ouvrez votre chatbot, allez dans Test & Deploy (Tester et déployer), choisissez BigCommerce et copiez le code.
- Dans votre panneau de configuration BigCommerce, allez dans Storefront > Script Manager.
- Cliquez sur Create a Script (Créer un script) et donnez-lui un nom, par exemple ChatLab.
- Réglez Placement sur Footer (Pied de page), Location sur Storefront pages (Pages de la vitrine) et Script category sur Functional.
- Choisissez le Script type (Type de script) Script et collez le code dans Script contents (Contenu du script).
- Cliquez sur Save et actualisez votre vitrine. Le chatbot apparaît dans le coin inférieur de chaque page.
Dépannage
- "Failed to connect to the BigCommerce store. Check the store hash and the access token." - Le jeton a été copié de manière incomplète, le compte d'API a été supprimé ou le hash de la boutique appartient à une autre boutique. Copiez à nouveau les deux valeurs depuis le fichier téléchargé par BigCommerce lors de la création du compte d'API.
- Le widget de chat n'a pas été ajouté automatiquement - Le compte d'API ne dispose pas de l'accès en modification à Content. Créez un nouveau compte d'API disposant de cet accès et connectez-le à nouveau, ou ajoutez le widget dans le Script Manager comme décrit ci-dessus.
- Le chatbot n'apparaît pas sur la vitrine - Vérifiez que le script figure bien dans Storefront > Script Manager. Si votre boutique utilise un bandeau de consentement pour les cookies, le widget se charge une fois que le visiteur a accepté la catégorie Functional.
- Le chatbot ne trouve aucun produit - Vérifiez le statut de l'indexation dans Training > E-commerce catalog et assurez-vous que les produits sont bien visibles dans votre boutique.
- La commande est introuvable - Le chatbot a besoin de l'adresse e-mail utilisée lors du paiement ainsi que du numéro de commande indiqué dans l'e-mail de confirmation.
- Ajouter au panier ouvre la page du produit - Le produit comporte une option obligatoire qui ne peut pas être choisie dans le chat, telle qu'un champ texte, ou le chatbot s'exécute en dehors de votre vitrine BigCommerce.