# Risoluzione dei problemi: casi comuni e soluzioni > Risolvi i problemi comuni di intoCHAT: bolla della chat assente, scansione senza pagine, risposte vaghe o errate, modulo lead assente e azioni che falliscono. La maggior parte dei problemi ha poche cause. Segui la sezione che corrisponde a ciò che vedi. La console per sviluppatori del browser (F12) spesso indica direttamente la causa. ## La bolla della chat non compare - **Lo script non è nella pagina.** Visualizza il sorgente della pagina e cerca `embed.js`. Molti site builder aggiungono il codice personalizzato solo al sito pubblicato, non all'anteprima dell'editor. Lo script funziona nell'head o nel body; la posizione consigliata è subito prima di ``. Vedi [Installare con un tag script](/it/docs/script-tag). - **ID dell'agente sbagliato.** La console mostra `Chatbot not found.` Copia di nuovo lo snippet dalla scheda **Share**. - **Il sito non è tra i domini consentiti.** La console mostra `intoCHAT: this website is not in the allowed domains of this agent, so the chat is not shown.` L'agente è limitato ad altri siti. Nella scheda **Share**, aggiungi il dominio di questo sito in **Where this agent can appear**, oppure svuota l'elenco per consentire qualsiasi sito. Un nuovo dominio può impiegare fino a un minuto per arrivare alla finestra di chat. Vedi [Domini consentiti](/it/docs/allowed-domains). - **L'agente è privato.** La console mostra `intoCHAT: this agent is private, so the chat is not shown.` Nella scheda **Share**, disattiva **Private agent** e clicca **Save**. - **Google Tag Manager.** GTM rimuove l'attributo `data-chatbot-id` dai tag script nei tag HTML personalizzati, quindi il widget non sa quale agente caricare. La console mostra "The embed script needs a data-chatbot-id attribute." Usa lo snippet della [guida a Google Tag Manager](/it/integrazioni/google-tag-manager). - **Content Security Policy.** Se il sito invia un header CSP, consenti `https://www.intochat.ai` in `script-src`, `connect-src` e `frame-src`. - **Ottimizzatori di script.** Lo script legge l'ID dell'agente dal proprio tag. Se un plugin unisce o riscrive gli script, escludi `embed.js`. - **Blocchi pubblicità o privacy.** Alcune estensioni del browser bloccano gli script di chat di terze parti. Prova in una finestra privata con le estensioni disattivate. - **La bolla compare ma l'agente smette di rispondere.** I visitatori vedono "Message limit reached" quando la quota mensile è esaurita; vedi [Piani e limiti](/it/docs/plans-and-limits). ## Un iframe o il link diretto non mostrano la chat - **L'iframe resta vuoto o mostra un errore del browser.** Il sito non è tra i [domini consentiti](/it/docs/allowed-domains) dell'agente, oppure l'agente è privato. Il browser allora non carica la chat nel riquadro, e la console cita `frame-ancestors`. Aggiungi il dominio del sito nella scheda **Share**, in **Where this agent can appear**. - **"This agent is private."** Disattiva **Private agent** nella scheda **Share**. Finché è attivo, solo tu puoi chattare con l'agente, nel **Playground**. - **"This agent doesn't exist anymore."** L'ID dell'agente nell'indirizzo è sbagliato, oppure l'agente è stato eliminato. Copia di nuovo il codice dalla scheda **Share**. - **"The chat couldn't load. Please try again later."** Non è stato possibile caricare le impostazioni dell'agente. Ricarica la pagina. ## La scansione del sito non trova pagine - **"No pages found"**: intoCHAT non è riuscito a trovare pagine su quel sito. Controlla l'indirizzo, oppure attiva **Single page mode** e aggiungi una alla volta le pagine importanti. - **Tutto filtrato**: controlla **Exclude URLs containing**. Un modello come `/` corrisponde a tutte le pagine. - **"The page answered with an error (403)"** o simili: il sito blocca i visitatori automatici. Chiedi a chi gestisce il sito di consentire l'accesso, oppure carica il contenuto come file o incollalo come testo. - **"No meaningful content found"**: la pagina non ha quasi testo leggibile. - **"Monthly crawl limit reached"**: attendi l'azzeramento mensile o passa a un piano superiore. File, testi e Q&A funzionano comunque. Vedi [Scansione del sito](/it/docs/website-crawl) e [File](/it/docs/files). ## Le risposte sono sbagliate, vaghe o superate 1. Prova la domanda nel **Playground**. 2. Nella scheda **Knowledge**, usa **Preview the text** sulla fonte che dovrebbe contenere la risposta. Se il testo non c'è, la pagina non è stata letta come ti aspettavi. 3. Per le domande frequenti aggiungi una coppia di domanda e risposta. Le risposte Q&A hanno la precedenza. 4. Fai clic sulla stella (**Mark as priority**) della fonte più affidabile. Verrà classificata sopra le altre conoscenze pertinenti e prevarrà in caso di contrasto, senza riaddestrare. 5. Se una pagina del sito è cambiata, fai clic su **Refresh from website** (aggiorna dal sito) nella sua fonte: rilegge la pagina e la riaddestra se il testo è cambiato. Per un file modificato, carica la nuova versione con lo stesso nome e addestra. Le fonti non si aggiornano da sole. 6. Elimina le fonti superate che contraddicono quelle attuali e controlla le **Instructions**. Quando non trova nulla di pertinente, l'agente dice di non saperlo invece di tirare a indovinare. È voluto: aggiungi il contenuto mancante. Vedi [Gestire le fonti](/it/docs/managing-sources). ## Il modulo lead non compare - **Enable lead collection** è attivo e hai fatto clic su **Save lead settings**. - In modalità **Manual (visitor asks)** il modulo compare solo quando il visitatore chiede di essere contattato. - Le regole sulle parole chiave controllano solo l'ultimo messaggio del visitatore. - Il modulo compare al massimo tre volte per conversazione e non più dopo che il visitatore ha lasciato i suoi dati in quella sessione. Per riprovare, apri una nuova finestra privata. - Nelle chat temporanee non compare mai. Vedi [Raccolta lead](/it/docs/lead-collection). ## Un'azione non funziona - Apri l'azione e fai clic su **Send test request** in **2. Try it** per vedere stato e risposta. - **"URL points to a blocked or internal host"**: gli indirizzi privati e interni vengono rifiutati. Usa un URL pubblico. - **"This address redirects somewhere else"**: fai clic su **Use this address**. - **"Request timed out after 30s"**: l'endpoint è troppo lento. - L'agente non la chiama mai: controlla che l'azione sia attiva e che **When to use** descriva le domande a cui serve. - Le azioni lato client funzionano del tutto solo in una pagina con il widget installato e falliscono in un incorporamento inline tramite iframe. Vedi [Azioni lato client](/it/docs/client-actions). Ancora bloccato? Scrivi a support@intochat.ai indicando l'ID del tuo agente.