PS PrestaShop Principiante

FAQ IA Prodotto — Guida completa all’installazione e configurazione

Installare e configurare Product FAQ AI 4.0.0: connessione a Claude o OpenAI, impostazioni di scrittura, revisione delle bozze, generazione di massa con budget, visualizzazione accessibile e dati strutturati.

Aggiornato Versione del modulo 4.0.0

Product FAQ AI redige con l’IA (Anthropic Claude o OpenAI) la FAQ delle sue schede prodotto PrestaShop basandosi esclusivamente sui dati del suo catalogo. Le risposte vengono salvate come bozza: lei le rilegge, le corregge se necessario e poi le convalida prima che compaiano nella scheda, in una fisarmonica accessibile da tastiera e senza JavaScript.

Versione 4.0.0. Modulo riscritto: PrestaShop 1.7.8, 8 e 9, PHP da 7.1 a 8.5, back-office in 8 lingue, bozze con revisione, generazione di massa con stima del costo e budget, registro dei consumi, 5 stili di fisarmonica. L’aggiornamento dalla 3.x conserva le sue FAQ, il loro ordine, la loro visibilità e le sue impostazioni.

Prerequisiti

  • PrestaShop 1.7.8, 8.x o 9.x, tema Classic, Hummingbird o un tema che richiami uno degli hook della scheda prodotto proposti.
  • PHP da 7.1 a 8.5 con le estensioni cURL e OpenSSL (cifratura della chiave API).
  • Un account Anthropic (console.anthropic.com) o OpenAI (platform.openai.com) con una chiave API. Le chiamate sono fatturate dal fornitore sul suo account.
  • Il server deve poter effettuare richieste HTTPS in uscita verso api.anthropic.com o api.openai.com.

Installazione e aggiornamento

  1. In Moduli > Gestione moduli, clicchi su Carica un modulo e scelga productfaqai-4.0.0.zip.
  2. Il modulo crea la tabella ps_product_faq e tre tabelle tecniche (ps_productfaqai_job, ps_productfaqai_job_item, ps_productfaqai_usage), registra i suoi hook e un controller di amministrazione nascosto.
  3. Clicchi su Configura: la scheda Connessione IA la guida nell’inserimento della chiave API.

Aggiornamento dalla 3.x. Carichi lo zip 4.0.0 sopra la vecchia versione. Nulla viene eliminato: una FAQ attiva nella 3.x diventa «pubblicata», una FAQ inattiva diventa una bozza. La chiave API salvata in chiaro viene cifrata, gli identificativi dei modelli vengono sostituiti da modelli attuali (ad esempio claude-haiku-4-5-20251001 con claude-haiku-5-5, gpt-4o-mini con gpt-6-luna) e la posizione displayProductFooter, che né Classic né Hummingbird richiamano, passa a displayFooterProduct se il suo tema non la utilizza.

Panoramica

La panoramica mostra la quota di prodotti attivi che hanno una FAQ pubblicata, il numero di schede con bozze da rivedere, la spesa del mese rispetto al suo tetto e il costo indicativo di 1.000 FAQ con il modello scelto. La copertura è dettagliata per lingua: FAQ pubblicata, solo bozze o nessuna FAQ.

Product FAQ AI per PrestaShop: panoramica con copertura delle FAQ per lingua e spesa del mese
Panoramica con copertura delle FAQ per lingua e spesa del mese

Connessione al fornitore IA

La procedura guidata si articola in tre passaggi: scegliere il fornitore, incollare la chiave, scegliere il modello. La chiave viene prima testata con una chiamata gratuita all’API Models del fornitore e viene salvata solo se il test riesce.

Product FAQ AI per PrestaShop: procedura di connessione con test della chiave API
Procedura di connessione con test della chiave API

La chiave è memorizzata cifrata (AES-256-GCM) nel database. Non viene più mostrata (sono visibili solo gli ultimi 4 caratteri), non viene mai inviata al browser e non viene mai scritta nei log. Per sostituirla, incolli una nuova chiave.

Scelta del modello

