Module Magento 2 – Demander un produit

Kowal_ZapytajOProdukt est un module Magento 2 avancé pour la communication avec le client sur la fiche produit. Il réunit un formulaire classique de questions, une FAQ structurée et un Assistant IA dans une solution unique et cohérente.

Concrètement, cela signifie que la fiche produit ne se limite plus à présenter une description et des paramètres techniques, mais devient un véritable point de prise en charge des questions client. L’utilisateur peut :

• poser une question classique sur le produit,
• consulter les réponses prêtes à l’emploi publiées dans la FAQ,
• échanger avec l’Assistant IA, qui répond dans le contexte du produit actuellement consulté.

Le module a été conçu pour résoudre deux problèmes à la fois :

• un problème de support, en réduisant le nombre de questions répétitives envoyées à l’équipe de la boutique,
• un problème produit, en construisant une base de connaissances croissante et structurée qui améliore progressivement la qualité des réponses.

Objectif métier

Dans de nombreuses boutiques en ligne, une grande partie des questions des clients se répète :

• le produit est-il compatible avec une version précise de Magento,
• fonctionne-t-il sans module supplémentaire,
• comment se déroule l’installation,
• prend-il en charge plusieurs langues,
• nécessite-t-il des modifications personnalisées du thème,
• comment se comporte-t-il dans un scénario métier précis.

Sans outil dédié, ce type de questions :

• alourdit le support,
• ralentit les décisions d’achat,
• disperse les connaissances entre les boîtes e-mail, les tickets et les échanges commerciaux,
• ne revient pas dans la boutique sous forme de FAQ structurée.

Ce module organise ce processus. Il collecte d’abord les questions et les réponses, les structure ensuite dans une FAQ, puis les utilise comme contexte pour l’Assistant IA ainsi que pour la couche de retrieval basée sur OpenAI Vector Store.

Idée principale de la solution

Le module fonctionne par couches.

Couche 1. Questions classiques sur le produit

Sur la fiche produit, il est possible d’activer un mécanisme standard de questions. Le client envoie une demande, puis l’administrateur ou le service client de la boutique la reçoit pour traitement. C’est la forme de contact la plus simple et la plus prévisible.

Couche 2. FAQ

Les questions et réponses récurrentes peuvent être enregistrées et publiées comme FAQ du produit. La FAQ peut être affichée sous forme d’onglet ou de section séparée sur la page produit. Ainsi, les utilisateurs suivants obtiennent une réponse sans devoir envoyer une nouvelle question.

Couche 3. Assistant IA

Au-dessus ou au-dessous de la FAQ standard apparaît un composant léger de conversation avec l’IA. L’utilisateur peut :

• cliquer sur l’une des questions populaires,
• saisir sa propre question dans le champ Zapytaj Asystenta o ten produkt.,
• voir la réponse dans la même zone de conversation.

L’Assistant ne fonctionne pas comme un chatbot général de la boutique. Il a été conçu comme un assistant produit, ce qui signifie que la réponse doit s’appuyer avant tout sur :

• les données du produit actuel,
• les FAQ publiées,
• l’historique de la conversation en cours,
• éventuellement les résultats de retrieval depuis OpenAI Vector Store.

Périmètre fonctionnel du module

1. Formulaire Zapytaj o produkt

Le module met à disposition un mécanisme classique de contact avec le client.

Éléments principaux :

• bouton ou formulaire Zapytaj o produkt sur la page produit,
• prise en charge AJAX côté frontend,
• enregistrement de la question dans la base de données,
• possibilité d’envoyer une notification e-mail,
• option d’activer le module globalement ou uniquement pour certains produits.

Cette solution reste pertinente même lorsque la boutique utilise déjà l’Assistant IA. Toutes les questions ne doivent pas être traitées automatiquement. Certaines demandes nécessitent une réponse commerciale, un devis personnalisé ou une confirmation par l’équipe technique.

