Vai al contenuto
Documentazione

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. I messaggi che la chat mostra ai visitatori sono citati qui in inglese; i visitatori li vedono nella lingua del widget.

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.
  • Il paese del visitatore è bloccato. La console mostra intoCHAT: this agent is not offered in the visitor's country (Share > Limits and access), so the chat is not shown. Il paese è in Blocked countries nella scheda Share. Toglilo e clicca Save. Il paese si ricava dall'indirizzo IP, quindi un visitatore che usa una VPN può risultare altrove. Vedi Limiti e accesso.
  • 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.
  • 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 e i membri del tuo team potete chattare con l'agente, nel Playground.
  • "This chat isn't available in your region." Il paese del visitatore è in Blocked countries nella scheda Share. Toglilo e clicca Save.
  • "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.

I visitatori vedono un messaggio di limite

  • "Too many messages. Please try again later." Questo visitatore ha raggiunto Limit messages per visitor nella scheda Share. Può scrivere di nuovo quando la sua ora è finita, contata dal suo primo messaggio. Le persone sulla stessa rete condividono un unico limite. Alza il numero o spegni il limite.
  • "Too many messages right now. Please try again in a moment." Sono stati raggiunti i limiti orari di intoCHAT, validi per ogni agente, per questo agente o per l'indirizzo IP del visitatore. Aspetta un momento e riprova.
  • "This chat has reached its limit for now. Please try again later." L'agente ha raggiunto il suo Monthly message cap for this agent. Il riquadro mostra il conteggio e la data in cui riparte. Alza il tetto o spegnilo; l'agente risponde di nuovo dal messaggio successivo.
  • "This chat isn't available in your region." Il paese del visitatore è in Blocked countries.
  • "Message limit reached": i messaggi mensili del tuo piano sono esauriti per tutti i tuoi agenti. Vedi Piani e limiti.
  • "The Playground couldn't reply" con una nota sul tetto mensile: i messaggi del Playground contano sul tetto dell'agente. Alzalo o spegnilo.

Vedi Limiti e accesso.

I testi del widget sono nella lingua sbagliata

  • Pulsanti e avvisi sono nella lingua sbagliata. Seguono l'impostazione Widget language nella scheda Appearance. Con Automatic, la bolla della chat usa prima l'attributo lang del tag <html> della tua pagina, per esempio <html lang="it">, poi le lingue del browser del visitatore. Molti strumenti per creare siti impostano questo attributo da soli; controlla che corrisponda alla pagina. Per usare una sola lingua ovunque, sceglila in Widget language e clicca su Save changes.
  • Una pagina in un'altra lingua mostra l'inglese. Il widget parla inglese, tedesco, francese, italiano e spagnolo. Con qualsiasi altra lingua della pagina passa alle lingue del browser del visitatore, poi all'inglese.
  • L'iframe incorporato o il link diretto ignorano la lingua della pagina. Non hanno una pagina ospite, quindi con Automatic seguono il browser del visitatore.
  • Il tuo messaggio di benvenuto o altri testi restano in una sola lingua. I testi che scrivi tu compaiono come li hai scritti. Vengono tradotti solo i testi predefiniti.
  • L'agente risponde in un'altra lingua. Le risposte seguono Reply language nella scheda Setup, non questa impostazione. Di default è la lingua in cui scrive il visitatore. Per usare una sola lingua in ogni risposta, sceglila in Reply in, attiva Always use this language e clicca Save changes. Vedi Istruzioni.

Vedi Aspetto.

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.

L'addestramento non finisce

  • Hai chiuso la pagina durante l'addestramento. L'addestramento continua sui server di intoCHAT. Apri la scheda Knowledge per vederne l'avanzamento.
  • Le fonti restano in attesa di addestramento. Apri la scheda Knowledge: un addestramento interrotto riprende quando lo fai. Se la barra indica ancora "… sources waiting to be trained", clicca su Train agent. Le fonti completate restano addestrate.
  • Una fonte mostra Failed. Passa il mouse sul badge per vedere il motivo. Clicca su Retry failed, oppure usa Re-index saved text sulla fonte.
  • Manca un file o una pagina che hai aggiunto. Era ancora in lettura quando hai lasciato la pagina. Aggiungilo di nuovo e aspetta che risulti aggiunto.

