Domande e risposte sul prodotto per Shopify

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 Shopify sia collegato 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 Shopify sia connesso in Dashboard → Integrazioni
• → Assicurati di non aver modificato {{ product.id }} nel codice
• → Il prodotto deve essere pubblicato e visibile nel negozio

Il widget appare nel posto sbagliato

• → Sposta il codice in un’altra posizione in main-product.liquid
• → 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’è la FAQ Pubblica?

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

Se l’IA decide che è una buona FAQ, viene pubblicata automaticamente nel metafield del prodotto su Shopify. Poi puoi mostrare queste FAQ nel tuo tema con il codice Liquid che ti forniamo.

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, la FAQ viene tradotta 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 su Shopify

   La FAQ si salva nel metafield wazion.faqs del prodotto, pronta per essere mostrata nel tuo tema.

Come attivare la FAQ Pubblica

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

Gestione delle FAQ pubblicate

Sebbene le FAQ vengano pubblicate automaticamente, hai il controllo totale dalla Dashboard:

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

Mostrare le FAQ nel tuo tema 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)
• ✗ Consultazioni 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)