Inizia
Le quote documentate di pagine incluse sono condivise tra i progetti dello stesso proprietario. Consulta i prezzi per le quote dei piani e Account e fatturazione nella dashboard per l’utilizzo attuale e la quota disponibile del tuo account.
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 Nuovo chatbot e assegna un nome al progetto e, facoltativamente, un URL del sito web. Dopo la creazione si apre Conoscenza → Importazione e aggiornamento. Se apri un progetto senza una scheda selezionata, la vista predefinita è Panoramica. La creazione da sola non avvia un’importazione.
Consulta i prezzi per conoscere i limiti attuali relativi a progetti, pagine e utilizzo.
2. Configura la fonte dei contenuti
In Conoscenza → Importazione e aggiornamento, collega il sito pubblico, esamina le pagine individuate, modifica la selezione consigliata o personalizzata e avvia l’importazione o l’aggiornamento delle sole pagine selezionate. Le impostazioni della fonte vengono salvate automaticamente: controlla lo stato del salvataggio e correggi gli errori di convalida o riprova un salvataggio non riuscito prima di continuare. Le impostazioni avanzate della fonte offrono anche un’azione separata Avvia scraping ora, che usa la modalità di individuazione configurata. Le regole di inclusione/esclusione e la profondità di crawling sono disponibili tramite configurazione come codice, non nei controlli della dashboard.
ChattyBox estrae i contenuti HTML leggibili e mette in coda i contenuti modificati per l’indicizzazione. Individuazione e salvataggio automatico non avviano da soli l’importazione. Il sistema non esegue JavaScript e non applica robots.txt: usa solo pagine pubbliche che sei autorizzato a indicizzare e seleziona con attenzione l’ambito iniziale. I tempi dipendono dall’individuazione, dal numero di pagine e dal lavoro di indicizzazione.
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
Apri Conoscenza → Pagine e confronta le pagine effettive con le fonti previste. Esamina il processo di scraping per controllare i conteggi e gli avvisi di contenuto parziale; verifica anche il processo separato di generazione degli embedding prima di valutare le risposte. Uno scraping completato non garantisce che ogni pagina richiesta o ogni sezione sia stata indicizzata. Consulta avanzamento e indicizzazione parziale.
4. Prova la qualità delle risposte
Apri Prova il chatbot 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.
Se una risposta è debole, migliora i contenuti fonte o la selezione delle fonti e aggiorna quando lo consente l’intervallo del piano: con Free gli aggiornamenti sono al massimo settimanali, con i piani a pagamento al massimo giornalieri. Prova il chatbot usa la quota di messaggi del proprietario e salva le conversazioni. Le interazioni di prova possono comparire in Analisi e, se rilevate come senza risposta, in Domande senza risposta; l’addebito e la registrazione delle lacune dipendono dall’esito. Non installare il chatbot solo perché il primo scraping è terminato.
5. Personalizza l’esperienza
Usa Personalizza → Comportamento per scegliere Assistente disponibile, Rappresentante vendite, Supporto tecnico, Bot sarcastico o Persona personalizzata e modificare le istruzioni. Le modifiche vengono salvate automaticamente: controlla lo stato del salvataggio prima di continuare. Modificando un preset, lo stato passa a Personalizzato. Le istruzioni integrano le regole di grounding e formattazione di ChattyBox; i contenuti recuperati vengono aggiunti automaticamente, quindi non copiare la knowledge base nel prompt.
Il testo della persona non sostituisce il fallback imposto quando manca il contesto o ci sono lacune nei contenuti. L’impostazione separata assistant.fallbackMessage è disponibile tramite configurazione come codice, non come campo della persona. Dopo il salvataggio, prova sia le domande supportate sia il comportamento di fallback. Se prevedi di usare il widget ospitato, usa Personalizza → Aspetto per visualizzare titolo, messaggio di benvenuto, colori, icona, posizione e comportamento linguistico. Anche queste modifiche vengono salvate automaticamente: controlla lo stato del salvataggio. La modalità fissa e gli override dello script influiscono sulla lingua dell’interfaccia del widget, non sulle lingue delle pagine indicizzate; consulta la risoluzione dei problemi relativi alla lingua. Il piano Free include lo stile ma richiede il branding ChattyBox; Starter e i piani superiori consentono di nasconderlo.
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. Una chiave preparata per il dominio di un sito potrebbe essere già limitata a quell’origine; le chiavi create senza restrizioni funzionano invece su origini diverse. In Installa → Chiavi e domini, usa Modifica origini per gestire le restrizioni facoltative e aggiungere le origini di produzione, anteprima, staging e localhost necessarie. Se abilitate, le restrizioni richiedono una corrispondenza esatta di schema, hostname e porta (ad esempio, https://example.com e http://localhost:3000 sono origini diverse). Sono un rafforzamento facoltativo, non un metodo di autenticazione dei visitatori. In Installa → Installazione sul sito web, seleziona la chiave e copia 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.
Per recuperare una chiave pubblica esistente, inserisci un URL del sito HTTP(S) in Installazione sul sito web e seleziona la chiave nello snippet. Il selettore mostra le chiavi non scadute senza restrizioni oppure consentite per l’origine dell’URL. Per selezionare una chiave limitata, inserisci un’origine consentita; usa Gestisci chiavi e domini consentiti per verificarne le restrizioni. Se il modulo non è disponibile, completa prima il passaggio di configurazione mostrato nella dashboard. Per ruotare una chiave, creane una nuova, aggiorna e verifica l’installazione, quindi elimina la vecchia: l’eliminazione interrompe subito le installazioni che la usano ancora. Una chiave appartiene a un solo chatbot; chiamarla “staging” o “production” non separa gli ambienti.
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 Conversazioni → Cronologia per consultare i log, disponibili su tutti i piani, oppure Analisi e Domande senza risposta con Pro e Business per migliorare la documentazione quando arrivano domande reali.
Mappa della dashboard
Apri un progetto all’indirizzo /chatbot/<projectId>. Le viste sono schede selezionate tramite il parametro query tab, non pagine secondarie separate:
| Vista | Valore query | Utilizzo |
|---|---|---|
| Panoramica | overview | Controllare l’avanzamento della configurazione e l’attività recente |
| Conoscenza → Importazione e aggiornamento | settings | Individuare, selezionare, importare e aggiornare le pagine; modificare le impostazioni della fonte |
| Conoscenza → Pagine | content | Esaminare le pagine e i processi di scraping, eliminare contenuti e ricostruire gli embedding |
| Prova il chatbot | test | Porre domande e tornare alle conversazioni salvate |
| Conversazioni → Cronologia | logs | Leggere le conversazioni salvate ed eliminarne una o tutte |
| Conversazioni → Analisi | analytics | Esaminare gli ultimi 30 giorni di interazioni registrate, fino a 5.000; Pro/Business |
| Conversazioni → Domande senza risposta | gaps | Esaminare e risolvere le domande senza risposta rilevate; Pro/Business |
| Personalizza → Comportamento | prompts | Scegliere o modificare le istruzioni dell’assistente |
| Personalizza → Aspetto | appearance | Visualizzare e modificare l’aspetto e la lingua del widget ospitato |
| Installa → Chiavi e domini | keys | Creare/eliminare chiavi pubbliche e modificare le restrizioni facoltative sulle origini |
| Installa → Installazione sul sito web | embed | Preparare un’installazione e copiare lo snippet di una chiave |
| Impostazioni del chatbot | manage | Gestire i dettagli del chatbot, i token di deployment e il blocco della configurazione, o eliminare il chatbot |
Tutti i chatbot torna a /dashboard. La panoramica dell’account è /dashboard/overview; Account e fatturazione si trova in /settings/account e contiene profilo, piano, utilizzo dei messaggi, portale di fatturazione e controlli PAYG. /settings e /settings/billing reindirizzano a questa pagina. /settings/keys consente di scegliere un progetto per creare o eliminare chiavi pubbliche; le restrizioni facoltative sulle origini si modificano nella vista Chiavi e domini del chatbot.
Permessi e blocco della configurazione
L’accesso ai progetti nella dashboard è riservato al proprietario (o all’utente proprietario di un workspace legacy). Una chiave pubblica del widget non consente di accedere alle impostazioni del progetto o alla cronologia delle conversazioni salvate; la sola appartenenza a un’organizzazione non concede questi permessi.
Per gestire il progetto tramite Git/CI, Impostazioni del chatbot consente di creare token di deployment della configurazione con ambiti di sviluppo, anteprima e/o produzione, scadenza facoltativa e revoca. Il valore completo del token è visibile solo al momento della creazione; la sezione mostra anche la cronologia dei deployment.
L’azione Attiva il blocco della configurazione è irreversibile. Blocca le modifiche alla configurazione dalla dashboard e le operazioni manuali sui contenuti, inclusi il salvataggio della persona e Avvia scraping ora, anche se i controlli restano visibili. Da quel momento distribuisci la configurazione tramite il flusso CLI. Gestione delle chiavi pubbliche, pulizia delle conversazioni e preferenza di branding consentita dal piano restano separate dai campi bloccati. Gli ambiti ambientali dei token autorizzano i deployment: non creano chatbot separati né ambienti distinti per le chiavi browser.
La configurazione come codice espone anche widget.enabled: impostandolo su false si disattiva la chat pubblica, incluso l’SDK headless, non solo il widget flottante. Il modulo Aspetto attuale non offre un interruttore per attivarlo o disattivarlo.
Piani e quote
| Piano | Chatbot | Pagine dell’account | Messaggi al mese |
|---|---|---|---|
| Free | 1 | 10 | 100 |
| Starter | 3 | 150 | 1.000 |
| Pro | 10 | 5.000 | 10.000 |
| Business | 25 | 25.000 | 50.000 |
Le quote di messaggi e pagine archiviate incluse sono condivise a livello di proprietario tra i suoi chatbot, compreso Prova il chatbot. Il lavoro mensile di aggiornamento delle pagine e gli intervalli minimi tra gli aggiornamenti sono limiti distinti: consulta i limiti di aggiornamento prima di un’importazione o ricostruzione di grandi dimensioni. Consulta i prezzi per le quote condivise documentate e Account e fatturazione per l’utilizzo e la quota disponibili del tuo account.
Il PAYG per messaggi, pagine e siti è facoltativo nei piani Pro/Business ed è disattivato per impostazione predefinita. In Account e fatturazione, imposta budget mensili di eccedenza per funzione oppure seleziona esplicitamente Nessun limite di spesa. Un budget pari a zero mantiene il limite rigido per quella funzione; senza limite di spesa l’utilizzo può generare addebiti senza tetto. Il PAYG non sblocca le funzioni dei piani Free/Starter e non aggira gli intervalli di aggiornamento del crawler. Qui puoi modificare il nome del profilo; l’email si gestisce nelle impostazioni dell’account del provider di accesso.