Vedi Gestire le fonti.

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. Pagine web e pagine Notion vengono rilette da sole solo se l'Auto-resync è attivo; file, testi e Q&A mai.
  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.
  • Con il passaggio via email attivo, a un visitatore che chiede di una persona viene proposto il passaggio invece del modulo, a meno che non scatti una regola.

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.

Il passaggio via email non funziona

  • L'agente non lo propone mai. Controlla che Offer hand-off by email sia attivo nella scheda Setup e di aver fatto clic su Save changes. L'agente lo propone solo quando il visitatore chiede di una persona o vuole un seguito che l'agente non può dare. Le chat temporanee non si possono passare al team. Se la live chat è attiva e qualcuno ha aperta la casella Live chat, l'agente chiede invece al tuo team di intervenire, e propone il passaggio via email solo se il visitatore preferisce essere ricontattato via email.
  • L'agente dice che non è riuscito a passare la conversazione. L'agente ha già inviato 20 passaggi nell'ultima ora, oppure l'email non è partita. Riprova più tardi.
  • L'agente dice che il team ha già la conversazione. Questa conversazione è stata passata meno di 10 minuti fa.
  • Non arriva nessuna email. Controlla i destinatari in Email when a new lead arrives nella scheda Leads e la cartella dello spam. Le email inviate dal Playground iniziano con [Test].

Vedi Passaggio via email.

La live chat non viene proposta

  • L'agente propone il passaggio via email, o nessuna persona. Controlla che Offer live chat when someone from the team is online sia attivo in Live chat nella scheda Setup. La live chat viene proposta solo mentre qualcuno del tuo team è online: la casella Live chat aperta in una scheda, negli ultimi 2 minuti, da qualcuno con il ruolo Editor o superiore. Una scheda in background smette di contare dopo circa 17 minuti.
  • Nel Playground non succede nulla. Il Playground non mostra la live chat. Prova dal tuo sito o dal link diretto dell'agente.
  • In una chat temporanea non succede nulla. Le chat temporanee non richiedono mai la live chat.
  • Il visitatore non vede le mie risposte. Se hai preso in carico una chat in cui il visitatore non aveva chiesto una persona, la sua finestra di chat mostra le tue risposte solo dopo il suo messaggio successivo o un ricaricamento.

Vedi Live chat.

Un webhook non arriva

Fai clic su Recent deliveries sotto il webhook nella scheda Leads. L'errore di un invio fallito di solito indica la causa.

  • HTTP 301: redirects aren't followed, o un altro stato 3xx: inserisci l'indirizzo finale a cui porta il reindirizzamento.
  • No response within 10 seconds.: rispondi prima con uno stato 2xx e fai il lavoro lento dopo.
  • The server's TLS certificate isn't valid.: correggi o rinnova il certificato del tuo server.
  • The webhook is turned off. Turn it on to deliver events.: attiva il webhook, poi fai clic su Resend.
  • L'indirizzo viene rifiutato al salvataggio: usa un indirizzo pubblico che inizi con https://. Gli indirizzi di reti private o interne non sono ammessi.
  • La verifica della firma fallisce: calcolala sul corpo grezzo prima di interpretare il JSON, includi il valore di X-IntoChat-Timestamp e usa il segreto più recente se hai fatto clic su New secret. Se rifiuti i timestamp vecchi, controlla l'orologio del tuo server.
  • Non arriva proprio nulla: controlla che il webhook sia Active e che l'evento sia selezionato in Events to send. Un contatto che torna non genera un nuovo lead.created.

Vedi Webhook.

Hai perso l'app di autenticazione

  • Hai un codice di recupero. Nel passaggio del codice della pagina di accesso, fai clic su Usa un codice di recupero e inseriscine uno. Poi disattiva e riattiva l'autenticazione a due fattori in Settings, Account per configurare il nuovo telefono.
  • Non ti resta nessun codice di recupero. Scrivi a support@intochat.ai dall'indirizzo email del tuo account. Dopo aver verificato che sei proprio tu, l'assistenza può disattivare per te l'autenticazione a due fattori.
  • I codici vengono sempre rifiutati. Imposta l'ora del telefono in modo che si aggiorni automaticamente: i codici dipendono dall'orologio. Inoltre ogni codice funziona una sola volta.

Vedi Autenticazione a due fattori.

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

Visualizza come Markdown