AI Review Pros/Cons Synthesizer – Guide complet

Le module AI Review Pros/Cons Synthesizer lit les avis clients d’un produit et en génère, par intelligence artificielle, une synthèse en badges Avantages et Inconvénients affichés directement sur la fiche produit. Les synthèses sont mises en cache par produit, langue et boutique, et rafraîchies automatiquement via un cron.

Présentation

Quand une fiche cumule des centaines d’avis, peu de visiteurs les lisent. Le module condense ce signal en quelques badges clairs, accompagnés d’une phrase de résumé neutre et d’un compteur de mentions. Trois fournisseurs IA sont pris en charge : Mistral AI, OpenAI et Anthropic (Claude). Chaque synthèse est produite dans la langue de la fiche, ce qui convient aux catalogues multilingues.

Prérequis

• PrestaShop 8.0 à 9.x (mono ou multiboutique).
• PHP 7.4 à 8.x avec l’extension cURL active.
• Une source d’avis : le module officiel Product Comments, ou DataFirefly Reviews.
• Une clé API auprès d’un fournisseur IA (Mistral, OpenAI ou Anthropic).

Installation

1. Dans le back-office, ouvrez Modules > Gestionnaire de modules > Envoyer un module.
2. Sélectionnez l’archive dfreviewsynth.zip puis installez.
3. Cliquez sur Configurer pour accéder aux réglages.

Configuration

Fournisseur IA et clé API

Choisissez le fournisseur (Mistral, OpenAI ou Anthropic), collez votre clé API et renseignez le modèle souhaité :

• Mistral : mistral-small-latest
• OpenAI : gpt-4o-mini
• Anthropic : claude-haiku-4-5

Source des avis

Sélectionnez l’origine des avis. L’adaptateur Product Comments lit les commentaires approuvés et non supprimés. L’adaptateur DataFirefly Reviews lit les avis actifs ; ajustez au besoin le nom des colonnes dans la classe d’accès aux données si votre schéma diffère.

Position d’affichage

Deux emplacements sont disponibles sur la fiche produit : sous la description courte (informations complémentaires) ou en pied de fiche.

Seuils et cache

• Nombre minimum d’avis : en deçà, aucune synthèse n’est générée.
• Badges maximum par côté : limite le nombre d’Avantages et d’Inconvénients affichés.
• Avis maximum envoyés à l’IA : plafonne la consommation de jetons (les avis les plus récents sont prioritaires).
• Durée de vie du cache (jours) : utilisée par le cron pour rafraîchir les synthèses obsolètes.

Générer les synthèses

Console d’administration

Dans la page de configuration, la console permet de charger les produits éligibles (ceux qui atteignent le seuil minimum d’avis), puis de générer les synthèses à l’unité ou en masse, avec barre de progression. La génération s’effectue dans la langue courante du back-office.

Cron multilingue

Pour maintenir automatiquement à jour toutes les langues, planifiez un appel régulier à l’URL de cron affichée dans la configuration :

/index.php?fc=module&module=dfreviewsynth&controller=cron&token=VOTRE_TOKEN&limit=20

Le paramètre limit plafonne le nombre de produits traités par exécution (défaut 20, maximum 100). Le cron parcourt chaque langue active et ne régénère que les synthèses manquantes, en erreur ou obsolètes.

Affichage côté client

Sur la fiche produit, le module affiche un bloc « Ce que disent les clients » avec deux colonnes (Avantages en vert, Inconvénients en orange), une phrase de résumé neutre optionnelle, le nombre d’avis pris en compte et un compteur de mentions par badge. Une mention « résumé généré par IA » peut être affichée pour la transparence vis-à-vis des clients.

Catalogue multilingue

Chaque synthèse est stockée par produit, langue et boutique. Le contenu est généré dans la langue de la fiche, et le cron synchronise l’ensemble des langues actives. Une synthèse n’est régénérée que lorsque le contenu des avis change (détection par empreinte) ou lorsque le cache arrive à expiration.

Dépannage

• Aucun badge ne s’affiche. Vérifiez que le produit atteint le nombre minimum d’avis et qu’une synthèse a bien été générée (console ou cron).
• Statut « erreur » dans la console. Contrôlez la clé API, le nom du modèle et la disponibilité de cURL ; le détail de la dernière erreur est conservé en cache.
• Avis non détectés. Confirmez la source sélectionnée et, pour DataFirefly Reviews, la correspondance des colonnes dans l’adaptateur.

Journal des versions

• 1.0.0 — Première version publique : synthèse Avantages / Inconvénients par IA (Mistral, OpenAI, Anthropic), cache multilingue, console d’administration et cron de rafraîchissement.