Sistema PROMIUM FAQ

Come funziona

Il Sistema PROMIUM FAQ combina una Knowledge Base strutturata (le tue domande e risposte) con un motore di Natural Language Understanding che interpreta le domande degli utenti in linguaggio libero. Il risultato: risposte precise anche quando l'utente non usa le parole esatte.

Quick Start

Vai online in meno di 10 minuti seguendo questi 4 passaggi:

1. Crea un progetto FAQ nella dashboard

   Accedi a dashboard.promiumai.com → Applicativi → FAQ System → Nuovo Progetto. Inserisci il nome del progetto e la lingua principale.

2. Carica la tua Knowledge Base

   Aggiungi le FAQ manualmente, importa un file CSV (domanda;risposta) o connetti una fonte URL per l'aggiornamento automatico.

3. Ottieni il tuo Project ID

   Nella sezione "Integrazione" trovi il tuo data-faq-id univoco. Copialo, ti servirà nello snippet.

4. Incolla lo snippet nel tuo sito

   Aggiungi il codice embed prima del tag </body>. Il widget appare immediatamente senza ulteriori configurazioni.

Codice Embed

Copia e incolla questo snippet nel tuo HTML. Sostituisci TUO_FAQ_ID con il tuo identificativo progetto.

<!-- PROMIUM FAQ System Widget -->
<div id="promium-faq"
     data-faq-id="TUO_FAQ_ID"
     data-lang="it"
     data-theme="light">
</div>
<script src="https://cdn.promiumai.com/faq/v2/widget.js" async></script>

Snippet con tutte le opzioni

<div id="promium-faq"
     data-faq-id="TUO_FAQ_ID"
     data-lang="it"
     data-theme="custom"
     data-primary-color="#F5671A"
     data-max-results="5"
     data-show-search="true"
     data-show-categories="true"
     data-fallback="chatbot"
     data-chatbot-id="TUO_CHATBOT_ID"
     data-placeholder="Cerca nelle FAQ..."
     data-no-result-text="Nessun risultato. Vuoi contattarci?">
</div>
<script src="https://cdn.promiumai.com/faq/v2/widget.js" async></script>

Parametri di configurazione

Gestione Knowledge Base

La Knowledge Base è il cuore del sistema FAQ. Puoi alimentarla in tre modi:

1. Inserimento manuale (Dashboard)

Dalla dashboard vai su FAQ System → Knowledge Base → + Aggiungi FAQ. Compila:

• Domanda: la domanda principale (es. "Quanto costa PROMIUM?").
• Varianti: domande alternative con lo stesso significato (opzionale ma consigliato).
• Risposta: testo semplice o HTML. Supporta immagini e link.
• Categoria: per raggruppare visivamente le FAQ.
• Priorità: ordine di visualizzazione nelle liste non filtrate.

2. Import CSV

Importa decine o centinaia di FAQ in una sola operazione. Formato richiesto:

domanda;risposta;categoria;priorita
"Quanto costa PROMIUM?";"I prezzi partono da €59/mese. Vedi la pagina Pricing.";"Prezzi";1
"Posso integrare PROMIUM con WordPress?";"Sì, con il plugin ufficiale PROMIUM WP.";"Integrazione";2

3. Sincronizzazione URL

Fornisci l'URL di una pagina FAQ esistente (es. https://miosito.com/faq) o di un file JSON/CSV remoto. Il sistema legge e importa automaticamente le FAQ, con re-sincronizzazione programmabile (ogni 24h, settimanale, ecc.).

Personalizzazione visiva

Oltre ai parametri data-*, puoi sovrascrivere lo stile del widget via CSS usando le variabili esposte:

#promium-faq {
  --pfaq-primary:        #F5671A;   /* colore principale */
  --pfaq-bg:             #ffffff;   /* sfondo widget */
  --pfaq-text:           #1a1a2e;   /* testo corpo */
  --pfaq-border:         #e5e7eb;   /* bordi */
  --pfaq-radius:         12px;      /* arrotondamento card */
  --pfaq-font:           'Inter', sans-serif;
  --pfaq-answer-bg:      #f9fafb;   /* sfondo risposta espansa */
  --pfaq-icon-color:     #F5671A;   /* icone espansione */
}

Layout preset

REST API

