Domande e risposte sui prodotti per il tuo negozio online

Il widget non appare nella pagina del prodotto

• → Verifica che il plugin sia attivato in Dashboard → Plugin → Product Q&A
• → Verifica che il tuo dominio sia nella lista dei domini autorizzati
• → Verifica che il tuo negozio online sia connesso a WAzion
• → Apri la console del browser (F12 → Console) e cerca errori in rosso
• → Prova in finestra di navigazione in incognito per escludere problemi di cache

Errore “Token non valido“ o “Dominio non autorizzato

• → Copia il token direttamente dalla Dashboard, senza spazi
• → Aggiungi il tuo dominio esatto a quelli autorizzati: mitienda.myshopify.com E mitienda.com
• → Attendi qualche secondo dopo aver salvato le modifiche nella Dashboard

Il widget appare ma dice “Errore nel caricamento del prodotto

• → Verifica che il tuo negozio online sia connesso in Dashboard → Integrazioni
• → Assicurati di non aver modificato la variabile dell’ID prodotto nel codice.
• → Il prodotto deve essere pubblicato e visibile nel negozio

Il widget appare nel posto sbagliato

• → Sposta il codice in un’altra posizione nel modello di prodotto della tua piattaforma
• → Cerca riferimenti come “product__description“ per posizionarlo sotto
• → Usa lo stile margin nel div per regolare lo spazio: style=“margin: 30px 0;

Non so quale file modificare nel mio tema

File comuni per argomento:

• Dawn, Craft, Sense: sections/main-product.liquid
• Debut: sections/product-template.liquid
• Brooklyn: templates/product.liquid
• Minimal: sections/product-template.liquid

Se il tuo tema non è nella lista, cerca file che contengano “product“ in Sections o Templates.

Domini autorizzati

Elenco di domini in cui il widget può funzionare. Per sicurezza, è consentito l’uso solo da domini autorizzati.

• • mitienda.myshopify.com
• • mitienda.com (dominio personalizzato)
• • * (qualsiasi dominio - solo per sviluppo)

Temi di Design

10 temi predefiniti per adattare il widget al tuo negozio:

Testi del Widget

Personalizza i testi che vede il visitatore:

• • Titolo del widget (es: “Domande su questo prodotto“)
• • Segnaposto del campo di testo
• • Testo del pulsante di domanda

I testi vengono tradotti automaticamente nella lingua del visitatore.

Istruzioni per l’IA (opzionale)

Puoi aggiungere informazioni aggiuntive che l’IA terrà in considerazione nel rispondere:

• • Politiche di spedizione e reso
• • Promozioni attive
• • Istruzioni speciali (es: “Non menzionare prodotti della concorrenza“)
• • Informazioni di contatto

Impostazione della lingua

Protezione Anti-Abuso

Limita il numero di domande per visitatore per proteggere il tuo account:

• • Massimo di domande per periodo (es: 20 domande)
• • Finestra temporale in minuti (es: 60 minuti)

Metriche di utilizzo

• • Domande totali
• • Domande negli ultimi 7 giorni
• • Domande di oggi
• • Visitatori unici (24h)

Prodotti più consultati

Visualizza una classifica dei 5 prodotti con più domande. Utile per identificare quali prodotti generano più dubbi.

Visualizzatore di Domande

Rivedi tutte le domande fatte dai visitatori:

• • Filtro per periodo: Oggi, 7 giorni, 30 giorni, 90 giorni, 1 anno, tutti, o intervallo personalizzato
• • Lista impaginata: Naviga tra tutte le domande (10 per pagina)
• • Dettaglio completo: Vedi domanda, risposta dell’IA, prodotto, lingua e URL
• • Stato FAQ: Ogni domanda mostra se è già pubblicata come FAQ
• • Pubblicare manualmente: Pubblica qualsiasi domanda come FAQ con un clic

Che cos’è il FAQ Pubblico?

