PS PrestaShop PrestaShop Débutant

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

Installer et configurer le module FAQ IA Produit : fournisseur IA (OpenAI ou Claude), personnalisation du prompt, génération en masse, éditeur FAQ et rich snippets FAQPage.

Mis à jour Version du module 3.0.0

Présentation

DataFirefly FAQ IA Produit génère automatiquement des FAQ contextuelles pour vos fiches produits PrestaShop 8 via OpenAI ou Anthropic Claude, avec injection de rich snippets Schema.org FAQPage dans le head pour les résultats enrichis Google. Les FAQ sont stockées en base (table ps_product_faq) — aucun appel API n’est effectué côté front-office.

  • Compatibilité : PrestaShop 8.0 → 8.99, PHP 7.2 → 8.3
  • Multilingue : FAQ générées et stockées par langue
  • Multi-boutique : configuration indépendante par sous-boutique

Installation

  1. Dans votre back-office, allez dans Modules → Gestionnaire de modules → Installer un module.
  2. Téléversez productfaqai-3.0.0.zip.
  3. Cliquez sur Installer, puis Configurer.

Mise à jour depuis la v2.x (module Sash) : l’upgrade est non destructif. Le schéma de la table ps_product_faq est inchangé — vos FAQ existantes sont conservées. Installez simplement la v3.0.0 par-dessus, puis reconfigurez votre clé API dans la nouvelle interface.

1. Fournisseur IA & modèle

Premier formulaire de la page de configuration.

  • Fournisseur IA : OpenAI ou Anthropic Claude. Le module bascule automatiquement vers la bonne API.
  • Clé API OpenAI : depuis platform.openai.com (commence par sk-).
  • Clé API Anthropic : depuis console.anthropic.com (commence par sk-ant-).
  • Modèle : pour OpenAI, gpt-4o-mini recommandé (le plus économique). Pour Anthropic, claude-haiku-4-5 recommandé.
  • Nombre de questions : 1 à 15 (défaut : 5).
  • Température : 0 = déterministe, 2 = très créatif. Recommandé : 0,7.
  • Max tokens : longueur maximale de la réponse (défaut : 2000). Augmentez si vous générez plus de 8 questions.
  • Auto-génération : génère automatiquement la FAQ (langue par défaut) à chaque création de produit.

Coût indicatif : une génération de 5 questions coûte ~0,0005 $ avec gpt-4o-mini et ~0,001 $ avec claude-haiku-4-5. 200 produits × 3 langues ≈ 0,30 à 0,60 $ au total.

2. Prompt & directives de contenu

Deuxième formulaire — contrôle la qualité et le style des FAQ générées.

  • Ton de voix : professionnel, amical, décontracté, technique, enthousiaste ou rassurant.
  • Audience cible (optionnel) : texte libre, ex. « professionnels médicaux B2B », « premiers acheteurs ». L’IA adapte vocabulaire et niveau de détail.
  • Prompt système personnalisé (optionnel) : remplace intégralement les instructions par défaut. Laissez vide pour utiliser le prompt intégré.
  • Directives additionnelles (optionnel) : instructions ajoutées au prompt, ex. « toujours mentionner la garantie 2 ans », « éviter le jargon ».
  • Inclure catégorie / fabricant / caractéristiques : trois interrupteurs qui enrichissent le contexte envoyé à l’IA. Activez « caractéristiques » pour les produits techniques — la précision des réponses s’améliore nettement.

3. Affichage & SEO

  • Position d’affichage (hook) : choisissez parmi 5 emplacements :
    • displayProductFooter — sous toute la fiche (défaut, fonctionne partout)
    • displayFooterProduct — variante selon le thème
    • displayProductAdditionalInfo — sous le bouton d’achat (plus visible)
    • displayReassurance — bloc réassurance
    • displayAfterProductThumbs — sous les miniatures
  • Titre FAQ : un champ par langue de la boutique. Défauts fournis en FR/EN/ES/DE/IT/PT/NL.
  • Mode accordéon : activé = questions repliables (première ouverte). Désactivé = toutes les réponses visibles.
  • Rich snippets JSON-LD : injecte le balisage Schema.org FAQPage dans le head. Recommandé : activé.
  • Catégories exclues : IDs séparés par des virgules (ex. 12,45,78). Les produits de ces catégories sont ignorés en génération de masse.

