HomeDocumentazione

Gestione FAQ

Le FAQ (Frequently Asked Questions) sono il modo più diretto per addestrare il suo chatbot. Aggiunga domande comuni e le loro risposte per garantire risposte accurate e coerenti.

Panoramica

Il sistema FAQ in ChatReact include:

  • Creazione manuale delle FAQ
  • Suggerimenti FAQ generati dall'AI (su richiesta tramite pulsante o Improvement Agent)
  • Organizzazione per categorie
  • Traduzioni in tutte le 24 lingue UE
  • Controlli di pubblicazione
  • Un widget FAQ incorporabile per il suo sito web

Creazione delle FAQ

Creazione manuale

  1. Navigare a FAQ nella barra laterale
  2. Cliccare Aggiungi FAQ
  3. Compilare i dettagli:
FieldDescription
QuestionCome i clienti tipicamente pongono questa domanda
AnswerLa risposta completa e accurata
CategoriaRaggruppamento opzionale per l'organizzazione
  1. Cliccare Crea FAQ

Le nuove FAQ vengono pubblicate immediatamente. Per metterne una offline, clicchi Salva come bozza sulla sua card — Pubblica la rende nuovamente attiva.

Il numero di FAQ che può creare per chatbot dipende dal suo piano di abbonamento — veda Billing.

Scriva le domande come le formulano effettivamente i clienti, incluse le tipiche imprecisioni o il linguaggio informale.

Formattazione delle risposte

Le risposte si modificano con un editor WYSIWYG rich-text con le seguenti opzioni di formattazione:

  • Grassetto e corsivo
  • Elenchi puntati e numerati
  • Link (visualizzati come link cliccabili nel widget)
  • Interruzioni di riga e paragrafi

Lo stesso editor rich-text viene utilizzato anche quando si modificano i suggerimenti FAQ, quindi può formattare le risposte prima di accettarle.

Categorie

Creazione delle categorie

  1. Vada a FAQ → scheda Categorie
  2. Clicchi Aggiungi categoria
  3. Inserisca un nome categoria e una descrizione opzionale
  4. Salvi

Categorie suggerite

Categorie comuni includono:

  • Pricing & Billing
  • Account Management
  • Technical Support
  • Shipping & Returns
  • Getting Started
  • Features & Capabilities

Organizzare le FAQ

  • Assegni una categoria usando il menu a discesa sulla card di ogni FAQ
  • Filtri per categoria nella vista elenco
  • Le categorie appaiono nel widget FAQ come schede

Ordine di visualizzazione

Controlli come le FAQ sono visualizzate nel widget incorporato. Configuri questo in FAQ → Impostazioni → Comportamento:

Sort ModeDescription
DataFAQ più recenti in cima
NomeOrdine alfabetico per domanda
PersonalizzatoOrdinamento manuale con drag & drop

Quando è selezionato Personalizzato, le schede Published e Drafts mostrano una maniglia di trascinamento e un input numerico per l'ordine su ogni card FAQ. Trascini le card per riordinare o inserisca un numero per spostare una FAQ in una posizione specifica.

Ordine per categoria

Ogni categoria può avere una modalità di ordinamento indipendente. Configuri questo nella scheda Categorie:

  • La scheda "All" nel widget usa la modalità di ordinamento globale dalle Widget Settings
  • Le singole schede di categoria usano la loro modalità di ordinamento
  • Questo permette strategie di ordinamento diverse per categoria (es. alfabetico per "General" ma personalizzato per "Pricing")

Suggerimenti FAQ

I suggerimenti FAQ vengono generati su richiesta (non automaticamente dalla chat):

  1. Genera dalla Knowledge Base – Utilizzi il pulsante nella pagina Suggerimenti FAQ per creare suggerimenti dal contenuto del sito indicizzato.
  2. Agente di miglioramento – L'agent può suggerire nuove FAQ o aggiornamenti come parte delle sue proposte di miglioramento.
  3. Manuale – Crei le FAQ da sola in qualsiasi momento.

