Connectez votre boutique Ecwid by Lightspeed à votre chatbot ChatLab. Une fois connecté, le chatbot recherche vos produits, indexe l'ensemble du catalogue pour AI Search et vérifie le statut des commandes des clients directement dans la boutique Ecwid.
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 vécue par le 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, lisez le guide détaillé sur l'optimisation de votre chatbot pour le 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 et la réduction
- L'image du produit
- Un lien direct vers la page du produit dans votre boutique
- La disponibilité, le SKU, les catégories et les options du produit (tailles, couleurs) lorsque le produit en comporte
Recherche de produits par expression - Une simple recherche par mot-clé utilisant le moteur de recherche d'Ecwid. La recherche de produits par IA la remplace automatiquement une fois le catalogue indexé.
Statut de commande - Le client indique le numéro de commande et l'adresse e-mail utilisée lors du paiement, et le chatbot répond avec le statut du paiement, le statut de traitement, le mode de livraison, le numéro de suivi et les articles commandés. Les commandes sont toujours vérifiées par rapport à l'e-mail du client, de sorte qu'un numéro de commande deviné au hasard ne révèle jamais la commande de quelqu'un d'autre.
Catégories - Le chatbot peut restreindre une recherche à une catégorie en utilisant l'arborescence des catégories de votre boutique.
Ajout au panier - Les fiches produits dans le chat peuvent afficher un bouton Add to cart (Ajouter au panier). Lorsque le chatbot fonctionne sur votre Instant Site, ou sur un site web où votre boutique Ecwid est intégrée, le bouton place le produit directement dans le panier Ecwid du client. Pour les produits comportant des options comme la taille ou la couleur, le client choisit d'abord la variante dans le chat. Partout ailleurs, et pour les produits dont les options ne peuvent pas être renseignées dans le chat (par exemple un champ texte pour une gravure), le bouton ouvre la page du produit.
Découvrez l'expérience du panier
Pour un exemple de panier et des instructions de test sur la vitrine, consultez Ajouter des produits au panier. La séquence ci-dessous est illustrative ; elle n'exécute pas une réelle opération de panier Ecwid.
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 l'achat dans votre boutique Ecwid.
- Les alertes de stock en temps réel. Les prix et la disponibilité sont lus depuis Ecwid lorsque le chatbot répond, mais le chatbot n'informe pas les clients des modifications ultérieures.
Prérequis
- Une boutique Ecwid sur le forfait Venture, Business ou Unlimited. Ecwid active l'accès à l'API à partir du forfait Venture ; le forfait Starter ne peut pas être connecté.
- L'intégration Ecwid 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 activés. Vérifiez la capacité disponible dans Shop (Boutique) > Products (Produits).
- Aucune autre intégration de boutique connectée au même chatbot.
Étape 1 : Obtenir l'identifiant de la boutique (Store ID) et le jeton secret dans Ecwid
- Connectez-vous à votre panneau d'administration Ecwid.
- Dans le menu de gauche, cliquez sur Apps (Applications), puis sur My Apps (Mes applications), et ouvrez Develop apps (Développer des applications) (ou allez directement sur
https://my.ecwid.com/#develop-appsen étant connecté). - Si aucune application personnalisée n'est encore listée, cliquez sur Create app (Créer une application). Ecwid crée l'application avec les autorisations dont le chatbot a besoin : lire le profil de la boutique, lire le catalogue et lire les commandes. Si l'écran affiche une liste d'autorisations, assurez-vous que ces trois options sont cochées.
- Ouvrez la page Details (Détails) de l'application et cliquez sur Show secret token (Afficher le jeton secret). Copiez le jeton. Il commence par
secret_. N'utilisez pas le jeton public, qui commence parpublic_. - Notez votre Store ID. Il s'agit du numéro affiché dans le pied de page de chaque page de votre administration Ecwid et dans la barre d'adresse du panneau.
Gardez le jeton secret confidentiel. Il donne un accès en lecture à votre catalogue et à vos commandes. Vous pouvez le révoquer à tout moment en désinstallant l'application dans Apps > My Apps ; la réinstaller génère un nouveau jeton.
Étape 2 : Connecter la boutique dans ChatLab
- Ouvrez votre chatbot dans ChatLab et allez dans Shop.
- Cliquez sur la tuile Ecwid.
- Collez le Store ID et le Secret token.
- Cliquez sur Check connection (Vérifier la connexion). ChatLab lit le profil de la boutique et affiche son nom, l'adresse de la vitrine et la devise.
- Si votre boutique comporte plusieurs langues, choisissez la Shop Language (Langue de la boutique) que le chatbot doit utiliser pour les noms et descriptions de produits.
- Cliquez sur Connect (Connecter).
ChatLab teste la connexion et active les actions de recherche de produits et de statut de commande. Lorsque la 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. Le jeton secret est stocké de manière chiffrée et n'est plus jamais affiché ; laissez le champ du jeton vide si vous souhaitez uniquement modifier la langue.
Étape 3 : Configurer les actions
Allez dans Settings (Paramètres) > AI Actions (Actions IA). Trois actions sont disponibles pour Ecwid :
- Ecwid - AI product search - recherche sémantique sur 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.
- Ecwid - product search - recherche par mots-clés via le moteur de recherche d'Ecwid, utilisée lorsque 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.
- Ecwid - order details - consultation du statut de commande. La 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'un libellé d'action affiché dans le chat pendant que le chatbot travaille.
Étape 4 : Vérifier le catalogue
Ouvrez Training (Entraînement) > E-commerce catalog (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. Seuls les produits modifiés depuis la dernière exécution sont réindexés. Les produits désactivés sont automatiquement retirés de l'index.
Les produits sans description sont indexés uniquement par leur nom, leurs catégories et leurs attributs. Si vos produits n'ont pas de description dans Ecwid, en ajouter ne serait-ce qu'une courte améliore nettement les résultats de recherche.
Étape 5 : Ajouter le chatbot à votre vitrine
L'intégration Ecwid connecte le chatbot aux données de votre boutique. Pour afficher le chatbot à vos clients, ajoutez le script ChatLab au site web où se trouve la boutique :
Instant Site (nécessite le forfait Venture, Business ou Unlimited) :
- Dans ChatLab, ouvrez votre chatbot, accédez à Test & Deploy (Tester et déployer), choisissez Ecwid et copiez le code.
- Dans votre administration Ecwid, accédez à Website > Overview (Site web > Aperçu).
- Faites défiler vers le bas jusqu'à Advanced website settings (Paramètres avancés du site web) et cliquez sur Add Code (Ajouter du code) sous Custom JavaScript code (Code JavaScript personnalisé).
- Collez le code dans le champ qui s'ouvre et cliquez sur Save (Enregistrer).
- Actualisez votre Instant Site - le chatbot apparaît dans le coin inférieur de chaque page.
Ecwid recommande la section body (Custom JavaScript code) pour les widgets de chat. N'utilisez pas Header meta tags and site verification dans les paramètres SEO - ce champ est réservé aux balises de vérification.
Boutique intégrée sur un autre site web (WordPress, Wix, Squarespace et autres) : ajoutez le code à ce site web, exactement comme décrit dans Ajouter un chatbot à votre site web. Le chatbot apparaît alors sur chaque page de ce site web, et pas seulement sur la page de la boutique.
Résolution des problèmes
- « Ecwid a rejeté le jeton secret » - Le jeton n'a pas été copié intégralement, ou l'application a été désinstallée puis réinstallée dans Ecwid, ce qui génère un nouveau jeton. Ouvrez à nouveau la page Details de l'application et collez le jeton actuel.
- « Le forfait de la boutique Ecwid n'inclut pas l'accès à l'API » - La boutique utilise le forfait Starter. Passez au forfait Venture ou supérieur dans Ecwid.
- 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 activés dans Ecwid. Les produits désactivés ne sont jamais renvoyés.
- 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, y compris tout préfixe ou suffixe que votre boutique ajoute aux numéros de commande.