PS PrestaShop Débutant

FAQ IA Produit — Guide complet d’installation et de configuration

Installer et configurer Product FAQ AI 4.0.0 : connexion à Claude ou OpenAI, réglages de rédaction, relecture des brouillons, génération en masse avec budget, affichage accessible et données structurées.

Mis à jour Version du module 4.0.0

Product FAQ AI rédige avec l’IA (Anthropic Claude ou OpenAI) la FAQ de vos fiches produit PrestaShop à partir des seules données de votre catalogue. Les réponses sont enregistrées en brouillon : vous les relisez, les corrigez si besoin, puis vous les validez avant qu’elles apparaissent sur la fiche, dans un accordéon accessible au clavier et sans JavaScript.

Version 4.0.0. Module réécrit : PrestaShop 1.7.8, 8 et 9, PHP 7.1 à 8.5, back-office en 8 langues, brouillons avec relecture, génération en masse avec estimation du coût et budget, journal de consommation, 5 styles d’accordéon. La mise à jour depuis la 3.x conserve vos FAQ, leur ordre, leur visibilité et vos réglages.

Prérequis

  • PrestaShop 1.7.8, 8.x ou 9.x, thème Classic, Hummingbird ou un thème qui appelle l’un des hooks de fiche produit proposés.
  • PHP 7.1 à 8.5 avec les extensions cURL et OpenSSL (chiffrement de la clé API).
  • Un compte Anthropic (console.anthropic.com) ou OpenAI (platform.openai.com) avec une clé API. Les appels sont facturés par le fournisseur sur votre propre compte.
  • Le serveur doit pouvoir faire des requêtes HTTPS sortantes vers api.anthropic.com ou api.openai.com.

Installation et mise à jour

  1. Dans Modules > Gestionnaire de modules, cliquez sur Installer un module et choisissez productfaqai-4.0.0.zip.
  2. Le module crée la table ps_product_faq et trois tables techniques (ps_productfaqai_job, ps_productfaqai_job_item, ps_productfaqai_usage), enregistre ses hooks et un contrôleur d’administration caché.
  3. Cliquez sur Configurer : l’onglet Connexion IA vous guide pour la clé API.

Mise à jour depuis la 3.x. Envoyez le zip 4.0.0 par-dessus l’ancienne version. Rien n’est supprimé : une FAQ active en 3.x devient « publiée », une FAQ inactive devient un brouillon. La clé API enregistrée en clair est chiffrée, les identifiants de modèle sont remplacés par des modèles actuels (par exemple claude-haiku-4-5-20251001 par claude-haiku-5-5, gpt-4o-mini par gpt-6-luna), et la position displayProductFooter, que ni Classic ni Hummingbird n’appellent, passe à displayFooterProduct si votre thème ne l’utilise pas.

Tableau de bord

Le tableau de bord montre la part des produits actifs qui ont une FAQ publiée, le nombre de fiches qui ont des brouillons à relire, la dépense du mois par rapport à votre plafond et le coût indicatif de 1 000 FAQ avec le modèle choisi. La couverture est détaillée par langue : FAQ publiée, brouillons seulement, ou aucune FAQ.

Product FAQ AI pour PrestaShop : tableau de bord avec la couverture des FAQ par langue et les dépenses du mois
Tableau de bord avec la couverture des FAQ par langue et les dépenses du mois

Connexion au fournisseur IA

L’assistant tient en trois étapes : choisir le fournisseur, coller la clé, choisir le modèle. La clé est d’abord testée par un appel gratuit à l’API Models du fournisseur ; elle n’est enregistrée que si le test réussit.

Product FAQ AI pour PrestaShop : assistant de connexion avec test de la clé API
Assistant de connexion avec test de la clé API

La clé est stockée chiffrée (AES-256-GCM) dans la base. Elle n’est plus jamais affichée (seuls les 4 derniers caractères le sont), elle n’est jamais envoyée au navigateur et n’est jamais écrite dans les journaux. Pour la remplacer, collez une nouvelle clé.