Generare dalla Knowledge Base

Può generare suggerimenti FAQ dal contenuto del suo sito web indicizzato:

  1. Vada a FAQ → scheda Suggestions
  2. Clicchi Genera dalla Knowledge Base
  3. Opzionale: selezioni una categoria per una generazione mirata
  4. Attenda il completamento dell'analisi AI
  5. Revisioni i suggerimenti generati

Analisi intelligente delle lacune

Quando non seleziona una categoria, ChatReact utilizza l'analisi intelligente delle lacune:

  • L'AI analizza le FAQ esistenti e la knowledge base
  • Rileva automaticamente quali argomenti sono già ben coperti
  • Genera FAQ solo per argomenti insufficientemente coperti (0-1 FAQ)
  • Prioritizza argomenti di importanza aziendale: prezzi, servizi, requisiti, processi

L'analisi delle lacune previene duplicati e si concentra sui reali gap di conoscenza.

Generazione basata su categoria

Quando seleziona una categoria, l'AI utilizza la ricerca semantica:

  • Cerca nella knowledge base informazioni specifiche relative alla categoria scelta
  • Estrae contenuti rilevanti (fino a 1500 parole)
  • Genera FAQ specifiche per quella categoria

Assegnazione automatica della categoria

Se ha configurato le categorie FAQ, l'AI suggerirà automaticamente la categoria più appropriata per ogni FAQ generata. Questo le fa risparmiare tempo nell'organizzazione delle FAQ.

Revisione dei suggerimenti

  1. Vada a FAQ → scheda Suggestions
  2. Revisioni ogni suggerimento:
    • Veda il punteggio di confidenza e la categoria suggerita dall'AI (se esistono categorie)
    • Modifichi la domanda e la risposta secondo necessità — il pulsante Approve & Publish della finestra di modifica pubblica la sua versione modificata
  3. Clicchi Approve per aggiungere il suggerimento alle sue FAQ o Reject per scartarlo

I Suggerimenti FAQ sono disponibili dal piano Starter in su.

Pubblicazione

Bozza vs Pubblicato

StatusBehavior
BozzaVisibile solo nella dashboard, non usata dal chatbot
PublishedAttiva nelle risposte del chatbot e nel widget FAQ

Modifica dello stato di pubblicazione

Ogni card FAQ ha i propri controlli: clicchi Salva come bozza per mettere offline una FAQ pubblicata, o Pubblica per rendere attiva una bozza.

Widget FAQ

Mostri le FAQ sul suo sito web come componente autonomo:

Incorporamento

<div id="chatreact-faq"></div>
<script 
  src="https://www.chatreact.ai/embed/faq-widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  async
></script>

Può trovare il codice embed pronto per essere copiato in FAQ → scheda Incorpora.

Mostrare solo categorie specifiche

Aggiunga l'attributo opzionale data-categories per mostrare solo le FAQ di categorie specifiche, usando gli slug delle categorie separati da virgole:

<script 
  src="https://www.chatreact.ai/embed/faq-widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-categories="slug1,slug2"
  async
></script>

Senza questo attributo, vengono mostrate tutte le FAQ pubblicate — con schede di categoria quando ha più di una categoria. Gli slug delle categorie disponibili sono elencati nella scheda Incorpora.

WordPress

Con il plugin ChatReact per WordPress installato, può incorporare il widget FAQ nativamente:

  • Shortcode: [chatreact_faq id="YOUR_CHATBOT_ID"]
  • Shortcode con filtro categoria: [chatreact_faq id="YOUR_CHATBOT_ID" categories="slug1"]
  • Blocco Gutenberg: cerchi "ChatReact FAQ" nell'inseritore di blocchi

La scheda Incorpora fornisce shortcode pronti da copiare e un link per il download del plugin. Veda WordPress → per la configurazione del plugin.

I siti WordPress e CMS connessi fanno cache dei dati delle FAQ. La cache si aggiorna automaticamente quando pubblica, aggiorna o elimina FAQ — può anche cancellarla manualmente con Clear Remote Cache nella scheda Embed.