Le module enregistre les 5 hooks à l’installation mais ne rend le bloc qu’au hook configuré. Si un hook n’existe pas dans votre thème, le bloc ne s’affichera simplement pas — testez avec le hook par défaut d’abord.

Générer des FAQ

Génération individuelle

Dans le panneau « Générer des FAQs pour les produits », chaque ligne produit affiche un bouton Générer. Sélectionnez d’abord la langue cible dans le menu déroulant en haut du tableau. Le nombre de FAQ existantes par langue est affiché pour chaque produit.

Génération en masse

  • Générer pour tous les produits (langue actuelle) : traite tous les produits sans FAQ dans la langue active.
  • Générer pour tous les produits (toutes langues) : traite toutes les langues actives de la boutique.
  • Forcer la régénération : cochez cette case pour écraser les FAQ existantes — utile après un changement de prompt, de ton ou de fournisseur.

Durée : comptez ~1 produit/seconde par langue (latence API variable). 100 produits × 3 langues ≈ 5 minutes. Ne fermez pas l’onglet pendant le traitement. Les produits des catégories exclues sont automatiquement ignorés.

Auto-génération

Si activée dans le premier formulaire, chaque nouveau produit (hook actionProductAdd) reçoit automatiquement une FAQ dans la langue par défaut de la boutique.

Éditeur FAQ par produit

Cliquez sur Modifier FAQs sur une ligne produit pour ouvrir l’éditeur :

  • Sélecteur de langue en haut — bascule instantanée entre les langues.
  • Position : poids numérique, ordre croissant d’affichage.
  • Question / Réponse : édition directe du texte.
  • Statut : activer/désactiver une entrée sans la supprimer (une entrée inactive n’apparaît ni sur la fiche ni dans le JSON-LD).
  • Supprimer : suppression définitive d’une entrée.
  • Ajouter une FAQ : ajout manuel d’une question/réponse.

Cliquez sur Enregistrer pour valider l’ensemble des modifications de la page.

Rich snippets FAQPage

Quand l’option JSON-LD est active, le module injecte dans le head de chaque fiche produit ayant au moins une FAQ active un bloc application/ld+json conforme à Schema.org FAQPage :

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "…",
      "acceptedAnswer": { "@type": "Answer", "text": "…" }
    }
  ]
}

Vérifiez le balisage avec le test des résultats enrichis Google. L’apparition dans la SERP dépend de Google et peut prendre plusieurs jours après la réindexation de la page.

Dépannage

« Veuillez configurer votre clé API »

La clé du fournisseur sélectionné est vide ou invalide. Vérifiez que la clé correspond bien au fournisseur actif (OpenAI = sk-…, Anthropic = sk-ant-…).

Erreurs de génération en masse

Les erreurs API (quota dépassé, clé révoquée, timeout) sont consignées dans Paramètres avancés → Logs via PrestaShopLogger. Le compte-rendu de fin de traitement affiche le détail réussites / ignorés / erreurs par langue.

La FAQ ne s’affiche pas sur la fiche produit

  1. Vérifiez que le produit a au moins une FAQ active dans la langue consultée.
  2. Vérifiez que le hook configuré existe dans votre thème — repassez sur displayProductFooter pour tester.
  3. Videz le cache PrestaShop (Paramètres avancés → Performances).

Les rich snippets n’apparaissent pas dans Google

Le balisage peut être valide sans que Google l’affiche : l’affichage des résultats enrichis reste à la discrétion de Google. Vérifiez d’abord le balisage avec le test des résultats enrichis, puis patientez le temps de la réindexation.

Désinstallation

La désinstallation supprime la table ps_product_faq (toutes les FAQ générées) et l’ensemble des clés de configuration. Une confirmation est demandée. Exportez vos données au préalable si nécessaire.

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

Toujours bloqué ? Contactez le support