Choix du modèle

La liste reprend les modèles disponibles sur votre compte, lus par l’API Models au moment du test. Les modèles recommandés affichent leur prix public indicatif et le coût estimé pour 1 000 FAQ avec vos réglages. Sans test, une liste de secours est proposée.

  • Anthropic : claude-opus-5-5 (par défaut, meilleure qualité), claude-sonnet-5-5 (équilibré), claude-haiku-5-5 (rapide et économique).
  • OpenAI : gpt-6.1-sol (par défaut), gpt-6-astra, gpt-6.1-terra, gpt-6-luna, gpt-5.4-mini, gpt-5.4-nano.
Product FAQ AI pour PrestaShop : choix du modèle Claude avec prix indicatif et coût pour 1 000 FAQ
Choix du modèle Claude avec prix indicatif et coût pour 1 000 FAQ

L’effort de raisonnement est réglé sur « faible » par défaut : rédiger une FAQ à partir d’une fiche produit est une tâche simple, et un effort plus élevé augmente le temps et le nombre de jetons.

Réglages de rédaction

Choisissez le nombre de questions par produit (1 à 15), la longueur des réponses (courte, moyenne, détaillée) et le ton (professionnel, chaleureux, conversationnel, technique, enthousiaste ou rassurant). Vous pouvez préciser un public cible et des consignes de style, par exemple « vouvoyer le client ».

Product FAQ AI pour PrestaShop : réglages de rédaction : nombre de questions, longueur et ton
Réglages de rédaction : nombre de questions, longueur et ton

Les consignes de style ne peuvent pas lever les règles du module : n’utiliser que les faits de la fiche, ne jamais inventer de prix, de délai de livraison, de garantie, de certification ou d’allégation de santé, écrire en texte brut. Pour une information commerciale (garantie, retours), écrivez-la dans la description du produit ou ajoutez la question à la main.

Données envoyées : le nom, les descriptions courte et longue, les dimensions et le poids sont toujours envoyés ; la catégorie principale, la marque, les caractéristiques et les déclinaisons le sont selon vos réglages. Aucune donnée client, commande ou employé n’est jamais envoyée.

Nouveaux produits : l’option « Mettre les nouveaux produits dans la file FAQ » n’appelle pas l’IA pendant l’enregistrement du produit ; le tableau de bord affiche les produits en attente et vous lancez la file quand vous le souhaitez. La publication sans relecture est une option distincte, désactivée par défaut.

Produits et éditeur de FAQ

L’onglet Produits et FAQ liste les produits de la boutique avec, pour chaque langue, le nombre de questions publiées ou en brouillon et les alertes. Filtrez par produits sans FAQ, avec brouillons ou avec FAQ publiée.

Product FAQ AI pour PrestaShop : liste des produits avec l’état des FAQ par langue
Liste des produits avec l’état des FAQ par langue

L’éditeur ouvre la FAQ d’un produit dans une langue :

  • Générer la FAQ : remplace les brouillons de la langue ; les questions déjà publiées sont conservées, sauf si vous demandez à les remplacer.
  • Régénérer une seule question : la nouvelle version, différente des autres questions, est enregistrée en brouillon.
  • Réordonner par glisser-déposer ou avec les flèches, modifier, supprimer, ajouter une question à la main.
  • Valider une question, ou Tout valider et publier. Seules les entrées publiées apparaissent sur la fiche produit.
Product FAQ AI pour PrestaShop : éditeur de FAQ : valider, régénérer une question, réordonner
Éditeur de FAQ : valider, régénérer une question, réordonner

Alertes de vérification

Chaque réponse indique les faits de la fiche sur lesquels l’IA s’est appuyée. Le module affiche une alerte quand un chiffre n’apparaît pas dans les données du produit, quand la réponse parle de garantie, de livraison, de retours, de certification ou de santé alors que la fiche n’en dit rien, ou quand aucun fait n’est cité. Une entrée qui porte une alerte n’est jamais publiée automatiquement.