Quando un cliente fa una domanda generica su un prodotto (ad esempio: “È resistente all’acqua?“ o “Qual è il tempo di spedizione?“), l’IA valuta se quella domanda e risposta sarebbero utili per altri clienti.

Se l’IA decide che è una buona FAQ, viene pubblicata automaticamente. In Shopify si sincronizza direttamente al metafield del prodotto per mostrarla nel tuo tema. Per WooCommerce, PrestaShop e VTEX, le FAQ vengono generate automaticamente nel dashboard e sono disponibili per la consultazione.

Come funziona

1. 1

   Valutazione IA

   Quando un cliente fa una domanda, l’IA valuta se è generica (utile per altri) e non contiene dati personali.

2. 2

   Traduzione automatica

   Se il cliente chiede in un’altra lingua, le FAQ vengono tradotte automaticamente nella lingua principale del tuo negozio.

3. 3

   Anti-duplicati

   Si verifica che non esista già una FAQ simile (80% di somiglianza) prima di pubblicare.

4. 4

   Pubblicazione nel tuo negozio

   La FAQ viene pubblicata nel tuo negozio. In Shopify viene salvata nel metafield wazion.faqs del prodotto. Su altre piattaforme, le FAQ sono disponibili nel dashboard per la consultazione.

Come attivare le FAQ Pubbliche

1. Vai a Dashboard → Plugin → Domande e risposte sui prodotti
2. Cerca la sezione “FAQ Pubblica
3. Attiva l’interruttore “Attiva FAQ pubbliche
4. Se appare un avviso di permesso, clicca su “Verifica permesso
5. Imposta il numero massimo di FAQ per prodotto (1-20)
6. Salva le modifiche

Gestione delle FAQ pubblicate

Anche se le FAQ vengono pubblicate automaticamente, hai il controllo totale dal Dashboard:

• • Vedi FAQ: Elenco di tutte le FAQ pubblicate, filtrate per prodotto o stato
• • Pubblicare manualmente: Da “Ultime Domande“ puoi pubblicare qualsiasi domanda come FAQ con un clic.
• • Rimuovere dalla pubblicazione Rimuovi una FAQ dal tuo negozio ma la mantieni nel tuo storico.
• • Ripubblicare: Ripubblica una FAQ precedentemente non pubblicata
• • Eliminare Elimina permanentemente una FAQ

Mostrare le FAQ nel tuo tema Shopify Integrazione Shopify

Devi aggiungere due codici nel tuo file main-product.liquid:

<!-- WAzion Product FAQs -->
{% assign faqs_data = product.metafields.wazion.faqs.value %}
{% if faqs_data.faqs.size > 0 %}
<div class="product-faqs">
  <h3 class="product-faqs__title">Preguntas Frecuentes</h3>
  {% for faq in faqs_data.faqs %}
  <details class="product-faqs__item">
    <summary class="product-faqs__question">{{ faq.q }}</summary>
    <div class="product-faqs__answer">{{ faq.a | newline_to_br }}</div>
  </details>
  {% endfor %}
</div>
{% endif %}

<!-- WAzion FAQs JSON-LD for SEO -->
{% assign faqs_data = product.metafields.wazion.faqs.value %}
{% if faqs_data.faqs.size > 0 %}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {% for faq in faqs_data.faqs %}
    {
      "@type": "Question",
      "name": {{ faq.q | json }},
      "acceptedAnswer": {
        "@type": "Answer",
        "text": {{ faq.a | json }}
      }
    }{% unless forloop.last %},{% endunless %}
    {% endfor %}
  ]
}
</script>
{% endif %}

Quali domande NON vengono pubblicate?

L’IA filtra automaticamente le domande che non sono adatte per le FAQ pubbliche:

• ✗ Domande con dati personali (nomi, email, telefoni)
• ✗ Richieste su ordini specifici (numeri d’ordine, tracciamento)
• ✗ Reclami o problemi individuali
• ✗ Domande molto specifiche che non si applicherebbero ad altri clienti
• ✗ Domande duplicate (simili a FAQ già pubblicate)