L’elenco riprende i modelli disponibili sul suo account, letti dall’API Models al momento del test. I modelli consigliati mostrano il loro prezzo di listino indicativo e il costo stimato per 1.000 FAQ con le sue impostazioni. Senza test, viene proposto un elenco di riserva.

  • Anthropic: claude-opus-5-5 (predefinito, massima qualità), claude-sonnet-5-5 (bilanciato), claude-haiku-5-5 (veloce ed economico).
  • OpenAI: gpt-6.1-sol (predefinito), gpt-6-astra, gpt-6.1-terra, gpt-6-luna, gpt-5.4-mini, gpt-5.4-nano.
Product FAQ AI per PrestaShop: scelta del modello Claude con prezzo indicativo e costo per 1.000 FAQ
Scelta del modello Claude con prezzo indicativo e costo per 1.000 FAQ

Lo sforzo di ragionamento è impostato su «basso» per impostazione predefinita: scrivere una FAQ a partire da una scheda prodotto è un compito semplice, e uno sforzo più elevato aumenta il tempo e il numero di token.

Impostazioni di scrittura

Scelga il numero di domande per prodotto (da 1 a 15), la lunghezza delle risposte (breve, media, dettagliata) e il tono (professionale, cordiale, colloquiale, tecnico, entusiasta o rassicurante). Può indicare un pubblico di riferimento e delle istruzioni di stile, ad esempio «dare del Lei al cliente».

Product FAQ AI per PrestaShop: impostazioni di scrittura: numero di domande, lunghezza e tono
Impostazioni di scrittura: numero di domande, lunghezza e tono

Le istruzioni di stile non possono annullare le regole del modulo: usare solo i fatti della scheda, non inventare mai prezzi, tempi di consegna, garanzie, certificazioni o affermazioni sanitarie, scrivere in testo semplice. Per un’informazione commerciale (garanzia, resi), la scriva nella descrizione del prodotto o aggiunga la domanda a mano.

Dati inviati: il nome, le descrizioni breve e lunga, le dimensioni e il peso vengono sempre inviati; la categoria principale, la marca, le caratteristiche e le combinazioni vengono inviate in base alle sue impostazioni. Non viene mai inviato alcun dato di clienti, ordini o dipendenti.

Nuovi prodotti: l’opzione «Mettere i nuovi prodotti nella coda FAQ» non chiama l’IA durante il salvataggio del prodotto; la panoramica mostra i prodotti in attesa e lei avvia la coda quando lo desidera. La pubblicazione senza revisione è un’opzione distinta, disattivata per impostazione predefinita.

Prodotti ed editor delle FAQ

La scheda Prodotti e FAQ elenca i prodotti del negozio con, per ogni lingua, il numero di domande pubblicate o in bozza e gli avvisi. Può filtrare per prodotti senza FAQ, con bozze o con FAQ pubblicata.

Product FAQ AI per PrestaShop: elenco prodotti con lo stato delle FAQ per lingua
Elenco prodotti con lo stato delle FAQ per lingua

L’editor apre la FAQ di un prodotto in una lingua:

  • Genera la FAQ: sostituisce le bozze della lingua; le domande già pubblicate vengono conservate, a meno che non chieda di sostituirle.
  • Rigenera una sola domanda: la nuova versione, diversa dalle altre domande, viene salvata come bozza.
  • Riordinare tramite trascinamento o con le frecce, modificare, eliminare, aggiungere una domanda a mano.
  • Convalida una domanda alla volta, oppure Convalida e pubblica tutto. Solo le voci pubblicate compaiono nella scheda prodotto.
Product FAQ AI per PrestaShop: editor delle FAQ: convalidare, rigenerare una domanda, riordinare
Editor delle FAQ: convalidare, rigenerare una domanda, riordinare

Avvisi di verifica

Ogni risposta indica i fatti della scheda su cui si è basata l’IA. Il modulo mostra un avviso quando una cifra non compare nei dati del prodotto, quando la risposta parla di garanzia, consegna, resi, certificazione o salute mentre la scheda non ne dice nulla, oppure quando non viene citato alcun fatto. Una voce con un avviso non viene mai pubblicata automaticamente.

