Inizia
Nella prossima versione, le pagine incluse sono condivise tra i progetti dello stesso proprietario; fino al rollout, la dashboard pubblica potrebbe ancora mostrare i precedenti limiti per chatbot.
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 nome e Website URL facoltativo. La creazione non avvia uno scraping.
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 |
| Aggiungere il widget gestito a WordPress senza modificare il tema | Plugin WordPress |
| Aggiungere il widget gestito a Drupal 10 o 11 con Composer | Modulo Drupal |
Le integrazioni per il browser richiedono una chiave API pubblica del widget. Per impostazione predefinita, le chiavi pubbliche funzionano in produzione, nelle anteprime, nello staging e su localhost. Per un’ulteriore protezione facoltativa, apri Public Keys > Edit origins, abilita Restrict this key to specific origins e aggiungi ogni origine browser consentita. Le origini con restrizioni devono corrispondere esattamente per schema, hostname e porta (ad esempio, https://example.com e http://localhost:3000 sono origini diverse). Torna in Embed per selezionare la chiave 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.