Connectez votre chatbot ChatLab à votre boutique Shoper afin que vos clients puissent trouver des produits et vérifier leurs commandes directement dans le chat. Les produits sont trouvés via la recherche sémantique AI Search, qui explore votre catalogue Shoper indexé selon le sens des requêtes, ou via la recherche directe en boutique, qui interroge l'API du magasin.
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.
Important : bonnes pratiques e-commerce
Après avoir terminé l'intégration ci-dessous, consultez le guide complet pour optimiser votre chatbot pour l'e-commerce : Comment configurer ChatLab pour votre boutique e-commerce
Comment le chatbot trouve les produits sur Shoper : AI Search et recherche en direct dans la boutique
Il existe deux façons pour un chatbot ChatLab de trouver des produits dans une boutique Shoper. Un chatbot utilise l'une ou l'autre, jamais les deux.
AI Search (recommandé) - ChatLab conserve son propre index de votre catalogue Shoper et le chatbot y effectue des recherches par le sens.
- Les clients posent leurs questions en langage naturel, par exemple « une robe rouge à moins de 300 ». Une fourchette de prix est appliquée comme un 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 Shoper au moment de répondre, afin que les clients voient des données à jour, même entre deux actualisations 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 n'utilise pas de caractères d'entraînement.
- Forfait requis : chaque forfait E-commerce l'inclut (Free 100 produits, E-commerce Start 2 000, E-commerce Grow 5 000, E-commerce Scale 20 000). Sur un forfait Universal, ajoutez le module complémentaire d'intégrations e-commerce (30 $ par mois) ainsi qu'un pack de produits AI Search (29 $ par mois, 5 000 produits) attribué au chatbot.
Recherche en direct dans la boutique - le chatbot transmet la requête du client au moteur de recherche de Shoper via l'API de la boutique et répond avec ce que la boutique renvoie.
- Rien n'est indexé et rien n'a besoin d'être synchronisé. Les données sont toujours en direct.
- 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 de la même manière qu'AI Search.
- Forfait requis : un forfait Universal avec le module complémentaire d'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 de commande fonctionne de la même manière sur les deux parcours. Une troisième option, l'entraînement sur les pages analysées de la boutique, est disponible sur tous les forfaits et s'adresse aux contenus informatifs tels que la livraison et les retours, et non aux produits. Pour une comparaison complète, consultez AI Search : comment votre chatbot trouve les produits, et pour les limites de produits, consultez Forfaits et limites E-commerce.
Ce que propose l'intégration
Recherche en direct dans la boutique (recherche de produits par expression) - Le chatbot envoie l'expression du client vers la recherche Shoper. Il recherche parmi les noms de produits à l'aide d'une recherche approximative (fuzzy matching), en renvoyant jusqu'à 10 produits correspondants avec :
- Nom et description du produit
- Prix et référence (SKU)
- Lien direct vers la page du produit dans votre boutique
- Image du produit
- État des stocks
- En option : pièces jointes du produit (PDF, documents)
Vous pouvez également activer le filtre en stock pour ne renvoyer que les produits actuellement disponibles.
Détails de la commande - Les clients peuvent vérifier le statut de leur commande en fournissant un identifiant de commande et l'adresse e-mail associée à la commande. Ces deux valeurs sont validées par rapport aux dossiers de votre boutique Shoper. Le chatbot renvoie :
- Identifiant de commande, date et statut actuel
- Montant total de la commande et devise
- Articles commandés avec noms, quantités et prix
- Adresse de livraison (rue, ville, code postal, pays, téléphone)
- Adresse de facturation
- Notes de commande
Deux façons de connecter votre boutique
Il existe deux façons de connecter Shoper à ChatLab :
- Méthode 1 : application ChatLab depuis le Shoper App Store (recommandé) - installation en un clic. L'application crée la connexion, active la recherche de produits ainsi que les détails des commandes, et ajoute le widget de chat à votre vitrine. Aucune clé API à copier.
- Méthode 2 : configuration manuelle - vous créez un administrateur WebAPI dans Shoper et saisissez ses identifiants dans ChatLab. Utilisez cette méthode uniquement si vous ne pouvez pas installer l'application, ou si vous souhaitez connecter la boutique à un chatbot que vous gérez d'une manière spécifique.
Choisissez une seule méthode. Ne créez pas de seconde connexion avec la Méthode 2 si l'application a déjà connecté la boutique.
Méthode 1 : Installer l'application ChatLab depuis le Shoper App Store
L'application gratuite ChatLab app in the Shoper App Store (application ChatLab dans le Shoper App Store) est le moyen le plus rapide de commencer. Vous n'avez pas besoin d'un compte ChatLab ou d'un chatbot existant - les deux sont créés pour vous pendant l'installation.
- Dans votre panneau d'administration Shoper, accédez à Add-ons and integrations > Applications (Modules complémentaires et intégrations > Applications), recherchez ChatLab - AI Chatbot for Customer Support and Sales et installez-la
- Ouvrez l'application ChatLab dans votre panneau d'administration Shoper - le panneau ChatLab s'ouvre dans une nouvelle fenêtre
- Définissez votre mot de passe (nouveau compte) ou connectez-vous avec votre compte ChatLab existant
- Si vous avez commencé dans l'assistant de configuration du chatbot, confirmez la connexion de la boutique à ce chatbot ; sinon, un chatbot pour la boutique est créé sur votre compte
- Choisissez un forfait ou restez sur le forfait gratuit - vous pourrez passer à une formule supérieure plus tard dans Account > Subscription (Compte > Abonnement)
C'est tout. La boutique est connectée, les actions de recherche de produits et de détails des commandes sont activées, et le chatbot apparaît sur votre boutique dès que la connexion est établie. Poursuivez avec Configure Shoper Actions ci-dessous pour vérifier les actions, ou ouvrez Test & Deploy > Shoper dans ChatLab pour revoir les mêmes étapes d'installation.
Méthode 2 : Configuration manuelle
Utilisez cette méthode lorsque vous ne pouvez pas installer l'application. Avant de commencer, assurez-vous que :
- Votre abonnement ChatLab inclut l'intégration Shoper
- Vous avez accès à votre panneau d'administration Shoper
- Votre chatbot est déjà créé dans ChatLab
La configuration manuelle connecte uniquement les données de la boutique. Le widget de chat doit être ajouté séparément à votre vitrine, voir Installer le chatbot sur votre boutique Shoper à la fin de cet article.
Étape 1 : Créer un groupe d'administrateurs
- Dans votre panneau d'administration Shoper, allez dans Paramètres > Administrateurs de la boutique (Settings > Store administrators)
- Cliquez sur PLUS (MORE) > Ajouter un groupe d'administrateurs (Add administrators group)
- Entrez un nom pour le groupe (par ex., « ChatLab Integration »), sélectionnez le type d'accès : « accès au webapi » ('access to webapi') et enregistrez
Étape 2 : Configurer les autorisations du groupe
- Ouvrez le groupe nouvellement créé et allez dans les paramètres des autorisations
- Accordez l'accès en Lecture (Read) aux ressources suivantes :
- Ventes (Sales) - lecture
- Catalogue (Catalog) - lecture
- Configuration - lecture
Étape 3 : Ajouter un administrateur API
- Allez dans Administrateurs (Administrators) et cliquez sur Ajouter un administrateur (Add administrator)
- Renseignez l'identifiant et le mot de passe, puis assignez l'administrateur au groupe créé à l'étape 1
- Enregistrez l'administrateur. Notez bien l'identifiant (login) et le mot de passe (password) - vous en aurez besoin à l'étape suivante.
Étape 4 : Connecter Shoper dans ChatLab
- Connectez-vous à ChatLab et sélectionnez votre bot
- Allez dans l'onglet Connect
- Cliquez sur Connect sur la vignette Shoper
- Entrez votre Shop URL (votre domaine Shoper, par ex.
myshop.shoper.pl) - Entrez votre WebAPI Login (issu de l'étape 3)
- Entrez votre WebAPI Password (issu de l'étape 3)
- Cliquez sur Initialize Configuration - cela récupère les langues disponibles dans votre boutique
- Sélectionnez la bonne Shop Language dans le menu déroulant (cela détermine la version linguistique des données produit renvoyées)
- Cliquez sur Connect
ChatLab teste automatiquement la connexion en effectuant une recherche de produit test. En cas de succès, un message de confirmation s'affiche et les actions de recherche de produits ainsi que de détails de commande sont activées par défaut.
Configurer les actions Shoper
Après vous être connecté avec l'une ou l'autre méthode, vous pouvez activer et personnaliser les actions IA individuelles. Rendez-vous dans Settings > Actions (Paramètres > Actions) et filtrez par la plateforme Shoper.
Les actions standard incluent :
- Shoper - product search - permet au chatbot de rechercher dans votre catalogue de produits
- Shoper - order details - permet au chatbot de consulter les informations sur les commandes
La configuration de la connexion active les actions standard. Vérifiez leur statut 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 personnaliser le libellé de l'action (le message affiché aux utilisateurs pendant l'exécution de l'action) ainsi que les instructions qui guident la façon dont l'IA utilise chaque action.
Pour la recherche de produits, cliquez sur le bouton Edit (Modifier) et accédez à l'onglet Product Search Settings (Paramètres de recherche de produits). Deux options supplémentaires sont disponibles :
- Include product attachments - lorsqu'elle est activée, le chatbot inclut les fichiers joints aux produits (PDF, documents) dans les résultats de recherche
- Products in stock only - lorsqu'elle est activée, le chatbot ne renvoie que les produits actuellement en stock
AI Search pour Shoper : catalogue, réindexation et paramètres
Avec un forfait E-commerce, ou avec un forfait 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). La section Shop > Products affiche le panneau Product catalog (Catalogue de produits) ainsi que la carte AI Search packs on this chatbot (Packs AI Search sur ce chatbot).
- Programmer la réindexation - utilisez Schedule auto-retrain (Programmer le réentraînement automatique) dans Training > E-commerce catalog. La réindexation peut s'exécuter jusqu'à une fois par jour et est disponible sur tous les forfaits E-commerce ainsi qu'avec chaque pack de produits. Le bouton Train now (Entraîner maintenant) ou Retrain (Réentraîner) lance l'opération à la demande. Les actualisations 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 (Paramètres > Actions), ouvrez Shoper - AI product search (Shoper - Recherche de produits par IA). 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 (Activer Offer Cards) dans Settings > Model & Advanced (Paramètres > Modèle et paramètres avancés). Consultez Offer Cards.
Lorsque le catalogue dépasse la limite de produits, l'indexation s'arrête à cette limite et le propriétaire du chatbot reçoit un e-mail. Les options de l'action de recherche en direct dans la boutique décrites ci-dessus ne s'appliquent pas nécessairement à AI Search.
Tester votre intégration
Après avoir activé les actions, ouvrez Test & Deploy (Tester et déployer) et essayez :
- « Montre-moi des chaussures de course » (teste la recherche de produits)
- « Quel est le statut de ma commande 12345 ? » (teste les détails de la commande ; fournissez l'adresse e-mail correspondante pour une commande à laquelle vous êtes autorisé à accéder)
Vérifiez que les réponses correspondent aux données de votre boutique Shoper et que les liens vers les produits s'ouvrent correctement.
Installer le chatbot sur votre boutique Shoper
Si vous avez utilisé la méthode 1 (l'application), le widget de chat est déjà installé sur votre boutique et vous n'avez rien à ajouter. Si vous avez utilisé la méthode 2 (configuration manuelle), ouvrez Test & Deploy > Shoper dans ChatLab, passez à Manual Installation (Installation manuelle), copiez le code et collez-le dans votre panneau d'administration Shoper sous Add-ons and integrations > Custom integrations (Modules et intégrations > Intégrations personnalisées) dans le champ Page header (En-tête de page). Consultez Ajouter un chatbot à votre site web pour plus de détails.