Product FAQ AI pour PrestaShop : brouillons à relire avec alerte sur un chiffre et une promesse absents de la fiche
Brouillons à relire avec alerte sur un chiffre et une promesse absents de la fiche

Données envoyées à l’IA

Le bouton Données envoyées à l’IA affiche exactement ce que le module transmet pour ce produit : les consignes (identiques pour tous les produits, ce qui permet leur mise en cache) et le message du produit, avec une estimation des jetons et du coût.

Product FAQ AI pour PrestaShop : aperçu des données produit envoyées à l’IA, sans donnée client
Aperçu des données produit envoyées à l’IA, sans donnée client

Génération en masse

Choisissez les langues, les produits (seulement ceux sans FAQ, ou tous les produits actifs), éventuellement une liste d’ID, et ce qui se passe après la génération (brouillons à relire, recommandé, ou publication des entrées sans alerte). Cliquez sur Estimer le coût : le module affiche le nombre de fiches × langues, les jetons estimés et une fourchette de coût, avec et sans mise en cache des consignes, avant tout envoi.

Product FAQ AI pour PrestaShop : génération en masse avec estimation du coût avant lancement
Génération en masse avec estimation du coût avant lancement
  • La file avance par étapes courtes tant que la page du module est ouverte : pas de requête interminable, pas de tâche cron.
  • Un verrou empêche deux onglets ou deux employés de traiter la même file ; une seule file est active par boutique.
  • La file s’arrête au budget du lancement et au plafond mensuel. Vous pouvez la mettre en pause, la reprendre, l’annuler, ou relancer les erreurs (3 tentatives par fiche).
  • Si le fournisseur refuse toutes les requêtes (clé, crédit, modèle), la file se met en pause avec un message qui indique quoi corriger.

Mode économique : les requêtes sont envoyées à l’API Message Batches d’Anthropic ou à l’API Batch d’OpenAI, environ moitié prix. Les résultats arrivent en général en quelques heures, au plus en 24 heures, et sont récupérés quand la page du module est ouverte.

Product FAQ AI pour PrestaShop : file de génération en mode économique (batch) avec progression et budget
File de génération en mode économique (batch) avec progression et budget

Coûts, budget et journal

Réglez le budget par défaut d’un lancement en masse, le plafond mensuel (toutes générations confondues) et le nombre maximum de jetons par réponse. Le journal liste chaque appel : opération, produit, langue, modèle, jetons d’entrée, de sortie et lus en cache tels que renvoyés par le fournisseur, coût indicatif et erreur éventuelle.

Product FAQ AI pour PrestaShop : budget, plafond mensuel et journal de consommation des jetons
Budget, plafond mensuel et journal de consommation des jetons

Les prix utilisés sont des prix publics indicatifs relevés le 11/11/2026. L’estimation compte environ 3,5 caractères par jeton : c’est un ordre de grandeur. La facture de votre fournisseur fait foi.

Affichage sur la fiche produit

Dans l’onglet Affichage, choisissez le style, la couleur d’accent, l’ouverture de la première question, la position sur la page et le titre du bloc dans chaque langue. Une position que votre thème n’appelle pas est signalée.

Product FAQ AI pour PrestaShop : réglages d’affichage : styles d’accordéon, position et données structurées
Réglages d’affichage : styles d’accordéon, position et données structurées

Cinq styles sont proposés : minimal, cartes, encadré, boutons + et tout ouvert. Le bloc utilise les éléments HTML natifs <details> et <summary> : il fonctionne au clavier (Tab, Entrée, Espace) et avec les lecteurs d’écran, sans aucun fichier JavaScript. Le HTML est produit par le serveur, donc rien ne se décale au chargement de la page, et la feuille de style n’est chargée que sur les fiches qui affichent une FAQ.

