Risoluzione dei problemi
Utilizza questa pagina quando il widget è installato ma non si comporta come previsto.
Il widget non viene visualizzato
Controlla prima la console del browser. ChattyBox segnala qui gli attributi richiesti mancanti.
Cause comuni:
- Lo script non è presente nell'origine della pagina distribuita.
- Lo script è stato aggiunto al modello, al layout, al contenitore del gestore tag o all'area codice CMS sbagliati.
- Lo script si trova dietro una regola di consenso o un trigger del gestore tag che non si è attivato.
- La stessa shell dell'app rimuove lo script durante la navigazione sul lato client.
- Una politica di sicurezza dei contenuti blocca
https://chattybox.ai/widget.js. - CSS o un altro widget si sovrappone al launcher.
Correzione più piccola:
- Apri la pagina pubblica distribuita in una finestra di navigazione in incognito.
- Cerca l'origine della pagina per
chattybox.ai/widget.js. - Verifica che lo script venga visualizzato una volta e includa
data-api-keyedata-api-url. - Sposta lo script nel piè di pagina globale, nel layout dell'app, nella root Docusaurus o nell'attivatore GTM Tutte le pagine se manca.
data-api-url mancante
Il widget si chiude in anticipo quando manca data-api-url.
Utilizza lo snippet completo dalla dashboard o aggiungi l'attributo richiesto:
<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-api-url="YOUR_WIDGET_API_URL"
async
></script>
Se la dashboard mostra un URL API diverso, utilizza il valore della dashboard anziché il valore di esempio.
Errori di chiave o origine API non validi
Cause comuni:
- La chiave del widget pubblico è stata copiata in modo errato.
- La chiave è stata eliminata, scaduta o creata per un progetto diverso.
- Una chiave di gestione temporanea è stata distribuita in produzione oppure una chiave di produzione è stata distribuita in gestione temporanea.
- La chiave ha origini consentite e l'origine del sito corrente non è inclusa.
- La pagina viene caricata da
http://localhost, un URL di anteprima o un dominio personalizzato non consentito per quella chiave.
Correzioni:
- Apri il progetto nella dashboard ChattyBox.
- Copia un nuovo snippet dalla scheda Incorpora.
- Se sono configurate origini consentite, aggiungi l'origine esatta che serve la pagina, inclusi protocollo e nome host.
- Ridistribuisci o ripubblica il sito ed esegui nuovamente il test in una finestra di navigazione in incognito.
Lingua sbagliata
Un chatbot RAG basato sulle fonti affidabile richiede contenuti fonte chiari per ogni risposta.
Il widget sceglie la lingua in questo ordine:
data-localesullo script del widget.- Il valore
<html lang>della pagina. - La lingua del browser del visitatore.
- Ripiego inglese.
Correzioni:
- Rimuovi un valore
data-localeerrato se la pagina deve rilevare automaticamente la lingua. - Imposta
<html lang="de">,<html lang="fr">o il codice della lingua corrispondente sulle pagine localizzate. - Aggiungi
data-locale="de"solo quando una pagina deve forzare una lingua dell'interfaccia utente del widget specifica. - Elimina nuovamente tutte le versioni linguistiche se le risposte citano o recuperano contenuti dalla lingua sbagliata.
Nessuna citazione o risposta debole
ChattyBox risposte da contenuti indicizzati. Citazioni mancanti o risposte deboli di solito significano che il contenuto originale necessario non è stato recuperato o non risponde chiaramente alla domanda.
Correzioni:
- Fai la stessa domanda nella chat di test della dashboard e confronta le pagine citate.
- Assicurati che la pagina di origine sia pubblica e inclusa nella scansione.
- Aggiungi titoli chiari, esempi, domande frequenti e testo di risposta diretto alla pagina di origine.
- Evita di fare affidamento su screenshot, video, fisarmoniche nascoste o contenuti iframe come unica fonte.
- Cancella nuovamente la pagina aggiornata, quindi prova di nuovo.
Pagine non raschiate o contenuti obsoleti
Cause comuni:
- La pagina manca dalla mappa del sito inviata.
- La modalità URL manuale non includeva la pagina.
- La pagina reindirizza, blocca i crawler, richiede l'autenticazione o è esclusa dalle regole dei robot.
- Il contenuto della pagina è cambiato dopo l'ultimo scrap.
- Il contenuto viene visualizzato in modo tale che il crawler non possa estrarre testo utile.
Correzioni:
- Conferma che la pagina si apra pubblicamente in una finestra del browser privata.
- Utilizza la modalità mappa del sito per un'ampia copertura o URL manuali per un set curato.
- Invia l'URL canonico anziché un URL di monitoraggio, un URL di reindirizzamento o un URL di accesso.
- Eseguire nuovamente lo scraping dopo aver pubblicato le modifiche ai contenuti.
- Controlla la dashboard per le pagine non riuscite o saltate.
Ancora bloccato
Raccogli questi dettagli prima di contattare l'assistenza:
- L'URL della pagina pubblica in cui dovrebbe apparire il widget.
- Uno screenshot o una copia di qualsiasi errore della console del browser.
- Indica se la pagina utilizza HTML, Next.js, Docusaurus, WordPress, CMS o Google Tag Manager.
- Se lo snippet include
data-api-keyedata-api-url. - Una domanda di prova che dovrebbe funzionare e la pagina di origine che risponde.