PS PrestaShop PrestaShop Principiante

FAQ IA Prodotto — Guida completa all’installazione e configurazione

Installare e configurare il modulo FAQ IA Prodotto: provider IA (OpenAI o Claude), personalizzazione del prompt, generazione di massa, editor FAQ e rich snippet FAQPage.

Aggiornato Versione del modulo 3.0.0

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 (inizia con sk-).
  • Chiave API Anthropic: da 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. 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.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza