Module Magento 2 – Demander un produit

MAGENTO 2 · QUESTIONS · FAQ · ASSISTANT IA

Kowal Demander un produit

Combinez un formulaire de contact, une FAQ publiée et un assistant IA optionnel. Exploitez les données produit et la base de connaissances, puis transformez les échanges récurrents en réponses accessibles aux prochains clients.

Formulaire et FAQ · Contexte produit · Conversations et feedback

COMMENT CELA FONCTIONNE EN PRATIQUE

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

En pratique, cela signifie que la fiche produit n’est plus seulement un espace de présentation de la description et des paramètres techniques, mais devient un point actif de prise en charge des questions client. L’utilisateur peut :

• poser une question classique sur le produit,
• utiliser les réponses prêtes 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 :

• opérationnel, c’est-à-dire réduire le nombre de questions répétitives adressées à l’équipe de la boutique,
• produit, c’est-à-dire construire une base de connaissances croissante et structurée qui améliore avec le temps la qualité des réponses.

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 donnée 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 comportera-t-il dans un scénario métier précis.

Sans outil dédié, ces questions :

• chargent le support,
• ralentissent les décisions d’achat,
• dispersent la connaissance entre les boîtes e-mail, les tickets et les échanges commerciaux,
• ne reviennent pas dans la boutique sous forme de FAQ structurée.

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

Le module fonctionne par couches.

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

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

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 principalement s’appuyer 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.

Le module fournit 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’activation du module globalement ou uniquement pour certains produits.

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

La FAQ de ce module n’est pas un simple ajout marketing, mais une couche structurée de connaissance 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 affiché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.

L’Assistant IA est l’élément central de l’extension 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 évolutions ultérieures.

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 avec les questions et réponses successives.

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

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

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

Cette solution remplit plusieurs fonctions à la fois :

• elle accélère le démarrage de la conversation,
• elle suggère au client ce que les autres demandent le plus souvent,
• elle permet d’utiliser des réponses FAQ prêtes sans coût de requête au 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 les données de clics, les questions posées et le feedback, puis classe les FAQ sur cette base.

L’hypothèse de conception la plus importante était que l’IA ne réponde pas en dehors 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, ce qui permet d’éviter :

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

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

Dans les scénarios plus simples, le module peut fonctionner en mode 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 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à chargés auparavant dans Vector Store.

En pratique, cela apporte deux avantages :

• un coût inférieur, 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 JSON local.

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 étoffée,
• la boutique gère de nombreux produits techniques,
• les données produit sont constamment enrichies.

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

Il enregistre aussi les données qui permettent 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 diagnostique.

Le déploiement n’est donc pas une boîte noire. L’équipe peut analyser :

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

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

Le processus est le suivant :

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 panel.
5. Après acceptation, le candidat est ajouté à la FAQ produit standard.

C’est un modèle de travail très pratique, car la connaissance ne disparaît 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.

Le module a été conçu pour que son fonctionnement puisse être contrôlé.

La configuration comprend notamment :

• les restrictions d’accès pour les visiteurs,
• le TTL des conversations,
• les limites de requêtes,
• la sanitisation des données d’entrée,
• les options de journalisation diagnostique,
• 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.

Le module sera particulièrement adapté aux projets où :

• le catalogue dépasse quelques produits simples,
• les clients posent souvent des questions sur la compatibilité, la configuration ou le déploiement,
• l’équipe souhaite associer une FAQ classique à une couche IA moderne,
• l’entreprise développe sa documentation produit et veut l’exploiter 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 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.

Kowal_ZapytajOProdukt n’est plus seulement un module de 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 boutique toujours meilleure.

La fiche produit devient ainsi un véritable lieu d’échange avec le client, et non plus seulement une page statique avec une description et un prix.

Dans Stores → Configuration → Demander un produit, vous pouvez commencer par le formulaire et la FAQ ainsi qu’une adresse e-mail supplémentaire. Vous activez les fonctions IA séparément : vous définissez le provider, la clé API, le modèle, le périmètre du contexte et les options Vector Store. L’intégration avec Kowal_AiProductFeed est optionnelle.

L’IA nécessite un accès à l’API et une facturation séparée. La qualité des réponses et le coût dépendent du contexte, du modèle et de la configuration. Les questions nécessitant une confirmation individuelle peuvent être transmises à l’équipe de la boutique via le formulaire classique.

Le package contient un Kowal_ZapytajOProduktHyva optionnel pour le formulaire, la FAQ et l’assistant IA. L’adaptateur est désactivé par défaut. Pour Hyvä, vous l’activez en plus et vérifiez l’emplacement des composants dans le thème utilisé. La boutique Luma utilise le module de base.

Package kowal/module-zapytajoprodukt, module Kowal_ZapytajOProdukt. Après avoir configuré l’accès au dépôt Kowal, installez le package, activez le module, mettez Magento à jour et videz le cache. En production, prévoyez la compilation et le déploiement du contenu statique selon le processus de la boutique.

1. Vous configurez la communication
Vous activez le formulaire, la FAQ et, en option, l’assistant IA.

2. Le client pose une question
Il utilise des questions prêtes à l’emploi ou saisit la sienne.

3. Vous développez la base de connaissances
Vous consultez les conversations et validez les candidats FAQ.

Le client demande la compatibilité du produit. L’équipe répond via le formulaire, et la question récurrente peut être publiée dans la FAQ.

L’assistant IA optionnel utilise les données produit, la FAQ et le Vector Store configuré. L’administrateur vérifie la qualité des conversations et les propositions de nouvelles FAQ.