2. FAQ sur la fiche produit

Dans ce module, la FAQ n’est pas un simple ajout marketing, mais une couche structurée de connaissances sur le produit.

L’administrateur peut :

• consulter les questions enregistrées,
• ajouter des réponses,
• publier les enregistrements sélectionnés,
• les afficher sur la page produit.

La FAQ peut être présentée :

• sous forme d’onglet,
• comme section séparée sur la fiche produit.

Il est important de noter que la FAQ ne sert pas uniquement au frontend. Les questions et réponses publiées sont également utilisées comme l’un des éléments de contexte les plus importants pour l’Assistant IA.

3. Assistant IA sur la page produit

L’Assistant IA est l’élément central de l’évolution du module.

Le composant est intégré à la fiche produit, par défaut sous la galerie, et a été préparé pour :

• fonctionner de manière légère côté frontend,
• ne pas alourdir inutilement le premier rendu de la page,
• être lisible sur desktop et mobile,
• se prêter à des extensions futures.

L’utilisateur voit :

• le titre de la section,
• un texte d’introduction,
• un champ texte unique pour poser une question,
• la liste des questions les plus populaires,
• une zone de conversation qui se développe au fil des questions et réponses.

Dans la version actuelle, le formulaire prend également en charge :

• l’historique de conversation dans le cadre de la session,
• les questions populaires cliquables,
• le feedback sur les réponses de l’IA,
• deux variantes de couleurs : claire et sombre.

4. Questions populaires

Sous le champ texte peuvent être affichées les questions les plus populaires sur le produit.

Cette solution remplit plusieurs fonctions à la fois :

• elle accélère le démarrage de la conversation,
• elle suggère au client les sujets les plus souvent demandés par les autres,
• elle permet d’utiliser des réponses FAQ prêtes sans coût de requête vers le modèle IA,
• elle améliore l’UX et réduit le nombre d’interactions vides.

La popularité des questions ne repose plus uniquement sur un ordre manuel. Le module collecte des données sur les clics, les questions posées et le feedback, puis classe les FAQ sur cette base.

5. Contexte des réponses IA

L’hypothèse de conception la plus importante était que l’IA ne réponde pas hors du contexte du produit.

La réponse peut être construite à partir de plusieurs sources :

• données de base du produit,
• short description,
• full description,
• attributs produit sélectionnés,
• FAQ publiées,
• historique de conversation.

Le module permet en outre de limiter les attributs transmis au modèle, afin d’éviter :

• la surcharge du prompt,
• l’envoi de données inutiles,
• un coût trop élevé en tokens,
• la transmission accidentelle de contenus qui ne sont pas utiles au client.

6. Intégration avec OpenAI Responses API et Vector Store

L’un des éléments clés de l’extension est l’intégration avec OpenAI Responses API.

Dans les scénarios les plus simples, le module peut fonctionner en mode de contexte local du produit et de la FAQ. Dans les déploiements plus avancés, il prend en charge :

• file_search,
• vector_store_ids,
• le filtrage par sku,
• le filtrage par product_sku,
• le filtrage par store_code,
• le filtrage par content_type,
• la limitation du nombre de résultats de retrieval,
• le mode hybrid,
• le mode retrieval-first.

Cela signifie que la réponse IA peut s’appuyer non seulement sur les données transmises directement depuis Magento lors d’une requête donnée, mais aussi sur des documents déjà alimentés auparavant dans Vector Store.

En pratique, cela apporte deux avantages :

• un coût plus faible, car il n’est pas nécessaire d’envoyer à chaque fois l’ensemble complet des données au modèle,
• une meilleure scalabilité, car le retrieval peut gérer une base de connaissances plus vaste qu’un simple prompt avec un JSON local.

7. Intégration avec Kowal_AiProductFeed

Le module a été préparé pour fonctionner avec Kowal_AiProductFeed.

Cette intégration permet de :

