Intégration avec PrestaShop : AI Search, recherche en direct dans la boutique et statut de commande

Connectez votre chatbot ChatLab à votre boutique PrestaShop afin que les clients puissent trouver des produits et vérifier leurs commandes directement dans le chat. Les produits sont trouvés via AI Search, qui recherche dans votre catalogue PrestaShop indexé par le sens, ou via la recherche en direct dans la boutique, qui interroge l'API de la 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 pour l'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

Comment le chatbot trouve les produits sur PrestaShop : 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 PrestaShop. Un chatbot utilise l'une ou l'autre, jamais les deux.

AI Search (recommandé) - ChatLab conserve son propre index de votre catalogue PrestaShop et le chatbot y effectue des recherches par 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 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 PrestaShop au moment de la réponse, 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 dès que 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, Start 2 000, Grow 5 000, 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 l'expression du client au moteur de recherche de PrestaShop via l'API de la boutique et répond avec les résultats renvoyés par la boutique.

• 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 de besoins, les synonymes ou les fautes de frappe comme le fait 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 statut des commandes fonctionne de la même manière dans les deux cas. 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 E-commerce et limites.

Ce qu'offre l'intégration

Recherche en direct dans la boutique (recherche de produits par expression) - Le chatbot transmet la recherche du client au moteur de recherche de PrestaShop. Il cherche dans les titres et les descriptions des produits, puis renvoie les 5 meilleurs résultats correspondants avec :