Puoi interrogare la Knowledge Base e gestire le FAQ direttamente via API REST. Tutte le richieste richiedono autenticazione Bearer.

Autenticazione

Authorization: Bearer TUO_API_KEY
Content-Type: application/json

Endpoint principali

Esempio: Ricerca semantica

const response = await fetch(
  'https://api.promiumai.com/api/v2/faq/TUO_FAQ_ID/search',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer TUO_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      query: "come posso cambiare piano abbonamento",
      max_results: 5,
      threshold: 0.65     // soglia di similarità (0–1)
    })
  }
);

const data = await response.json();
// data.results: [{ id, question, answer, score, category }]
console.log(data.results);

Esempio: Aggiunta FAQ via API

const faq = await fetch(
  'https://api.promiumai.com/api/v2/faq/TUO_FAQ_ID/items',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer TUO_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      question: "Posso usare PROMIUM senza contratto annuale?",
      variants: [
        "C'è un piano mensile?",
        "Posso pagare mese per mese?"
      ],
      answer: "Sì, tutti i piani PROMIUM sono disponibili sia mensili che annuali (con sconto 20%).",
      category: "Abbonamenti",
      priority: 3,
      active: true
    })
  }
);
const result = await faq.json();
console.log(result.id); // ID FAQ generato

Analytics & Insights

Il sistema raccoglie automaticamente metriche di utilizzo. Dalla dashboard puoi visualizzare:

Guide CMS

<!-- WordPress: incolla in un blocco HTML personalizzato
     oppure nel file footer.php del tema -->

<!-- 1. Aggiungi il container dove vuoi il widget -->
<div id="promium-faq"
     data-faq-id="TUO_FAQ_ID"
     data-theme="light"
     data-lang="it">
</div>

<!-- 2. Aggiungi lo script (una volta sola, prima di </body>) -->
<script src="https://cdn.promiumai.com/faq/v2/widget.js" async></script>

<!-- OPPURE: usa il plugin ufficiale PROMIUM per WordPress
     Installa → Attiva → Inserisci shortcode [promium_faq id="TUO_FAQ_ID"] -->

{% comment %} Shopify: aggiungi nel file theme.liquid prima di </body> {% endcomment %}

<div id="promium-faq"
     data-faq-id="TUO_FAQ_ID"
     data-theme="light"
     data-lang="it">
</div>
<script src="https://cdn.promiumai.com/faq/v2/widget.js" async></script>

{% comment %}
  Per la pagina FAQ dedicata:
  1. Crea una nuova pagina in Shopify Admin → Online Store → Pages
  2. Seleziona il template "page.faq" (o crea sections/faq.liquid)
  3. Inserisci il div sopra nel template
{% endcomment %}

<!DOCTYPE html>
<html lang="it">
<head>
  <meta charset="UTF-8">
  <title>FAQ | La mia azienda</title>
</head>
<body>

  <main>
    <h1>Domande frequenti</h1>

    <!-- Widget PROMIUM FAQ -->
    <div id="promium-faq"
         data-faq-id="TUO_FAQ_ID"
         data-theme="light"
         data-show-categories="true"
         data-show-search="true"
         data-max-results="10">
    </div>
  </main>

  <!-- Script sempre prima di </body> -->
  <script src="https://cdn.promiumai.com/faq/v2/widget.js" async></script>

</body>
</html>

FAQ su questa documentazione

Il widget funziona senza JavaScript?

No, il widget richiede JavaScript abilitato. Per SEO, considera di inserire le FAQ anche in markup HTML statico (schema.org FAQPage) affiancato al widget.

Quante FAQ posso caricare?

Dipende dal piano: Piano Starter fino a 200 FAQ, Piano Pro fino a 2.000, Piano Enterprise illimitato.

Il widget è multilingua?

Sì. Puoi creare versioni separate della Knowledge Base per ogni lingua, e il parametro data-lang seleziona automaticamente la versione corretta basandosi sulla lingua del browser dell'utente.

Come integro il Sistema FAQ con PROMIUM Assistant?

Usa il parametro data-fallback="chatbot" e data-chatbot-id="TUO_CHATBOT_ID". Quando una domanda non trova risposta nelle FAQ, il sistema apre automaticamente il chatbot PROMIUM nello stesso contesto.