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.
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.comoapi.openai.com.
Installazione e aggiornamento
- In Moduli > Gestione moduli, clicchi su Carica un modulo e scelga
productfaqai-4.0.0.zip. - Il modulo crea la tabella
ps_product_faqe tre tabelle tecniche (ps_productfaqai_job,ps_productfaqai_job_item,ps_productfaqai_usage), registra i suoi hook e un controller di amministrazione nascosto. - 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.

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.

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.

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».

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.

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.

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.

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.

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.

- 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.

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.

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.

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.







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.