AI Review Pros/Cons Synthesizer – Guida completa

Il modulo AI Review Pros/Cons Synthesizer legge le recensioni dei clienti di un prodotto e, tramite IA, ne genera una sintesi sotto forma di badge Pro e Contro mostrati direttamente sulla scheda prodotto. Le sintesi sono memorizzate in cache per prodotto, lingua e negozio, e aggiornate automaticamente tramite un cron.

Panoramica

Quando una scheda accumula centinaia di recensioni, pochi visitatori le leggono. Il modulo condensa questo segnale in pochi badge chiari, con una riga di riepilogo neutra e un contatore di menzioni. Sono supportati tre fornitori IA: Mistral AI, OpenAI e Anthropic (Claude). Ogni sintesi è prodotta nella lingua della scheda, il che è adatto ai cataloghi multilingua.

Requisiti

• PrestaShop 8.0 fino a 9.x (mono o multinegozio).
• PHP 7.4 fino a 8.x con l’estensione cURL attiva.
• Una sorgente di recensioni: il modulo ufficiale Product Comments oppure DataFirefly Reviews.
• Una chiave API di un fornitore IA (Mistral, OpenAI o Anthropic).

Installazione

1. Nel back office, aprire Moduli > Gestore dei moduli > Carica un modulo.
2. Selezionare l’archivio dfreviewsynth.zip e installarlo.
3. Fare clic su Configura per accedere alle impostazioni.

Configurazione

Fornitore IA e chiave API

Scegliere il fornitore (Mistral, OpenAI o Anthropic), incollare la propria chiave API e indicare il modello desiderato:

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

Sorgente delle recensioni

Selezionare l’origine delle recensioni. L’adattatore Product Comments legge i commenti approvati e non eliminati. L’adattatore DataFirefly Reviews legge le recensioni attive; se necessario, adattare i nomi delle colonne nella classe di accesso ai dati qualora lo schema sia diverso.

Posizione di visualizzazione

Sulla scheda prodotto sono disponibili due posizioni: sotto la descrizione breve (informazioni aggiuntive) o nel piè della scheda.

Soglie e cache

• Recensioni minime: al di sotto di questo numero non viene generata alcuna sintesi.
• Badge massimi per lato: limita il numero di Pro e Contro mostrati.
• Recensioni massime inviate all’IA: limita il consumo di token (le recensioni più recenti hanno la priorità).
• TTL della cache (giorni): usato dal cron per aggiornare le sintesi obsolete.

Generare le sintesi

Console di amministrazione

Nella pagina di configurazione, la console consente di caricare i prodotti idonei (quelli che raggiungono la soglia minima di recensioni), quindi di generare le sintesi singolarmente o in blocco, con barra di avanzamento. La generazione avviene nella lingua corrente del back office.

Cron multilingua

Per mantenere automaticamente aggiornate tutte le lingue, pianificare una chiamata periodica all’URL del cron mostrato nella configurazione:

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

Il parametro limit limita quanti prodotti vengono elaborati per esecuzione (predefinito 20, massimo 100). Il cron percorre ogni lingua attiva e rigenera solo le sintesi mancanti, in errore o obsolete.

Visualizzazione nel negozio

Sulla scheda prodotto, il modulo mostra un blocco «Cosa dicono i clienti» con due colonne (Pro in verde, Contro in arancione), una riga di riepilogo neutra opzionale, il numero di recensioni considerate e un contatore di menzioni per badge. È possibile mostrare una dicitura «riepilogo generato dall’IA» per trasparenza verso i clienti.

Catalogo multilingua

Ogni sintesi è memorizzata per prodotto, lingua e negozio. Il contenuto è generato nella lingua della scheda e il cron sincronizza tutte le lingue attive. Una sintesi viene rigenerata solo quando cambia il contenuto delle recensioni (rilevamento tramite impronta) o quando la cache scade.

Risoluzione dei problemi

• Nessun badge visualizzato. Verificare che il prodotto raggiunga il numero minimo di recensioni e che una sintesi sia stata generata (console o cron).
• Stato «errore» nella console. Controllare la chiave API, il nome del modello e la disponibilità di cURL; il dettaglio dell’ultimo errore è conservato nella cache.
• Recensioni non rilevate. Confermare la sorgente selezionata e, per DataFirefly Reviews, la corrispondenza delle colonne nell’adattatore.

Registro delle modifiche

• 1.0.0 — Prima versione pubblica: sintesi Pro / Contro tramite IA (Mistral, OpenAI, Anthropic), cache multilingua, console di amministrazione e cron di aggiornamento.