Product FAQ AI pour PrestaShop : FAQ sur la fiche produit, style minimal (Hummingbird)
FAQ sur la fiche produit, style minimal (Hummingbird)
Product FAQ AI pour PrestaShop : FAQ sur la fiche produit, style cartes
FAQ sur la fiche produit, style cartes
Product FAQ AI pour PrestaShop : FAQ sur la fiche produit, style encadré
FAQ sur la fiche produit, style encadré
Product FAQ AI pour PrestaShop : FAQ sur la fiche produit, style boutons + avec couleur d’accent
FAQ sur la fiche produit, style boutons + avec couleur d’accent
Product FAQ AI pour PrestaShop : FAQ avec toutes les réponses visibles
FAQ avec toutes les réponses visibles
Product FAQ AI pour PrestaShop : fiche produit Hummingbird avec le bloc FAQ
Fiche produit Hummingbird avec le bloc FAQ
Product FAQ AI pour PrestaShop : fiche produit du thème Classic avec la FAQ
Fiche produit du thème Classic avec la FAQ
Product FAQ AI pour PrestaShop : FAQ sur mobile, accessible au clavier et sans JavaScript
FAQ sur mobile, accessible au clavier et sans JavaScript

Données structurées FAQPage

Le module peut ajouter un balisage schema.org FAQPage (JSON-LD) aux fiches qui affichent une FAQ. L’option est désactivée par défaut.

Google a limité les résultats enrichis FAQ aux sites gouvernementaux et de santé faisant autorité en août 2023, puis a cessé de les afficher pour tous les sites le 7 mai 2026. Le balisage reste du schema.org valide et ne nuit pas, mais il ne produit aucun résultat enrichi dans Google : n’en attendez aucun gain SEO.

Si vous activez l’option et que le module DataFirefly All in One SEO affiche déjà un bloc FAQPage sur la page, Product FAQ AI n’en ajoute pas un second ; les réglages de l’autre module ne sont jamais modifiés. Le JSON-LD est encodé de façon à rester valide et à ne jamais pouvoir fermer la balise script.

Sécurité et confidentialité

  • Le texte du produit est placé dans un bloc de données délimité et traité comme du contenu non fiable : une description qui contiendrait des consignes (« ignore les instructions… ») reste une simple donnée.
  • La réponse de l’IA est contrainte par un schéma JSON, puis nettoyée : texte brut uniquement, sans HTML, lien, adresse e-mail ni Markdown.
  • Les actions du back-office passent par un contrôleur protégé par jeton ; les écritures exigent une requête POST du module et le droit « modifier » sur l’onglet Product FAQ AI. Un employé qui n’a que le droit « voir » consulte sans pouvoir générer ni modifier.
  • Multiboutique : les réglages, la clé, les FAQ, la file et le journal sont propres à chaque boutique ; sélectionnez une seule boutique pour configurer le module.

Dépannage

  • « Le fournisseur a refusé la clé (401) » : vérifiez la clé dans la console du fournisseur ou créez-en une nouvelle, puis collez-la à nouveau.
  • « Modèle inconnu ou indisponible (404) » : choisissez un autre modèle ; le bouton Tester la clé enregistrée recharge la liste de votre compte.
  • Crédit épuisé ou limite de facturation : ajoutez du crédit chez le fournisseur, puis reprenez la file.
  • Trop de requêtes (429), service surchargé : le module a déjà réessayé en respectant le délai indiqué par le fournisseur ; patientez, ou utilisez le mode économique.
  • Réponse coupée : augmentez le nombre maximum de jetons par réponse, ou demandez moins de questions ou des réponses plus courtes.
  • Refus du fournisseur : relisez le texte du produit ou rédigez les questions à la main.
  • La FAQ ne s’affiche pas : vérifiez que les questions sont publiées dans la langue consultée et que la position choisie est appelée par votre thème (avertissement dans l’onglet Affichage).

Désinstallation

La désinstallation supprime toutes les FAQ, la file de génération, le journal de consommation, les réglages et le contrôleur d’administration. Une confirmation est demandée.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support