Inizia
Costruisci un chatbot utile prima di inserirlo nel sito. La sequenza fondamentale è crea → aggiungi contenuti → esamina → prova → personalizza → integra.
1. Crea un account e un progetto
Accedi alla dashboard ChattyBox, seleziona New Chatbot e assegna un nome al progetto. Il progetto si apre in Content, dove compariranno le pagine indicizzate e i processi di crawling.
Consulta i prezzi per conoscere i limiti attuali relativi a progetti, pagine e utilizzo.
2. Configura la fonte dei contenuti
Apri Settings e aggiungi il sito che deve fornire la base per le risposte del chatbot. Scegli la modalità di individuazione, i limiti di pagine, le regole di inclusione o esclusione e la pianificazione degli aggiornamenti, quindi salva la configurazione della fonte.
Esegui Scrape now. ChattyBox individua le pagine selezionate, estrae i contenuti leggibili e li prepara per il recupero. L’operazione può richiedere alcuni minuti, a seconda del sito e del numero di pagine.
Usa Aggiungi e aggiorna i contenuti quando ti servono indicazioni su sitemap, URL manuali, crawling, contenuti multilingue o nuovo crawling.
3. Esamina i contenuti indicizzati
Torna in Content e verifica che le pagine previste siano state indicizzate correttamente. Risolvi i processi non riusciti, le pagine irrilevanti o le sezioni mancanti prima di valutare le risposte. Un chatbot non può rispondere in modo affidabile a informazioni che non sono state indicizzate.
4. Prova la qualità delle risposte
Apri Test Chat e poni domande rappresentative che i visitatori reali utilizzeranno. Verifica che le risposte:
- usino la documentazione indicizzata invece di supposizioni non supportate;
- rimandino a pagine fonte utili;
- gestiscano le informazioni mancanti con il fallback previsto;
- funzionino per le lingue e la terminologia importanti.
Migliora i contenuti fonte o le regole di indicizzazione e avvia di nuovo il crawling quando una risposta è debole. Non installare il chatbot solo perché il primo crawling è terminato.
5. Personalizza l’esperienza
Usa Persona per regolare il comportamento dell’assistente e il testo del fallback. Se prevedi di usare il widget ospitato, usa Embed per visualizzare in anteprima titolo, messaggio di benvenuto, colori, icona, posizione e comportamento linguistico.
Queste scelte vengono dopo i test sui contenuti, così la configurazione visiva non nasconde problemi di recupero o di documentazione.
6. Scegli un’integrazione
| Obiettivo | Passaggio successivo |
|---|---|
| Montare l’interfaccia gestita di ChattyBox dal codice dell’applicazione | SDK JavaScript |
| Creare e gestire una propria interfaccia | SDK JavaScript headless |
| Lasciare che un assistente di programmazione IA integri il pacchetto npm | Integrazione assistita dall’IA |
| Gestire la configurazione del progetto da Git e CI | CLI e deployment della configurazione |
| Usare l’interfaccia gestita senza npm né un passaggio di build | Script del widget ospitato |
Le integrazioni per il browser richiedono una chiave API pubblica del widget. Creane una in Public Keys, limita le origini consentite ai domini che devono poter chiamare il chatbot, poi torna in Embed per selezionarla e copiare lo snippet generato e l’URL API.
Le chiavi pubbliche del widget sono pensate per comparire nel codice del browser. I token di deployment della configurazione e le altre credenziali di gestione sono private e non devono mai essere aggiunti a un sito web.
7. Convalida prima del lancio
Installa prima l’integrazione scelta su un sito di anteprima o staging. Prima di pubblicare, prova l’origine sottoposta a deployment, la navigazione tra le route, le citazioni, il comportamento di fallback, il layout mobile e la console del browser.
Completa la checklist di lancio, poi usa Analytics e Content Gaps per migliorare la documentazione quando arrivano domande reali.