Shopify

Aggiunga il widget FAQ al suo store Shopify tramite il Theme Editor (consigliato):

  1. Installi l'app ChatReact dallo Shopify App Store
  2. Apra il Theme Editor di Shopify (Online Store → Customize)
  3. Clicchi Add section o Add block e cerchi "ChatReact FAQ"
  4. Inserisca il suo Chatbot ID e configuri categorie e lingua

In alternativa, incolli il codice embed in una sezione Custom Liquid del suo tema. Veda Shopify → per i dettagli.

Funzionalità del widget

  • Domande espandibili in stile accordion
  • Schede di categoria (visibili quando ha più di una categoria)
  • SEO-friendly: le FAQ vengono renderizzate in un formato amichevole per i motori di ricerca con dati strutturati FAQPage per i rich snippet
  • Si abbina ai colori del suo brand
  • Larghezza configurabile (100% o larghezza personalizzata 400–1200px)
  • Ordine configurabile (Data, Nome o Personalizzato per categoria)

Impostazioni del widget

Personalizzi l'aspetto e il comportamento del widget in FAQ → Impostazioni:

SettingOptions
ColorsPreimpostazioni Light/Dark, oltre a colori primario, sfondo, testo e bordo
Raggio angoliRegoli l'arrotondamento degli angoli
Titolo e layoutMostri o nasconda il titolo, imposto un testo titolo personalizzato, scelga Spaziatura Compact, Normal o Relaxed
Larghezza massima100% o una larghezza in pixel personalizzata
Consenti aperture multiplePermetta ai visitatori di aprire più FAQ contemporaneamente
Apri automaticamente la prima FAQEspanda automaticamente la prima FAQ
FAQ Sort OrderData, Nome o Personalizzato

Traduzioni

Tradurre le FAQ

ChatReact supporta la traduzione delle FAQ in tutte le 24 lingue UE:

  1. Vada a FAQ → scheda Traduzioni
  2. Scelga una FAQ dal menu a tendina Selezioni FAQ...
  3. Passi alla scheda della lingua di destinazione
  4. Modifichi le traduzioni manualmente, o usi Traduca questa FAQ per tradurre una singola FAQ con l'AI

Traduzione in blocco

Traduca tutte le FAQ contemporaneamente usando il pulsante Traduci tutto:

  • Le traduzioni vengono eseguite come job in background sul server — può lasciare la pagina o chiudere il browser
  • Il progresso è salvato e mostrato quando ritorna
  • Una notifica appare nella campanella quando tutte le traduzioni sono complete
  • Usi il pulsante Annulla per interrompere il processo in qualsiasi momento
  • Le traduzioni vengono salvate immediatamente man mano che ogni FAQ viene processata

La lingua sorgente viene rilevata automaticamente per ogni FAQ, quindi anche se alcune FAQ sono scritte in una lingua diversa da quella principale del chatbot, verranno tradotte correttamente.

Ricerca e filtro

Trovare le FAQ

Usi la barra di ricerca per trovare le FAQ per:

  • Testo della domanda
  • Contenuto della risposta
  • Nome della categoria

Filtri e ordinamento

  • Per stato: passi tra le schede Published e Bozze
  • Per categoria: filtri l'elenco con il selettore di categoria
  • Ordinamento: ordini le FAQ per Data, Nome o Categoria con un toggle ascendente/descendente — oppure scelga Personalizzato per l'ordinamento manuale

Best Practices

  1. Inizi con le prime 20: parta dalle domande più comuni
  2. Sia specifico: "Come annullo?" vs "Come annullo il mio abbonamento mensile?"
  3. Mantenga le risposte utili: includa passi successivi o link quando rilevante
  4. Riveda regolarmente: controlli quali domande vengono poste ma non sono risposte
  5. Usi le categorie: l'organizzazione aiuta sia Lei che i visitatori
  6. Monitori i suggerimenti: i suggerimenti AI rivelano gap di conoscenza

Prossimi passi