Analisi
Capisci cosa chiedono i tuoi visitatori e migliora i tuoi contenuti sulla base di dati reali.
:::info Accesso al piano
Apri un chatbot da /dashboard, poi scegli Conversazioni. Le viste Analisi e Domande senza risposta sono incluse in Pro e Business; le viste non disponibili mostrano un invito a cambiare piano. Cronologia e Prova il chatbot sono disponibili in tutti i piani. Sono viste del progetto, non metriche della panoramica del workspace.
:::
Usa la checklist di lancio per verificare il rollout, poi confronta piani e limiti prima di scegliere come effettuare la valutazione.
Panoramica del pannello di controllo
Apri Conversazioni → Analisi (/chatbot/<projectId>?tab=analytics). Il pannello mostra gli ultimi 30 giorni e al massimo le 5.000 interazioni registrate più recenti; non ha un selettore di date né un export completo. La finestra di 30 giorni è un filtro del report, non una garanzia di conservazione. Se il volume è elevato, i risultati possono essere limitati e non includere tutto il traffico del periodo.
- Domande totali - Interazioni registrate nella finestra, soggette al limite
- Con risposta - Interazioni generate con successo e non segnalate dal rilevatore automatico di lacune
- Senza risposta - Altre interazioni registrate, comprese le risposte di fallback per mancanza di contesto e gli errori di generazione
- Tasso di risposta - Interazioni con risposta divise per il totale delle interazioni registrate
Sono metriche di classificazione automatica, non misure dell'accuratezza verificata delle risposte, della soddisfazione dei clienti, dei visitatori unici o dei ticket evitati. Le lacune nei contenuti sono un sottoinsieme delle interazioni senza risposta: gli errori di generazione possono essere conteggiati come senza risposta senza creare una lacuna. Il rilevatore esamina il contesto delle fonti, formulazioni simili a risposte di fallback e alcuni termini specifici delle domande; può classificare erroneamente le risposte. Prova il chatbot contribuisce a queste metriche e consuma il limite di messaggi del proprietario. Non è un report riservato ai visitatori né il registro di utilizzo per la fatturazione; le richieste non riuscite non producono necessariamente un record di analisi.
Conversazioni e cronologia
Apri Conversazioni → Cronologia (?tab=logs) per sfogliare le conversazioni salvate del progetto. Seleziona una riga per leggere messaggi e orari in una vista separata di sola lettura; selezionala di nuovo o usa Cronologia nella vista per tornare all’elenco. Puoi eliminare una conversazione o tutte le conversazioni dopo conferma. La cronologia include le chat di prova dalla dashboard e le chat pubbliche; non è il registro interno delle richieste o degli errori API. La vista carica i primi 100 messaggi salvati, quindi il conteggio totale può superare il numero di messaggi visualizzati.
Prova il chatbot (?tab=test) permette anche di selezionare conversazioni salvate, iniziare una nuova chat, copiare le risposte ed eliminare la cronologia. Apri Conversazioni nell'interfaccia di test per selezionare una conversazione salvata o cercare nelle anteprime. La ricerca filtra le anteprime delle conversazioni nella pagina attualmente caricata, non tutti i messaggi del progetto. Nuova chat avvia una conversazione vuota senza eliminare la cronologia salvata; Cancella è un'azione distruttiva separata. Quando una richiesta riutilizza lo stesso conversationId, il generatore di risposte riceve fino a 12 messaggi salvati recenti, ciascuno limitato a 2.000 caratteri. È un contesto limitato, non la trascrizione completa: includi i dettagli precedenti quando servono e mantieni gli ID conversazione separati tra visitatori non correlati.
Eliminare una conversazione da Cronologia o Prova il chatbot rimuove i messaggi salvati, ma non i record di analisi, i record delle lacune nei contenuti, l'utilizzo di messaggi già consumato o i record di ripetizione delle richieste idempotenti. Per le richieste HTTP del widget con una chiave di idempotenza, un record di ripetizione separato conserva il fingerprint della richiesta (che include il messaggio) e, se la richiesta è completata, anche la risposta. Il record ha una scadenza impostata a 24 ore, ma viene rimosso da una procedura di pulizia separata, quindi la cancellazione può avvenire più tardi.
Domande più frequenti
Consulta i testi delle 10 domande più frequenti nella finestra e nel limite delle analisi. Prima di raggrupparli, i testi vengono privati degli spazi iniziali e finali, convertiti in minuscolo e troncati a 500 caratteri; non è un raggruppamento semantico di domande formulate in modo diverso. Usa questa sezione per:
- Capire cosa interessa di più ai visitatori
- Dare priorità ai miglioramenti dei contenuti
- Identificare opportunità per le FAQ
Rilevamento delle lacune nei contenuti
Apri Conversazioni → Domande senza risposta (?tab=gaps) per esaminare le domande segnalate dal rilevatore. Una lacuna non dipende da una frase precisa: il rilevatore può segnalare la mancanza di contesto delle fonti, formulazioni di rifiuto riconosciute e alcune risposte troppo generiche rispetto a termini specifici della domanda. È un candidato da esaminare, non una prova.
- Domanda - Cosa ha chiesto il visitatore
- Conteggio - Quante volte è stata posta
- Ultima richiesta - Quando è stata posta più di recente
Usa questi dati per individuare possibili contenuti mancanti sul tuo sito. Controlla prima la selezione delle fonti, il recupero, la formulazione e la risposta effettiva. Dopo aver aggiunto il contenuto, esegui una nuova scansione entro la quota di aggiornamento e verifica la risposta; poi seleziona Risolvi. È un contrassegno manuale: non addestra il chatbot né verifica la nuova risposta. Elimina rimuove il record della lacuna.
Per impostazione predefinita, Domande senza risposta mostra solo le lacune irrisolte. Seleziona Includi le lacune risolte. per includere quelle risolte; su una lacuna risolta puoi selezionare Annulla per riportarla tra quelle irrisolte. In entrambi i casi vengono mostrati i 100 record corrispondenti più recenti, poi ordinati per conteggio. Il contatore delle lacune irrisolte è limitato a 500, un limite distinto dai 100 record della lista. Se la stessa domanda normalizzata si ripresenta, il conteggio aumenta ma il record non viene riaperto automaticamente. Questi record sono separati dalla finestra di 30 giorni di Analisi.
Usa queste lacune insieme alla guida alla misurazione della riduzione dei ticket per testare la copertura delle domande ripetute e confrontare qualsiasi impatto sul supporto con la tua baseline, invece di dare per scontato un risultato.
Ore di picco del traffico
Consulta le cinque fasce orarie con il maggior numero di interazioni nella stessa finestra di analisi. Le ore sono registrate sul backend e visualizzate senza conversione al fuso orario dei visitatori: non permettono di identificare il fuso orario del pubblico. Usale per:
- Pianificare gli aggiornamenti dei contenuti nei momenti di minor traffico
- Confrontare le fasce più e meno frequentate usando una base di reporting coerente
- Pianificare la capacità necessaria se ti stai avvicinando ai limiti
Trigger più usati
Il pannello Trigger più usati mostra le 10 URL delle pagine da cui provengono le domande registrate, non le pagine più citate né le visualizzazioni di pagina. Il widget ospitato widget.js, compreso quello montato con Chattybox.mountWidget(), prova a inviare automaticamente il contesto della pagina senza query string o frammenti; il codice sorgente corrente lo omette se non è valido o supera i limiti di lunghezza.
Privacy: sulle pagine HTTP(S), il widget ospitato prova a inviare il percorso della pagina corrente con le richieste di chat; rimuove query string, frammenti e credenziali, ma non il percorso. Non caricare né mantenere attivo il widget su pagine sensibili o private. In una SPA, escludere il loader da una nuova route non rimuove un widget già inizializzato. Quando è opportuno rimuoverlo, esegui esplicitamente il teardown con window.ChattyBox.destroy() dopo l'inizializzazione, oppure rimuovi tutti gli handle dell'SDK con remove().
La versione pubblicata dell'SDK headless 0.1.4 accetta message, conversationId e idempotencyKey in sendMessage(). Il codice sorgente attuale supporta anche uiLocale per i testi di fallback del prodotto. Né la versione pubblicata né il codice sorgente attuale supportano sourceUrl o sourcePath: non aggiungere opzioni SDK non supportate per ottenere l'attribuzione della pagina. Anche Prova il chatbot non ha un URL della pagina di origine, quindi le domande possono essere conteggiate anche se il pannello Trigger più usati è vuoto.
Un'integrazione HTTP diretta può inviare sourceUrl e/o sourcePath a POST /chat. È necessaria un'origine HTTP(S) della richiesta, ricavata da Origin quando presente oppure dall'origine di Referer solo quando Origin è assente; sourceUrl deve corrispondere a tale origine e non può contenere credenziali. Il percorso fornito deve iniziare con / (non //), non contenere query o frammenti e, se sono inviati entrambi i valori, corrispondere al pathname dell'URL. Il server rimuove query e frammenti e normalizza l'URL prima di registrarlo. Non inviare mai percorsi privati o dati sensibili dei visitatori come contesto della pagina.
Il contesto della pagina viene usato per l'analisi, inclusa la telemetria delle interazioni; non modifica le fonti indicizzate recuperate dall'assistente.
Citazioni delle fonti
Le risposte possono includere link cliccabili alle pagine usate come contesto recuperato. Questi link possono aiutare i visitatori a esaminare materiale pertinente, ma non verificano che ogni affermazione sia supportata o accurata. Confronta le affermazioni importanti con le pagine di origine. I link alle fonti possono:
- Aiutare i visitatori a valutare la risposta
- Consentire agli utenti di confrontare le informazioni con le pagine pertinenti
- Indirizzare i visitatori a quelle pagine
Il widget presenta le citazioni in un elemento espandibile nativo. I visitatori possono aprire Fonti per esaminare i link citati senza interrompere la risposta.
Come migliorare il tuo Tasso di risposta
Suggerimenti per aumentare il numero di domande con risposta:
- Esamina regolarmente le lacune nei contenuti - Aggiungi al tuo sito le informazioni mancanti
- Estrai più pagine - Includi pagine FAQ, documentazione di supporto e articoli del blog
- Usa titoli chiari - I contenuti ben strutturati sono più facili da trovare
- Mantieni i contenuti aggiornati - Abilita la nuova scansione automatica rispettando la cadenza del tuo piano e il budget mensile di aggiornamento
- Ripeti il test prima di risolvere - Verifica la risposta e le citazioni, senza considerare un tasso di risposta più alto come prova di accuratezza