Checklist di lancio

Usa questa checklist prima di presentare ChattyBox ai clienti. Individua le lacune di configurazione più comuni che fanno sembrare un chatbot installato ma non ancora pronto.

Per un rollout del supporto, affianca questa checklist alla guida al chatbot AI per l’assistenza clienti in modo che le risposte basate su contenuti pubblici abbiano un percorso di escalation chiaro per domande specifiche dell’account, sensibili o irrisolte.

Prontezza dei contenuti

• Sono stati selezionati contenuti pubblici e accessibili al crawler da cui il chatbot deve rispondere.
• Pagine private, amministrazione, checkout, account, bozze e staging sono escluse selezionando esplicitamente le fonti; non affidarti solo a robots.txt, che il crawler non applica.
• Hai scelto l’input corretto: sitemap, URL manuali, solo homepage o crawl. Crawl usa le sitemap convenzionali individuate prima di passare ai link; non integra una sitemap incompleta seguendo i link.
• Sono incluse le pagine importanti su prodotto, prezzi, policy, supporto, FAQ, onboarding e risoluzione dei problemi.
• I siti multilingue includono le versioni linguistiche da cui prevedi che il widget risponda.

Convalida dello scraping

• Il job è terminato, sono stati confrontati i conteggi salvati/selezionati e sono presenti le pagine previste. Il badge Completato da solo non prova una copertura completa.
• Il numero di pagine indicizzate corrisponde a quanto previsto dal piano e dall’ambito del lancio.
• Le pagine con Indicizzato parzialmente sono state controllate per il testo mancante oltre il limite di 512 KiB; le pagine lunghe sono state suddivise quando necessario.
• Il processo separato di embedding è terminato ed è stato testato il recupero delle informazioni con domande rappresentative.
• Le pagine modificate o migrate di recente sono state sottoposte a nuovo scraping.
• Per le pagine mancanti sono stati verificati autenticazione, challenge anti-bot, redirect non riusciti o non sicuri, filtri delle fonti e contenuti disponibili solo tramite JavaScript. Il testo importante è presente nell’HTML recuperato senza rendering JavaScript.
• Le pagine obsolete già archiviate sono state eliminate da Conoscenza → Pagine, non solo rimosse dalla sitemap; le fonti sono state aggiornate per impedirne la nuova individuazione.

Utilizzo e titolarità

• Il titolare del progetto può accedere alla dashboard e gestire il chatbot; le chiavi pubbliche e l’appartenenza a un’organizzazione non conferiscono i permessi di gestione del progetto nella dashboard.
• Account e fatturazione in /settings/account dispone di messaggi sufficienti per i test e il traffico di lancio su tutti i chatbot del titolare; i messaggi di Prova il chatbot consumano la stessa quota condivisa.
• Sono stati verificati sia i limiti delle pagine archiviate sia il budget mensile separato di refresh, condiviso tra i progetti del titolare. Anche le ricostruzioni manuali dell’indice consumano lavoro di refresh.
• La frequenza di refresh rispetta il piano: Free consente al massimo un aggiornamento settimanale, i piani a pagamento uno al giorno. I nuovi tentativi manuali di scraping seguono lo stesso periodo di attesa, anche dopo un job non riuscito.
• Per Pro/Business, il PAYG è disattivato, limitato per funzionalità oppure intenzionalmente senza limite di spesa (con possibili addebiti senza limite); non elimina il periodo di attesa del crawler né il budget mensile di refresh.
• Se usi il blocco della configurazione, ne conosci le restrizioni irreversibili e il flusso distinto con token di deployment segreti.

Qualità delle risposte

• Hai posto domande di test reali relative a vendite, supporto, onboarding e documentazione.
• Le risposte rappresentative sono basate sui contenuti indicizzati e le domande non supportate ricevono la risposta di fallback prevista. Esamina le risposte: un test riuscito non garantisce tutte le risposte future.
• Le risposte utili mostrano citazioni delle fonti.
• I link delle citazioni aprono le pagine fonte pubbliche previste.
• Le risposte deboli sono state corrette migliorando i contenuti fonte o aggiungendo pagine mancanti, quindi è stato eseguito nuovamente lo scraping.
• Se la Persona è stata modificata, lo stato di salvataggio conferma che è stata salvata; prima dei test sono stati corretti gli errori di validazione o riprovati i salvataggi non riusciti. Il fallback applicato è stato verificato separatamente; il testo della Persona non sostituisce la risposta configurata per il contesto mancante.
• Le domande di test includono il contesto necessario: il generatore riceve al massimo 12 messaggi salvati recenti, ciascuno limitato a 2.000 caratteri, non l’intera conversazione.