• L'identifiant (ID), le nom et la description du produit
• Le prix (avec possibilité d'inclure les taxes et les réductions de prix spécifiques appliquées)
• Le lien direct vers la page du produit dans votre boutique
• L'image du produit

Recherche de produit par référence (SKU) - Les clients peuvent rechercher des produits à l'aide de codes de référence exacts. Le chatbot effectue la recherche parmi plusieurs types d'identifiants - référence/SKU, code-barres EAN-13, ISBN et MPN - aussi bien sur les produits que sur leurs déclinaisons. Cela s'avère particulièrement utile lorsque les clients disposent d'un code produit précis issu d'un catalogue, d'une facture ou d'un emballage.

Détails de la commande - Par défaut, les clients fournissent un identifiant de commande (Order ID) ainsi que l'adresse e-mail associée à celle-ci. Les deux éléments sont comparés aux données de la boutique ; cela ne constitue pas une preuve de possession de l'adresse e-mail. Le paramètre optionnel Allow order lookup without email verification (autoriser la recherche de commande sans vérification par e-mail) permet une recherche uniquement à l'aide de l'identifiant de commande. Laissez cette option désactivée, sauf si votre environnement dispose de contrôles d'accès appropriés. Le chatbot renvoie :

• La référence, la date et le statut actuel de la commande (ex. en cours de traitement, terminée, annulée)
• Le montant total de la commande
• Le nom du destinataire, l'entreprise, l'adresse de livraison complète (rue, ville, code postal) et le numéro de téléphone
• Le nom du transporteur et les numéros de suivi (la gestion de plusieurs numéros de suivi est prise en charge)
• Les articles commandés avec leurs noms, quantités et prix unitaires

Prérequis

Avant de commencer l'intégration PrestaShop, assurez-vous que :

• Votre chatbot est créé dans ChatLab. La connexion des données de la boutique et l'installation du widget sont des étapes distinctes ; le module peut gérer les deux.
• Vous avez accès à votre panneau d'administration PrestaShop (back-office)

Recommandé : connecter avec le module

Pour une nouvelle installation, utilisez la configuration guidée du module PrestaShop. Connect my store (Connecter ma boutique) vous permet de vous connecter à ChatLab et de sélectionner votre chatbot. Les étapes manuelles de webservice ci-dessous sont une alternative ; ne créez pas de deuxième connexion si le module a déjà connecté la boutique.

Étape 1 : Activer le service web dans PrestaShop

1. Connectez-vous à votre back-office PrestaShop
2. Accédez à Configure > Advanced Parameters > Webservice (Configurer > Paramètres avancés > Service web)

3. Faites défiler jusqu'à la section Configuration
4. Définissez Enable PrestaShop's webservice (Activer le service web de PrestaShop) sur Yes (Oui)
5. Cliquez sur Save (Enregistrer)

Étape 2 : Créer une clé de webservice

1. Sur la même page Webservice, cliquez sur Add new webservice key (Ajouter une clé de webservice)

2. Cliquez sur Generate (Générer) pour créer une nouvelle clé
3. Saisissez une description (par exemple, "ChatLab Integration")
4. Assurez-vous que la clé est activée (Enabled)
5. Sous les autorisations de ressources, accordez l'accès View (GET) (Afficher - GET) aux ressources suivantes :
   • addresses
   • attachments
   • carriers
   • categories
   • combinations
   • configurations
   • customers
   • languages
   • order_carriers
   • order_details
   • order_states
   • orders
   • product_customization_fields
   • product_feature_values
   • product_features
   • product_option_values
   • product_options
   • products
   • search
   • specific_price_rules
   • specific_prices
   • states
   • shops
   • stock_availables
   • tags
   • tax_rule_groups
   • tax_rules
   • taxes

6. Cliquez sur Save (Enregistrer)
7. Copiez la clé de webservice générée - vous en aurez besoin à l'étape suivante

Étape 3 : Trouvez le format d'URL de vos produits

1. Dans le back-office de PrestaShop, allez dans Configure > Shop Parameters > Traffic & SEO (Configurer > Paramètres de la boutique > Trafic et SEO)

2. Faites défiler vers le bas jusqu'à la section Schema of URLs (Format des URL)
3. Copiez la valeur du champ Route to products (Route vers les produits, par exemple {category:/}{id}{-:id_product_attribute}-{rewrite}{-:tags}.html)

Étape 4 : Connecter PrestaShop dans ChatLab

1. Connectez-vous à ChatLab et sélectionnez votre bot
2. Accédez à l'onglet Connect (Connecter)

3. Cliquez sur Connect sur la vignette PrestaShop
4. Saisissez votre Webservice key (clé webservice de l'étape 2)
5. Saisissez votre Shop url (l'URL complète de votre boutique, par ex. https://www.mystore.com)
6. Saisissez votre Product url format (format d'URL de produit de l'étape 3)

7. Cliquez sur Initialize Configuration (Initialiser la configuration) - cela récupère les langues et les boutiques disponibles dans votre boutique
8. Sélectionnez la bonne Default language (langue par défaut) et, si cela vous est proposé, la Prestashop store (boutique PrestaShop) souhaitée
9. Cliquez sur Connect

ChatLab teste automatiquement la connexion en vérifiant que votre clé webservice dispose des autorisations requises. En cas de succès, un message de confirmation s'affiche.

Étape 5 : Configurer les actions PrestaShop

Une fois la connexion établie, vous pouvez activer et personnaliser les différentes actions IA. Rendez-vous dans Settings > Actions (Paramètres > Actions) et filtrez selon la plateforme PrestaShop.

Les actions suivantes sont disponibles :

• Prestashop - product search - permet au chatbot de rechercher dans votre catalogue de produits par nom
• Prestashop - search by reference - permet au chatbot de trouver des produits par référence/SKU, code EAN-13, ISBN ou MPN
• Prestashop - order details - permet au chatbot de consulter les informations des commandes
• Prestashop - get product variants - permet au chatbot de récupérer les informations détaillées des variantes (tailles, couleurs) pour un produit spécifique

La configuration de la connexion active les actions standards. Vérifiez leur statut et désactivez celles que vous ne souhaitez pas mettre à la 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 son exécution) ainsi que les instructions qui guident la manière dont l'IA utilise chaque action.

Lorsque l'action « Search by reference » est activée, la recherche de produits classique bascule aussi automatiquement vers une recherche par code de référence si aucun résultat n'est trouvé par nom. Les clients peuvent ainsi saisir un SKU ou un code-barres dans une recherche classique tout en obtenant des résultats précis.

Afficher les produits avec date de réapprovisionnement (Précommande)

Lorsque l'option « Products in stock only » (Produits en stock uniquement) est activée dans les paramètres de l'action Product Search, vous pouvez également activer « Show products with restock date » (Afficher les produits avec date de réapprovisionnement). Cela permet au chatbot d'inclure les produits en rupture de stock ayant une date de réapprovisionnement prévue définie dans PrestaShop. Au lieu de masquer entièrement ces produits, le chatbot informe le client de la date de réapprovisionnement et de la possibilité de précommander le produit.

Prérequis :

• PrestaShop doit avoir l'option « Autoriser la commande de produits hors stock » activée (Paramètres de la boutique > Produits / Shop Parameters > Product Settings)
• La clé webservice doit disposer des autorisations de consultation (GET) sur les ressources combinations et configurations
• Les produits doivent avoir une available_date définie sur leurs déclinaisons dans PrestaShop

Prix toutes taxes comprises (TTC)

Activez l'option « Apply tax (VAT) to prices » (Appliquer la taxe (TVA) aux prix) dans les paramètres de l'action Product Search pour afficher les prix toutes taxes comprises. Une fois l'option activée, le chatbot calcule les prix à l'aide des règles fiscales de votre boutique PrestaShop basées sur le pays par défaut de la boutique. Comparez le résultat avec votre vitrine. Les règles fiscales propres aux clients, la localisation et les ajustements lors du paiement peuvent générer des totaux différents.

Prérequis :

• La clé webservice doit disposer des autorisations de consultation (GET) sur les ressources taxes, tax_rules, tax_rule_groups et configurations

Prix spécifiques (Réductions et promotions)

Activez l'option « Apply specific prices (discounts/promotions) » (Appliquer les prix spécifiques (réductions/promotions)) dans les paramètres de l'action Product Search afin d'afficher les prix réduits issus des règles de prix spécifiques de PrestaShop. Lorsqu'une réduction est active pour un produit, le chatbot affiche à la fois le prix réduit et le prix initial, afin que les clients visualisent les économies réalisées.

Cela couvre les règles universelles de prix spécifiques - les promotions et soldes applicables à tous les clients avec une quantité minimale de 1. Les promotions limitées dans le temps sont également prises en charge ; le chatbot applique uniquement les réductions en cours de validité selon leurs dates de début et de fin.

Prérequis :

• La clé webservice doit disposer des autorisations de consultation (GET) sur les ressources specific_prices et specific_price_rules

AI Search pour PrestaShop : 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 lorsque 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 (Boutique > Produits) affiche le panneau Product catalog (Catalogue de produits) et 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 (Entraînement > Catalogue e-commerce). La réindexation peut s'exécuter jusqu'à une fois par jour et est disponible avec chaque forfait E-commerce ainsi qu'avec chaque pack de produits. Train now (Entraîner maintenant) ou Retrain (Réentraîner) la lance à 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 Prestashop - AI product search. Ses options sont Include product card, Products in stock only et Number of products to return.
• Afficher les fiches produits - activez Enable 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 Overview (Aperçu) et essayez :

• « Montre-moi des chaussures de course » (teste la recherche de produits)
• « Je cherche le produit ABC-12345 » (teste la recherche par référence/SKU)
• « 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 PrestaShop, que les liens vers les produits s'ouvrent correctement et que les prix incluent les taxes et les réductions lorsque ces options sont activées.

Installer le chatbot sur votre boutique PrestaShop

Pour ajouter le widget de chat à votre boutique PrestaShop, consultez le guide détaillé : Installer le chatbot sur une boutique PrestaShop

Articles connexes

• AI Search : comment votre chatbot trouve des produits
• Forfaits et limites e-commerce
• Guide de configuration e-commerce
• Ajouter un chatbot à votre site web