Il widget di chat non appare sul sito: come diagnosticare e correggere

Apri in

Visualizza come Markdown

Apri in ChatGPT Apri in Claude

Vitor

Ultimo aggiornamento Oct 14, 2026

Se il widget di chat di Papo (https://papo.global/) non appare sul tuo sito, la diagnosi inizia verificando se lo snippet di codice è inserito correttamente prima del tag </body>, se ci sono conflitti con plugin di cache o ottimizzazione, e se la casella di posta del sito rimane attiva nel pannello di Papo. Questa guida raccoglie i passaggi per identificare e correggere rapidamente il problema.

Il widget di chat è il punto di contatto che trasforma i visitatori in conversazioni. Quando scompare, perdi opportunità di assistenza. La buona notizia è che la maggior parte dei problemi ha cause semplici e soluzioni rapide.

Causa Probabile	Verifica Rapida	Soluzione Proposta
Snippet assente o posizionato male	Ispeziona il codice sorgente della pagina (Ctrl+U) e cerca lo script del widget.	Reinserisci lo snippet esattamente prima della chiusura `</body>`, come generato nel pannello.
Conflitto con plugin di cache o ottimizzazione	Testa il sito in una finestra anonima/privata o disattiva temporaneamente i plugin di cache.	Escludi lo script del widget dalle regole di minificazione/cache o svuota la cache dopo aver inserito lo snippet.
Casella di posta del sito rimossa o senza agenti	Accedi a Impostazioni → Caselle di posta e verifica se la casella di tipo "Sito" è elencata e con agenti associati.	Ricrea la casella di posta e associa almeno un agente; copia il nuovo snippet e aggiorna il sito.
Script bloccato da estensioni del browser	Apri il sito in un altro browser o senza estensioni attive.	Guida i visitatori a disattivare i bloccatori di script per il dominio, o rivedi le configurazioni di sicurezza (CSP) del sito.
Conflitto con un altro widget o script	Controlla la console del browser (F12) per errori JavaScript.	Risolvi i conflitti regolando l'ordine di caricamento o isolando gli script.

Come diagnosticare l'assenza del widget

Conferma che lo snippet sia nel codice sorgente
Apri la pagina del sito, fai clic con il tasto destro e seleziona "Visualizza codice sorgente" (o usa Ctrl+U). Cerca lo script che inizia con qualcosa come <script src="... app.papo.global ...">. Se non appare, lo snippet non è stato aggiunto o è stato rimosso.
Testa in una finestra anonima/privata
Spesso il browser memorizza una versione in cache della pagina senza il widget. Aprire una finestra anonima ignora la cache locale e carica la versione più recente del sito. Se il widget appare in questa modalità, il problema è la cache e non lo script in sé.
Controlla la console del browser
Premi F12 per aprire gli strumenti per sviluppatori e vai alla scheda "Console". Errori in rosso possono indicare che lo script del widget è bloccato da politiche di sicurezza o in conflitto con altri script della pagina.
Verifica se la casella di posta è attiva nel pannello Papo
Vai su Impostazioni → Caselle di posta. Se la casella creata per il sito (tipo "Sito") non è elencata, potrebbe essere stata eliminata accidentalmente. Se è presente, verifica che almeno un agente sia associato — una casella senza agenti non carica correttamente il widget.

Come correggere i problemi più comuni

Reinstallare correttamente lo snippet

Se il codice è assente o posizionato in modo errato, ripeti il processo:

Nel pannello Papo, in Impostazioni → Caselle di posta, fai clic su Aggiungi casella e seleziona Sito.
Dai un nome alla casella e inserisci l'URL del sito.
Copia lo script generato e incollalo nell'HTML di tutte le pagine dove deve apparire la chat, immediatamente prima della chiusura </body>.
Associa almeno un agente alla casella e salva.

Sostituire il vecchio snippet con quello nuovo garantisce che nessun carattere sia stato perso durante modifiche manuali.

Gestire cache e plugin di ottimizzazione

Plugin di cache, minificazione JavaScript o lazy loading possono impedire l'esecuzione dello script del widget. Se usi una piattaforma come WordPress, svuota tutta la cache del sito (server e plugin) dopo aver aggiunto lo snippet. Se possibile, escludi lo script del widget dalle regole di minificazione o combinalo solo con script essenziali. Testare con tutti i plugin di ottimizzazione disattivati aiuta a isolare la causa.

Ricreare la casella di posta e riconnettere

Quando la casella originale è stata rimossa o la cronologia di configurazione è andata persa, il percorso più sicuro è crearne una nuova. Il processo è lo stesso dell'installazione iniziale: crea la casella di tipo Sito, copia il nuovo snippet e sostituiscilo nel codice del sito. Poi associa gli agenti e verifica che il widget si carichi in una finestra anonima. In questo caso, il vecchio snippet smette di funzionare automaticamente.

A chi è utile questa guida

Aziende che hanno appena installato il widget e non lo vedono apparire.
Operazioni che hanno cambiato il tema o effettuato aggiornamenti al sito e hanno notato la scomparsa della chat.
Team che hanno ereditato un sito con lo snippet già inserito e devono diagnosticare perché il widget non si carica.
Chi vuole evitare la perdita di lead a causa di un canale di assistenza invisibile.

Domande frequenti (FAQ)

Il widget non appare solo a me, ma i miei clienti lo vedono. Perché?

Probabilmente è la cache del tuo browser o un'estensione che blocca gli script sul tuo dispositivo. Prova in una finestra anonima o su un altro dispositivo. Se il widget appare, il problema è locale e non influisce sui visitatori.

Ho installato lo snippet, ma il widget non appare in pagine specifiche. Cosa fare?

Verifica se il codice è stato incollato nel template che alimenta tutte le pagine (ad esempio, il footer.php in WordPress) e non solo in una pagina isolata. Se ci sono regole condizionali di visualizzazione nel tema, potrebbe essere necessario modificarle per includere il dominio corretto.

Devo ricreare la casella di posta per correggere il widget?

Non sempre. Se la casella esiste ancora e ha agenti associati, spesso basta reinstallare lo snippet. Ricreare la casella è l'alternativa quando è stata eliminata o quando lo script originale è andato perso e non riesci a recuperarlo.

Il mio sito usa WordPress, c'è qualcosa di specifico che devo verificare?

Sì. Plugin di cache (come WP Rocket, W3 Total Cache) e strumenti di minificazione possono bloccare lo script del widget. Svuota la cache, disattiva temporaneamente questi plugin per testare e, se necessario, escludi lo script del widget dalle ottimizzazioni. Leggi anche la guida completa sull'installazione in WordPress.

Il widget appariva e all'improvviso è scomparso. Cosa può essere successo?

Modifiche al tema del sito, aggiornamenti di plugin o una migrazione del server possono rimuovere lo snippet. È anche possibile che la casella di posta del sito sia stata eliminata dal pannello Papo. Verifica entrambe le possibilità: codice sorgente e elenco delle caselle di posta.

Come testare se lo snippet funziona senza pubblicarlo sul sito ufficiale?

Puoi aggiungere lo script a una pagina di test in un ambiente di staging o in una pagina nascosta del sito stesso. Finché l'URL inserito nella casella di posta corrisponde al dominio in cui è inserito lo script, il widget si caricherà normalmente per permetterti di validarlo.