Product FAQ AI per PrestaShop: bozze da rivedere con avviso su una cifra e una promessa assenti dalla scheda
Bozze da rivedere con avviso su una cifra e una promessa assenti dalla scheda

Dati inviati all’IA

Il pulsante Dati inviati all’IA mostra esattamente ciò che il modulo trasmette per questo prodotto: le istruzioni (identiche per tutti i prodotti, il che ne consente la memorizzazione in cache) e il messaggio del prodotto, con una stima dei token e del costo.

Product FAQ AI per PrestaShop: anteprima dei dati prodotto inviati all’IA, senza dati dei clienti
Anteprima dei dati prodotto inviati all’IA, senza dati dei clienti

Generazione di massa

Scelga le lingue, i prodotti (solo quelli senza FAQ oppure tutti i prodotti attivi), eventualmente un elenco di ID, e cosa succede dopo la generazione (bozze da rivedere, consigliato, oppure pubblicazione delle voci senza avvisi). Clicchi su Stima il costo: prima di qualsiasi invio, il modulo mostra il numero di schede × lingue, i token stimati e un intervallo di costo, con e senza memorizzazione in cache delle istruzioni.

Product FAQ AI per PrestaShop: generazione di massa con stima dei costi prima dell’avvio
Generazione di massa con stima dei costi prima dell’avvio
  • La coda avanza a piccoli passi finché la pagina del modulo è aperta: nessuna richiesta interminabile, nessun cron job.
  • Un blocco impedisce a due schede del browser o a due dipendenti di elaborare la stessa coda; è attiva una sola coda per negozio.
  • La coda si ferma al budget dell’esecuzione e al tetto mensile. Può metterla in pausa, riprenderla, annullarla o riprovare gli errori (3 tentativi per scheda).
  • Se il fornitore rifiuta tutte le richieste (chiave, credito, modello), la coda si mette in pausa con un messaggio che indica cosa correggere.

Modalità economica: le richieste vengono inviate all’API Message Batches di Anthropic o all’API Batch di OpenAI, a circa metà prezzo. I risultati arrivano in genere in poche ore, al massimo entro 24 ore, e vengono recuperati quando la pagina del modulo è aperta.

Product FAQ AI per PrestaShop: coda di generazione in modalità economica (batch) con avanzamento e budget
Coda di generazione in modalità economica (batch) con avanzamento e budget

Costi, budget e registro

Imposti il budget predefinito di un’esecuzione di massa, il tetto mensile (tutte le generazioni comprese) e il numero massimo di token per risposta. Il registro elenca ogni chiamata: operazione, prodotto, lingua, modello, token in ingresso, in uscita e letti dalla cache così come restituiti dal fornitore, costo indicativo ed eventuale errore.

Product FAQ AI per PrestaShop: budget, tetto mensile e registro dei consumi di token
Budget, tetto mensile e registro dei consumi di token

I prezzi utilizzati sono prezzi di listino indicativi rilevati l’11/11/2026. La stima conta circa 3,5 caratteri per token: si tratta di un ordine di grandezza. Fa fede la fattura del suo fornitore.

Visualizzazione nella scheda prodotto

Nella scheda Visualizzazione, scelga lo stile, il colore di accento, l’apertura della prima domanda, la posizione nella pagina e il titolo del blocco in ogni lingua. Una posizione che il suo tema non richiama viene segnalata.

Product FAQ AI per PrestaShop: impostazioni di visualizzazione: stili della fisarmonica, posizione e dati strutturati
Impostazioni di visualizzazione: stili della fisarmonica, posizione e dati strutturati

Sono disponibili cinque stili: minimal, schede, riquadro, pulsanti + e tutto aperto. Il blocco utilizza gli elementi HTML nativi <details> e <summary>: funziona da tastiera (Tab, Invio, Spazio) e con i lettori di schermo, senza alcun file JavaScript. L’HTML è generato dal server, quindi nulla si sposta durante il caricamento della pagina, e il foglio di stile viene caricato solo nelle schede che mostrano una FAQ.

