# FAQ IA Produit — Guide complet d'installation et de configuration

> 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…

- Page: <https://www.datafirefly.com/documentation/datafirefly-faq-ia-produit-prestashop-8/>
- Langue: fr
- Mis à jour le: 2026-07-02
- Autres langues: [en](https://www.datafirefly.com/en/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [es](https://www.datafirefly.com/es/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [de](https://www.datafirefly.com/de/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [it](https://www.datafirefly.com/it/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md)
- Index: <https://www.datafirefly.com/documentation/llms.txt>

## 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](https://platform.openai.com) (commence par `sk-`).
- **Clé API Anthropic :** depuis [console.anthropic.com](https://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](https://search.google.com/test/rich-results). 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.