Passa al contenuto principale
ChattyBox Logo

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:

  1. Apri la pagina pubblica distribuita in una finestra di navigazione in incognito.
  2. Cerca l'origine della pagina per chattybox.ai/widget.js.
  3. Verifica che lo script venga visualizzato una volta e includa data-api-key e data-api-url.
  4. 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="https://app.chattybox.ai"
  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:

  1. Apri il progetto nella dashboard ChattyBox.
  2. Copia un nuovo snippet dalla scheda Incorpora.
  3. Se sono configurate origini consentite, aggiungi l'origine esatta che serve la pagina, inclusi protocollo e nome host.
  4. Ridistribuisci o ripubblica il sito ed esegui nuovamente il test in una finestra di navigazione in incognito.

Lingua sbagliata​

Il widget sceglie la lingua in questo ordine:

  1. data-locale sullo script del widget.
  2. Il valore <html lang> della pagina.
  3. La lingua del browser del visitatore.
  4. Ripiego inglese.

Correzioni:

  • Rimuovi un valore data-locale errato 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:

  1. Conferma che la pagina si apra pubblicamente in una finestra del browser privata.
  2. Utilizza la modalità mappa del sito per un'ampia copertura o URL manuali per un set curato.
  3. Invia l'URL canonico anziché un URL di monitoraggio, un URL di reindirizzamento o un URL di accesso.
  4. Eseguire nuovamente lo scraping dopo aver pubblicato le modifiche ai contenuti.
  5. 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-key e data-api-url.
  • Una domanda di prova che dovrebbe funzionare e la pagina di origine che risponde.