Product FAQ AI per PrestaShop: FAQ nella scheda prodotto, stile minimal (Hummingbird)
FAQ nella scheda prodotto, stile minimal (Hummingbird)
Product FAQ AI per PrestaShop: FAQ nella scheda prodotto, stile schede
FAQ nella scheda prodotto, stile schede
Product FAQ AI per PrestaShop: FAQ nella scheda prodotto, stile riquadro
FAQ nella scheda prodotto, stile riquadro
Product FAQ AI per PrestaShop: FAQ nella scheda prodotto, stile pulsanti + con colore di accento
FAQ nella scheda prodotto, stile pulsanti + con colore di accento
Product FAQ AI per PrestaShop: FAQ con tutte le risposte visibili
FAQ con tutte le risposte visibili
Product FAQ AI per PrestaShop: scheda prodotto Hummingbird con il blocco FAQ
Scheda prodotto Hummingbird con il blocco FAQ
Product FAQ AI per PrestaShop: FAQ su mobile, accessibile da tastiera e senza JavaScript
FAQ su mobile, accessibile da tastiera e senza JavaScript

Dati strutturati FAQPage

Il modulo può aggiungere un markup schema.org FAQPage (JSON-LD) alle schede che mostrano una FAQ. L’opzione è disattivata per impostazione predefinita.

Google ha limitato i risultati avanzati FAQ ai siti governativi e sanitari autorevoli nell’agosto 2023, poi ha smesso di mostrarli per tutti i siti il 7 maggio 2026. Il markup resta schema.org valido e non nuoce, ma non produce alcun risultato avanzato in Google: non si aspetti alcun vantaggio SEO.

Se attiva l’opzione e il modulo DataFirefly All in One SEO mostra già un blocco FAQPage nella pagina, Product FAQ AI non ne aggiunge un secondo; le impostazioni dell’altro modulo non vengono mai modificate. Il JSON-LD è codificato in modo da restare valido e da non poter mai chiudere il tag script.

Sicurezza e riservatezza

  • Il testo del prodotto viene inserito in un blocco di dati delimitato e trattato come contenuto non attendibile: una descrizione che contenesse delle istruzioni («ignora le istruzioni…») resta un semplice dato.
  • La risposta dell’IA è vincolata da uno schema JSON e poi ripulita: solo testo semplice, senza HTML, link, indirizzi e-mail né Markdown.
  • Le azioni del back-office passano per un controller protetto da token; le scritture richiedono una richiesta POST del modulo e il permesso «modifica» sulla scheda Product FAQ AI. Un dipendente che ha solo il permesso «visualizza» può consultare senza poter generare né modificare.
  • Multinegozio: le impostazioni, la chiave, le FAQ, la coda e il registro sono specifici di ogni negozio; selezioni un solo negozio per configurare il modulo.

Risoluzione dei problemi

  • «Il fornitore ha rifiutato la chiave (401)»: verifichi la chiave nella console del fornitore o ne crei una nuova, poi la incolli di nuovo.
  • «Modello sconosciuto o non disponibile (404)»: scelga un altro modello; il pulsante Testa la chiave salvata ricarica l’elenco del suo account.
  • Credito esaurito o limite di fatturazione: aggiunga credito presso il fornitore, poi riprenda la coda.
  • Troppe richieste (429), servizio sovraccarico: il modulo ha già riprovato rispettando il tempo di attesa indicato dal fornitore; attenda oppure usi la modalità economica.
  • Risposta troncata: aumenti il numero massimo di token per risposta, oppure chieda meno domande o risposte più brevi.
  • Rifiuto del fornitore: riveda il testo del prodotto o scriva le domande a mano.
  • La FAQ non viene visualizzata: verifichi che le domande siano pubblicate nella lingua consultata e che la posizione scelta sia richiamata dal suo tema (avviso nella scheda Visualizzazione).

Disinstallazione

La disinstallazione elimina tutte le FAQ, la coda di generazione, il registro dei consumi, le impostazioni e il controller di amministrazione. Viene richiesta una conferma.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza