# DataFirefly FAQ IA Produit pour WooCommerce — Documentation
> DataFirefly FAQ IA Produit génère automatiquement des FAQ contextuelles pour vos fiches produits WooCommerce à l'aide d'OpenAI ou d'Anthropic Claude, et injecte les rich snippets Schema.org FAQPage dans la balise…
- Page:
- Langue: fr
- Mis à jour le: 2026-08-06
- Autres langues: [en](https://www.datafirefly.com/en/documentation/dffaqai/index.md), [es](https://www.datafirefly.com/es/documentation/dffaqai/index.md), [de](https://www.datafirefly.com/de/documentation/dffaqai/index.md), [it](https://www.datafirefly.com/it/documentation/dffaqai/index.md), [pl](https://www.datafirefly.com/pl/documentation/dffaqai/index.md), [nl](https://www.datafirefly.com/nl/documentation/dffaqai/index.md), [pt](https://www.datafirefly.com/pt/documentation/dffaqai/index.md)
- Index:
DataFirefly FAQ IA Produit génère automatiquement des FAQ contextuelles pour vos fiches produits WooCommerce à l'aide d'OpenAI ou d'Anthropic Claude, et injecte les rich snippets Schema.org FAQPage dans la balise head pour les résultats enrichis Google. Ce guide couvre l'installation, la configuration complète et l'utilisation au quotidien.
## Prérequis
- WordPress 6.0 ou supérieur (testé jusqu'à 6.6)
- WooCommerce 7.0 ou supérieur (testé jusqu'à 9.4), compatible HPOS
- PHP 7.4 à 8.3
- Une clé API OpenAI ([platform.openai.com/api-keys](https://platform.openai.com/api-keys)) ou Anthropic ([console.anthropic.com](https://console.anthropic.com/))
- Facultatif : Polylang ou WPML pour le multilingue
## Installation
1. Téléchargez le fichier `dffaqai-1.0.0.zip` depuis votre compte DataFirefly.
2. Dans l'admin WordPress : **Extensions → Ajouter → Téléverser une extension**, sélectionnez le ZIP puis cliquez sur **Installer maintenant**.
3. Cliquez sur **Activer**. Le plugin crée sa table de stockage des FAQ et ses réglages par défaut.
À l'activation, un menu **FAQ IA** apparaît dans la barre latérale de l'admin, avec deux entrées : _Réglages_ et _Génération en masse_.
## Configuration du fournisseur IA
Rendez-vous dans **FAQ IA → Réglages → onglet Fournisseur**.
### Choisir OpenAI ou Anthropic Claude
- **OpenAI** : collez votre clé API, puis choisissez un modèle — `gpt-4o-mini` (le plus économique, recommandé), `gpt-4o`, `gpt-4-turbo` ou `gpt-3.5-turbo`.
- **Anthropic Claude** : collez votre clé API, puis choisissez — `claude-haiku-4-5` (économique, recommandé), `claude-sonnet-4-6` ou `claude-opus-4-7`.
Le plugin route automatiquement vers la bonne API selon le fournisseur sélectionné. Vous pouvez basculer à tout moment : les FAQ déjà générées sont conservées.
### Paramètres de génération
- **Nombre de questions par produit** : 1 à 15 (5 par défaut).
- **Température** : 0 (déterministe) à 2 (très créatif). 0,7 par défaut.
- **Max tokens** : longueur maximale de la réponse IA. 2000 par défaut.
Coût indicatif : une génération de 5 questions coûte environ 0,0005 $ avec gpt-4o-mini et 0,001 $ avec claude-haiku-4-5. Pour 200 produits en 3 langues, comptez 0,30 à 0,60 $ au total.
## Onglet Prompt — personnaliser le contenu généré
### Ton de voix
Six styles préconfigurés : professionnel, amical, décontracté, technique, enthousiaste, rassurant. Le ton change la formulation des réponses sans rien coder.
### Audience cible
Texte libre, par exemple « professionnels de santé (B2B) », « premiers acheteurs » ou « bricoleurs ». L'IA adapte le vocabulaire, les références et le niveau de détail.
### Prompt système personnalisé
Laissez vide pour utiliser le prompt par défaut construit à partir du ton et de l'audience. Si vous le remplissez, il remplace complètement les instructions par défaut — utile pour les boutiques avec une charte éditoriale stricte.
### Directives supplémentaires
Instructions ajoutées à chaque prompt, par exemple « toujours mentionner la garantie 2 ans », « éviter les superlatifs », « ne pas comparer aux concurrents ».
### Contexte produit à inclure
Trois cases à cocher enrichissent le contexte envoyé à l'IA : **catégorie principale**, **marque** (taxonomies `product_brand`, `pwb-brand` et `yith_product_brand` détectées automatiquement) et **attributs WooCommerce**. Sur les produits techniques, l'inclusion des attributs améliore nettement la pertinence des questions.
## Onglet Affichage & SEO
### Position d'affichage
Cinq hooks WooCommerce au choix :
- `woocommerce_after_single_product_summary` — sous les onglets (par défaut)
- `woocommerce_single_product_summary` — à l'intérieur du résumé produit
- `woocommerce_product_meta_end` — en fin de méta produit
- `woocommerce_after_single_product` — après toute la zone produit
- `woocommerce_before_single_product` — avant toute la zone produit
La **priorité du hook** (15 par défaut) est configurable pour gérer la coexistence avec d'autres plugins.
### Mode d'affichage
Accordéon (première question ouverte, navigation clavier ARIA) ou toutes les réponses dépliées.
### Rich snippets FAQPage
Lorsque l'option est active, le plugin injecte le JSON-LD Schema.org FAQPage dans la balise head de chaque fiche produit ayant au moins une FAQ active. L'encodage utilise `JSON_HEX_TAG`, `JSON_HEX_AMP`, `JSON_HEX_APOS` et `JSON_HEX_QUOT` et passe le Rich Results Test de Google.
### Titre de la FAQ par langue
Un champ de titre par langue active du site, avec des valeurs par défaut fournies en FR, EN, ES, DE, IT, PT et NL.
### Catégories exclues
Liste d'identifiants de catégories WooCommerce séparés par des virgules. Les produits de ces catégories sont ignorés en génération de masse et en auto-génération (produits virtuels, cartes cadeaux, etc.).
## La métabox FAQ sur la fiche produit
Sur l'écran d'édition de chaque produit, la métabox **FAQ IA** offre un contrôle complet :
- **Générer avec l'IA** : crée un jeu de questions/réponses pour la langue sélectionnée.
- **Ajouter une question** manuelle à tout moment.
- **Modifier** une question ou une réponse : la ligne s'enregistre automatiquement à la perte de focus.
- **Réordonner** par glisser-déposer via la poignée à gauche de chaque ligne.
- **Activer/désactiver** une entrée sans la supprimer.
- **Supprimer** définitivement une entrée.
Un sélecteur de langue en haut de la métabox permet de basculer instantanément entre les traductions Polylang ou WPML du produit — chaque traduction possède son propre jeu de FAQ.
## Génération en masse
Menu **FAQ IA → Génération en masse** :
1. Choisissez la **langue cible** : langue par défaut, langue spécifique, ou toutes les langues actives.
2. Cochez éventuellement **Forcer la régénération** pour écraser les FAQ existantes (utile après un changement de ton ou de fournisseur).
3. Cliquez sur **Démarrer**.
Le traitement est séquentiel (environ un produit par seconde selon la latence API) avec barre de progression en temps réel, compteur de produits traités et journal d'erreurs par produit. Le bouton **Stop** interrompt proprement entre deux produits. Les produits publiés uniquement sont traités ; les catégories exclues sont ignorées.
Laissez l'onglet du navigateur ouvert pendant la génération en masse : le traitement est piloté côté navigateur pour permettre la barre de progression et l'arrêt à la demande.
## Auto-génération à la création de produit
Option de l'onglet Fournisseur : lorsqu'elle est active, le plugin génère automatiquement une FAQ dans la langue par défaut à chaque enregistrement d'un produit qui n'en a pas encore. Les FAQ existantes ne sont jamais écrasées par ce mécanisme.
## Multilingue Polylang & WPML
Le plugin détecte automatiquement Polylang (`pll_languages_list`, `pll_get_post_translations`) et WPML (`wpml_active_languages`, `wpml_object_id`). Chaque traduction d'un produit reçoit son propre jeu de FAQ, généré nativement dans la langue cible — ce n'est pas une traduction de l'original. La génération en masse « toutes langues » parcourt chaque traduction de chaque produit.
## Vérifier les rich snippets
1. Ouvrez une fiche produit ayant au moins une FAQ active.
2. Affichez le code source et cherchez `application/ld+json` : un bloc `"@type":"FAQPage"` doit être présent.
3. Testez l'URL dans le [Rich Results Test de Google](https://search.google.com/test/rich-results) : la détection « FAQ » doit être valide.
Google décide seul de l'affichage des rich results en SERP ; le balisage valide est une condition nécessaire mais non suffisante. L'affichage apparaît généralement après réindexation de la page.
## Dépannage
### « La clé API du fournisseur IA n'est pas configurée »
Renseignez la clé du fournisseur actif dans l'onglet Fournisseur. Vérifiez qu'il n'y a pas d'espace avant/après la clé.
### Erreur API pendant la génération
Consultez **WooCommerce → État → Journaux** et sélectionnez la source `dffaqai` : chaque erreur API y est enregistrée avec le code HTTP et le message du fournisseur (clé invalide, quota dépassé, modèle inconnu…).
### Le bloc FAQ ne s'affiche pas
Vérifiez que le produit a au moins une FAQ _active_ dans la langue affichée, et que le thème exécute le hook choisi. En cas de doute, revenez au hook par défaut `woocommerce_after_single_product_summary`, présent sur tous les thèmes WooCommerce standards.
### Les questions générées sont dans la mauvaise langue
La langue de génération suit la traduction du produit (Polylang/WPML) ou la locale du site en mono-langue. Vérifiez le sélecteur de langue de la métabox avant de générer.
## Désinstallation
La désactivation conserve toutes les données. La **suppression** du plugin exécute `uninstall.php` : la table SQL des FAQ et toutes les options `dffaqai_*` sont supprimées définitivement.
## Support
Le support s'effectue par email avec une réponse sous 24 h ouvrées (FR/EN). Joignez si possible le journal `dffaqai` et les versions WordPress/WooCommerce/PHP.