# Recensioni Verificate WooCommerce — Documentazione > DataFirefly Reviews (dfreviews) trasforma il sistema di recensioni nativo di WooCommerce in una macchina di riprova sociale: richieste di recensioni automatiche post-acquisto, badge Acquisto verificato, foto dei clienti, voti utili,… - Pagina: - Lingua: it - Aggiornato il: 2026-07-16 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfreviews/index.md), [en](https://www.datafirefly.com/en/documentation/dfreviews/index.md), [es](https://www.datafirefly.com/es/documentation/dfreviews/index.md), [de](https://www.datafirefly.com/de/documentation/dfreviews/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfreviews/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfreviews/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfreviews/index.md) - Indice: DataFirefly Reviews (dfreviews) trasforma il sistema di recensioni nativo di WooCommerce in una macchina di riprova sociale: richieste di recensioni automatiche post-acquisto, badge Acquisto verificato, foto dei clienti, voti utili, riepilogo IA sulla scheda prodotto, risposta automatica alle recensioni tramite IA, coupon premio e rich snippet Schema.org. Questa documentazione copre installazione, configurazione completa e risoluzione dei problemi. ## Installazione 1. Nell'amministrazione di WordPress, apra **Plugin → Aggiungi nuovo → Carica plugin**. 2. Selezioni `dfreviews-1.0.0.zip`, clicchi su **Installa ora** e poi su **Attiva**. 3. Compare un nuovo sottomenu **WooCommerce → DF Reviews**: è il centro di controllo del plugin. Il plugin si basa sulle recensioni native di WooCommerce: le recensioni esistenti vengono conservate e sono subito utilizzabili. Nessuna migrazione necessaria. Requisiti: WooCommerce 8 o 9, WordPress 6.0+, PHP da 8.0 a 8.3. Il plugin è compatibile HPOS (High-Performance Order Storage) e funziona senza jQuery né Composer. ## Configurazione della chiave OpenAI Il riepilogo IA e la risposta automatica utilizzano la sua chiave API OpenAI personale: 1. Crei una chiave su [platform.openai.com](https://platform.openai.com/api-keys). 2. La incolli in **WooCommerce → DF Reviews → Settings**, sezione **OpenAI**. 3. Il modello predefinito è `gpt-4o-mini` — il più economico, consigliato. Un riepilogo o una risposta costa in genere molto meno di un centesimo. Senza chiave OpenAI, tutte le altre funzioni (richieste, foto, voti, coupon, rich snippet) restano pienamente operative. La scheda **AI tools** mostra lo stato della configurazione IA. ## Richieste di recensioni automatiche Sezione **Review requests** delle impostazioni: - **Stato attivatore**: la richiesta viene messa in coda quando un ordine raggiunge questo stato (predefinito _Completato_). - **Ritardo di invio**: giorni di attesa dopo lo stato attivatore (predefinito: 3 giorni). - **Promemoria**: parte un'unica email di promemoria se non è stata pubblicata alcuna recensione (predefinito: 5 giorni dopo la prima email). Ogni email contiene un link di recensione personale con token: la recensione pubblicata tramite esso riceve automaticamente il badge **Acquisto verificato**. Gli invii avvengono a lotti di 50 a ogni passaggio del cron. La scheda **Request queue** elenca le ultime 100 richieste con il loro stato (pending, sent, reminded, completed, failed, unsubscribed) e permette di avviare un'elaborazione manuale. Ogni email include un link di disiscrizione. Gli indirizzi disiscritti sono memorizzati come hash SHA-256 e non ricevono più alcuna richiesta. ## Riepilogo IA delle recensioni Non appena un prodotto raggiunge il numero minimo di recensioni pubblicate (predefinito: 3), il cron genera un blocco mostrato in cima alla scheda recensioni: **punti di forza**, **punti di attenzione** e **sintesi**. - Il riepilogo è memorizzato nella cache per prodotto **e per lingua**: con Polylang o WPML, ogni versione linguistica mostra un riepilogo nella propria lingua. - Viene rigenerato automaticamente alla pubblicazione di nuove recensioni (invalidazione tramite impronta delle recensioni analizzate). - L'impostazione **Max reviews analyzed** limita quante recensioni vengono inviate al modello. La scheda **AI tools** elenca i riepiloghi generati con lingua e data. ## Risposta automatica alle recensioni tramite IA Ogni recensione pubblicata può ricevere una risposta del venditore generata dall'IA, redatta **nella lingua della recensione**. Impostazioni chiave: - **Modalità di pubblicazione**: _Bozza_ (consigliata all'inizio — ogni risposta attende la sua approvazione nella schermata Commenti) o _Pubblicazione immediata_. - **Tono**: caloroso, professionale o conciso. - **Nome della firma**: mostrato come autore della risposta (vuoto = nome del sito). - **Rispondere ai voti da**: 1 per rispondere a tutte le recensioni — consigliato, poiché le recensioni negative sono quelle che beneficiano di più di una risposta. Salvaguardie integrate: per voti di 3/5 o inferiori, la risposta si scusa e rinvia all'assistenza, senza mai promettere un rimborso. Le risposte sono limitate a circa 70 parole, mostrate con il badge **Risposta ufficiale** ed escluse dalle medie e dai rich snippet. Per recensioni esistenti o importate: azione **Generate AI reply** nell'elenco commenti di WordPress, oppure l'elaborazione di recupero a lotti del cron. ## Foto, voti e coupon premio - **Foto dei clienti**: i clienti allegano fino a 3 foto (configurabile, max 10) alla recensione — jpg, png, webp, gif, max 5 MB, mostrate con lightbox. - **Voti utili**: pulsanti «Questa recensione ti è stata utile?» con protezione antiduplicati per account e per IP con hash. Mai mostrati sulle risposte del venditore. - **Coupon premio**: alla pubblicazione della recensione, il cliente riceve un coupon percentuale (predefinito: 10 %, 30 giorni), unico, monouso, limitato alla sua email. Anti-farming: un solo premio per email e per prodotto. ## Modulo e visualizzazione - **Campo titolo** della recensione, facoltativo od obbligatorio. - **Lunghezza minima** della recensione in caratteri (predefinito: 10). - **Blocco di distribuzione delle valutazioni** (barre da 5★ a 1★) sopra l'elenco delle recensioni. - **Colore delle stelle** personalizzabile (esadecimale, predefinito #e7a11a). ## Rich snippet Schema.org Il plugin conserva il markup AggregateRating e Review nativo di WooCommerce ripulendolo: le risposte del venditore sono escluse dal markup e dalle medie, per stelle Google sempre esatte. L'opzione può essere disattivata nelle impostazioni, il che rimuove allora tutto il markup delle recensioni. ## Cron: invii affidabili L'elaborazione (richieste, promemoria, riepiloghi IA, risposte di recupero) viene eseguita ogni ora tramite WP-Cron. Poiché WP-Cron si attiva solo con le visite al sito, configuri un vero cron server per un invio affidabile: 1. Copi l'**URL di cron con token** mostrato in **Settings → Cron**. 2. Lo aggiunga al cron del suo hosting (o crontab), ogni 15-60 minuti, ad esempio con `curl -s "URL" > /dev/null`. Un blocco anticoncorrenza impedisce due esecuzioni simultanee. Il pulsante **Run processing now** della scheda Request queue avvia un'elaborazione manuale in qualsiasi momento. ## Importazione ed esportazione CSV Scheda **Import / Export**: - **Esportazione**: tutte le recensioni prodotto con voto, titolo, indicatore verificato e date. - **Importazione**: CSV con riga di intestazione e colonne `product_id` o `sku`, `author`, `email`, `rating`, `title`, `content`, `date` (Y-m-d H:i:s, facoltativo), `verified` (1/0, facoltativo). Le statistiche delle valutazioni vengono ricalcolate automaticamente dopo l'importazione. ## Account cliente Una scheda **Le mie recensioni** viene aggiunta all'account cliente (Il mio account): ogni cliente vi ritrova le sue recensioni con stato di moderazione, stelle e badge verificato. Se la scheda restituisce un errore 404 dopo l'attivazione, salvi di nuovo i permalink in **Impostazioni → Permalink → Salva**. ## GDPR e dati - Link di disiscrizione in ogni email di richiesta; indirizzi disiscritti memorizzati come hash SHA-256, mai in chiaro. - Indirizzi IP dei votanti con hash tramite il salt di WordPress. - Unica chiamata in uscita: l'API OpenAI che lei controlla, e solo se una chiave è configurata. - La disinstallazione elimina tabelle e impostazioni del plugin ma **conserva tutte le recensioni** (recensioni WooCommerce native). ## Risoluzione dei problemi - **Le richieste non partono**: verifichi che la funzione sia attiva, che gli ordini raggiungano lo stato attivatore e che il cron giri (ultimo passaggio mostrato in AI tools). Configuri l'URL di cron server. - **Nessun riepilogo IA**: chiave OpenAI configurata? Numero minimo di recensioni pubblicate raggiunto? Il riepilogo viene generato al passaggio del cron, non istantaneamente. - **Nessuna risposta IA**: verifichi la modalità (in bozza, la risposta attende in Commenti → In attesa), il voto minimo configurato e la chiave API. - **Email non ricevute**: il plugin invia tramite il mailer di WooCommerce — testi la sua configurazione email globale (si consiglia un plugin SMTP).