• synchroniser les données produit vers OpenAI Vector Store,
• utiliser des documents de type product.core, product.faq, product.docs et autres,
• resynchroniser un produit sélectionné avant la conversation,
• limiter le retrieval à des types de contenu précis.

Cette approche est particulièrement utile lorsque :

• les descriptions produit sont longues,
• la FAQ est développée,
• la boutique gère de nombreux produits techniques,
• les données produit sont constamment enrichies.

8. Analytique et feedback

Le module ne s’arrête pas à la simple génération d’une réponse.

Il enregistre également des données permettant d’évaluer si la solution fonctionne :

• le nombre de clics dans la FAQ,
• le nombre de questions posées,
• les évaluations utile / inutile,
• l’historique des conversations,
• les métadonnées techniques des réponses IA,
• l’usage des tokens,
• le payload de la requête et de la réponse, si vous activez la journalisation de diagnostic.

Ainsi, le déploiement n’est pas une boîte noire. L’équipe peut analyser :

• quelles questions apparaissent le plus souvent,
• si l’IA utilise le retrieval,
• si les réponses sont pertinentes,
• quels enregistrements méritent d’être consolidés comme FAQ,
• comment le coût et la qualité évoluent après une modification du prompt ou de la configuration.

9. Candidats FAQ et workflow administratif

L’un des principaux avantages du module est la possibilité de transformer les conversations en nouvelles FAQ.

Le processus se présente comme suit :

1. Les clients posent des questions.
2. Le module enregistre les conversations.
3. Le mécanisme d’analyse identifie les candidats FAQ.
4. L’administrateur examine les candidats dans le panneau.
5. Après validation, le candidat est ajouté à la FAQ standard du produit.

C’est un modèle de travail très pratique, car les connaissances ne se perdent pas dans l’historique des conversations. À chaque nouvelle itération, la boutique construit une meilleure couche de réponses :

• pour les clients,
• pour la FAQ,
• pour l’Assistant IA,
• pour le futur retrieval.

10. Sécurité et contrôle

Le module a été conçu de manière à ce que son fonctionnement puisse être contrôlé.

La configuration comprend notamment :

• des restrictions d’accès pour les invités,
• le TTL des conversations,
• des limites de requêtes,
• la sanitization des données d’entrée,
• des options de journalisation de diagnostic,
• la configuration reCAPTCHA,
• le périmètre contrôlé des données envoyées au modèle.

C’est important, car le déploiement de l’IA sur une page produit ne doit pas signifier une perte de contrôle sur :

• le coût,
• les données,
• la qualité des réponses,
• la charge du frontend.

11. À qui s’adresse ce module

Le module est particulièrement adapté aux projets dans lesquels :

• le catalogue est plus vaste que quelques produits simples,
• les clients posent souvent des questions sur la compatibilité, la configuration ou le déploiement,
• l’équipe souhaite combiner une FAQ classique avec une couche IA moderne,
• l’entreprise développe sa documentation produit et souhaite l’utiliser dans le retrieval,
• il est important de contrôler ce que l’IA sait et d’où elle tire ses réponses.

Il convient particulièrement bien aux boutiques qui vendent :

• des modules Magento,
• des produits techniques,
• des solutions B2B,
• des outils nécessitant un déploiement ou une configuration,
• des produits pour lesquels le client attend une réponse rapide et précise avant l’achat.

12. Résumé

Kowal_ZapytajOProdukt n’est plus seulement un module destiné à ajouter un simple formulaire de contact sur la fiche produit.

C’est une couche complète de communication produit qui :

• collecte les questions,
• publie une FAQ,
• répond via l’IA,
• utilise Vector Store,
• analyse les conversations,
• et les transforme en une base de connaissances de plus en plus performante pour la boutique.

Grâce à cela, la fiche produit devient un véritable espace d’échange avec le client, et non plus seulement une page statique avec une description et un prix.