Installazione del widget

• Il widget è installato sulle pagine pubbliche previste.
• Lo script viene caricato una sola volta per pagina.
• Lo script include data-api-key.
• Lo script include data-api-url.
• Rilevamento automatico/Fissa e Consenti override tramite script sono impostati intenzionalmente. data-locale prevale solo se gli override sono consentiti, anche in modalità Fissa.
• Sono stati verificati separatamente la lingua dell’interfaccia del widget, quella delle domande/risposte e le versioni linguistiche indicizzate.
• Il widget si apre e invia una domanda di test in una finestra in incognito.
• I test su viewport mobile confermano che launcher e pannello chat sono utilizzabili.

Controlli della chiave API e delle restrizioni opzionali delle origini

• La chiave pubblica prevista è selezionata in Installa → Installazione sul sito web; gestisci chiavi e origini in Installa → Chiavi e domini.
• La rotazione è stata completata installando e testando la nuova chiave prima di eliminare quella precedente. I nomi delle chiavi, da soli, non separano gli ambienti.
• La chiave è stata testata sui siti di produzione, anteprima/staging e localhost previsti. Una chiave preparata per un sito può essere già limitata alla sua origine; le chiavi create senza restrizioni funzionano da tutte le origini del browser.
• Se è attiva la protezione opzionale, in Chiavi e domini → Modifica origini sono elencate le origini esatte previste (schema, host e porta). Le restrizioni riguardano l’origine, non l’autenticazione dei visitatori né i singoli percorsi; le chiavi pubbliche del browser non sono segreti.
• Nel codice frontend, in GTM, nell’HTML personalizzato del CMS o nel sorgente della pagina non sono presenti chiavi API private del server, token admin o segreti.

Controlli di browser e distribuzione

• La console del browser non contiene errori di ChattyBox.
• Se il sito usa CSP, la Content Security Policy consente lo script del widget e l’URL API.
• Ad blocker o strumenti per il consenso non bloccano il widget sulle pagine in cui deve comparire.
• È stato testato il sito finale distribuito, non solo lo sviluppo locale.

Dopo il lancio

• Controlla Conversazioni → Cronologia su ogni piano e Analisi / Domande senza risposta su Pro o Business.
• Interpreta Analisi come un massimo di 5.000 interazioni registrate negli ultimi 30 giorni, inclusa Prova il chatbot; non dimostra l’accuratezza delle risposte né rappresenta solo il traffico dei visitatori.
• Esamina le lacune rilevate, verifica di nuovo i contenuti migliorati e risolvi manualmente le lacune. L’elenco nasconde per impostazione predefinita quelle risolte: Includi le lacune risolte. e Annulla consentono di visualizzarle e riaprirle. Una ricorrenza non riapre automaticamente una lacuna risolta.
• Se l’attribuzione alle pagine è importante, verifica Trigger più usati. Il widget ospitato prova a inviare il contesto della pagina senza query string o frammento, ma conserva il percorso; il codice sorgente corrente omette il contesto non valido o troppo lungo. Non caricare né mantenere il widget su percorsi sensibili o privati. In una SPA, una regola di attivazione non rimuove un widget già inizializzato: esegui il teardown, ad esempio con window.ChattyBox.destroy() quando l’API è disponibile. L’SDK headless sendMessage() non invia il contesto della pagina.
• Aggiungi documentazione, FAQ o esempi mancanti in base alle domande reali dei visitatori.
• Esegui nuovamente lo scraping delle pagine aggiornate dopo le modifiche ai contenuti.
• Ruota le chiavi pubbliche del widget se necessario; aggiorna le restrizioni delle origini solo se la restrizione opzionale è attiva e cambiano i domini consentiti.
• L’eliminazione delle conversazioni non azzera il consumo né Analytics: queste registrazioni sono separate.

Se un elemento non supera il controllo, usa la Risoluzione dei problemi prima del lancio.