# FAQ IA Prodotto — Guida completa all'installazione e configurazione

> Panoramica DataFirefly FAQ IA Prodotto genera automaticamente FAQ contestuali per le tue schede prodotto PrestaShop 8 tramite OpenAI o Anthropic Claude, iniettando rich snippet Schema.org FAQPage nell'head per i risultati…

- Pagina: <https://www.datafirefly.com/it/documentation/datafirefly-faq-ia-produit-prestashop-8/>
- Lingua: it
- Aggiornato il: 2026-07-02
- Altre lingue: [fr](https://www.datafirefly.com/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [en](https://www.datafirefly.com/en/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [es](https://www.datafirefly.com/es/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [de](https://www.datafirefly.com/de/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## Panoramica

**DataFirefly FAQ IA Prodotto** genera automaticamente FAQ contestuali per le tue schede prodotto PrestaShop 8 tramite OpenAI o Anthropic Claude, iniettando rich snippet Schema.org `FAQPage` nell'head per i risultati arricchiti di Google. Le FAQ sono memorizzate nel database (tabella `ps_product_faq`) — nessuna chiamata API viene effettuata nel front-office.

- **Compatibilità:** PrestaShop 8.0 → 8.99, PHP 7.2 → 8.3
- **Multilingua:** FAQ generate e memorizzate per lingua
- **Multinegozio:** configurazione indipendente per ogni sub-shop

## Installazione

1. Nel back-office, vai su **Moduli → Gestione moduli → Carica un modulo**.
2. Carica `productfaqai-3.0.0.zip`.
3. Clicca su **Installa**, poi su **Configura**.

**Aggiornamento dalla v2.x (modulo Sash):** l'aggiornamento non è distruttivo. Lo schema della tabella `ps_product_faq` rimane invariato — le tue FAQ esistenti sono conservate. Installa semplicemente la v3.0.0 sopra e riconfigura la tua chiave API nella nuova interfaccia.

## 1. Provider IA e modello

Primo modulo della pagina di configurazione.

- **Provider IA:** OpenAI o Anthropic Claude. Il modulo passa automaticamente all'API corretta.
- **Chiave API OpenAI:** da [platform.openai.com](https://platform.openai.com) (inizia con `sk-`).
- **Chiave API Anthropic:** da [console.anthropic.com](https://console.anthropic.com) (inizia con `sk-ant-`).
- **Modello:** per OpenAI, consigliato `gpt-4o-mini` (il più economico). Per Anthropic, consigliato `claude-haiku-4-5`.
- **Numero di domande:** da 1 a 15 (predefinito: 5).
- **Temperatura:** 0 = deterministico, 2 = molto creativo. Consigliato: 0,7.
- **Max token:** lunghezza massima della risposta (predefinito: 2000). Aumentala se generi più di 8 domande.
- **Auto-generazione:** genera automaticamente la FAQ (lingua predefinita) a ogni creazione di prodotto.

**Costo indicativo:** una generazione di 5 domande costa ~0,0005 $ con gpt-4o-mini e ~0,001 $ con claude-haiku-4-5. 200 prodotti × 3 lingue ≈ da 0,30 a 0,60 $ in totale.

## 2. Prompt e direttive di contenuto

Secondo modulo — controlla la qualità e lo stile delle FAQ generate.

- **Tono di voce:** professionale, amichevole, informale, tecnico, entusiasta o rassicurante.
- **Pubblico di destinazione** (opzionale): testo libero, es. «professionisti medici B2B», «acquirenti alle prime armi». L'IA adatta vocabolario e livello di dettaglio.
- **Prompt di sistema personalizzato** (opzionale): sostituisce completamente le istruzioni predefinite. Lascia vuoto per usare il prompt integrato.
- **Direttive aggiuntive** (opzionale): istruzioni aggiunte al prompt, es. «menzionare sempre la garanzia di 2 anni», «evitare il gergo tecnico».
- **Includi categoria / produttore / caratteristiche:** tre interruttori che arricchiscono il contesto inviato all'IA. Attiva «caratteristiche» per i prodotti tecnici — la precisione delle risposte migliora nettamente.

## 3. Visualizzazione e SEO

- **Posizione di visualizzazione (hook):** scegli tra 5 posizioni:
   - `displayProductFooter` — sotto tutta la scheda (predefinito, funziona ovunque)
   - `displayFooterProduct` — variante a seconda del tema
   - `displayProductAdditionalInfo` — sotto il pulsante di acquisto (più visibile)
   - `displayReassurance` — blocco rassicurazione
   - `displayAfterProductThumbs` — sotto le miniature
- **Titolo FAQ:** un campo per ogni lingua del negozio. Valori predefiniti in FR/EN/ES/DE/IT/PT/NL.
- **Modalità fisarmonica:** attivata = domande richiudibili (la prima aperta). Disattivata = tutte le risposte visibili.
- **Rich snippet JSON-LD:** inietta il markup Schema.org `FAQPage` nell'head. Consigliato: attivato.
- **Categorie escluse:** ID separati da virgole (es. `12,45,78`). I prodotti di queste categorie vengono saltati nella generazione di massa.

Il modulo registra i 5 hook all'installazione ma renderizza il blocco solo su quello configurato. Se un hook non esiste nel tuo tema, il blocco semplicemente non verrà mostrato — prova prima con l'hook predefinito.

## Generare le FAQ

### Generazione singola

Nel pannello «Genera FAQ per i prodotti», ogni riga prodotto mostra un pulsante **Genera**. Seleziona prima la lingua di destinazione nel menu a tendina in cima alla tabella. Il numero di FAQ esistenti per lingua è mostrato per ogni prodotto.

### Generazione di massa

- **Genera per tutti i prodotti (lingua corrente):** elabora tutti i prodotti senza FAQ nella lingua attiva.
- **Genera per tutti i prodotti (tutte le lingue):** elabora tutte le lingue attive del negozio.
- **Forza rigenerazione:** spunta questa casella per sovrascrivere le FAQ esistenti — utile dopo un cambio di prompt, tono o provider.

**Durata:** calcola ~1 prodotto/secondo per lingua (la latenza API varia). 100 prodotti × 3 lingue ≈ 5 minuti. Non chiudere la scheda durante l'elaborazione. I prodotti delle categorie escluse vengono saltati automaticamente.

### Auto-generazione

Se attivata nel primo modulo, ogni nuovo prodotto (hook `actionProductAdd`) riceve automaticamente una FAQ nella lingua predefinita del negozio.

## Editor FAQ per prodotto

Clicca su **Modifica FAQ** su una riga prodotto per aprire l'editor:

- **Selettore di lingua** in alto — passaggio istantaneo tra le lingue.
- **Posizione:** peso numerico, ordine di visualizzazione crescente.
- **Domanda / Risposta:** modifica diretta del testo.
- **Stato:** attivare/disattivare una voce senza eliminarla (una voce inattiva non appare né sulla scheda né nel JSON-LD).
- **Elimina:** rimozione definitiva di una voce.
- **Aggiungi una FAQ:** aggiunta manuale di una domanda/risposta.

Clicca su **Salva** per confermare tutte le modifiche della pagina.

## Rich snippet FAQPage

Quando l'opzione JSON-LD è attiva, il modulo inietta nell'`head` di ogni scheda prodotto con almeno una FAQ attiva un blocco `application/ld+json` conforme a Schema.org `FAQPage`:

```
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "…",
      "acceptedAnswer": { "@type": "Answer", "text": "…" }
    }
  ]
}
```

Verifica il markup con il [test dei risultati arricchiti di Google](https://search.google.com/test/rich-results). La comparsa nella SERP dipende da Google e può richiedere diversi giorni dopo la reindicizzazione della pagina.

## Risoluzione dei problemi

### «Configura la chiave API del provider IA»

La chiave del provider selezionato è vuota o non valida. Verifica che la chiave corrisponda al provider attivo (OpenAI = `sk-…`, Anthropic = `sk-ant-…`).

### Errori nella generazione di massa

Gli errori API (quota superata, chiave revocata, timeout) vengono registrati in **Parametri avanzati → Log** tramite PrestaShopLogger. Il rapporto finale mostra il dettaglio successi / saltati / errori per lingua.

### La FAQ non viene mostrata sulla scheda prodotto

1. Verifica che il prodotto abbia almeno una FAQ **attiva** nella lingua consultata.
2. Verifica che l'hook configurato esista nel tuo tema — torna a `displayProductFooter` per testare.
3. Svuota la cache di PrestaShop (**Parametri avanzati → Prestazioni**).

### I rich snippet non compaiono in Google

Il markup può essere valido senza che Google lo mostri: la visualizzazione dei risultati arricchiti resta a discrezione di Google. Valida prima il markup con il test dei risultati arricchiti, poi attendi i tempi di reindicizzazione.

## Disinstallazione

La disinstallazione elimina la tabella `ps_product_faq` (tutte le FAQ generate) e rimuove tutte le chiavi di configurazione. Viene richiesta una conferma. Esporta prima i tuoi dati se necessario.