Risoluzione dei problemi: casi comuni e soluzioni

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 </body>. Vedi Installare con un tag script.
• 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.
• 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.
• 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.

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 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 e File.

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.

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.

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.

Ancora bloccato? Scrivi a support@intochat.ai indicando l'ID del tuo agente.