**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

1. **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.

2. **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é.

3. **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.

4. **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:
1. Nel pannello Papo, in **Impostazioni → Caselle di posta**, fai clic su **Aggiungi casella** e seleziona **Sito**.
2. Dai un nome alla casella e inserisci l'URL del sito.
3. Copia lo script generato e incollalo nell'HTML di tutte le pagine dove deve apparire la chat, immediatamente prima della chiusura `</body>`.
4. 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.

## Leggi anche

- [Come incorporare la chat del sito di Papo in WordPress](/hc/papo/articles/come-incorporare-la-chat-di-papo-su-wordpress)
- [Come verificare se il tuo canale è connesso a Papo e cosa fare se si disconnette](/hc/papo/articles/verificare-canale-connesso-papo-cosa-fare-se-cade)

---

**[Inizia gratis e installa il widget in pochi minuti →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=widget-chat-non-appare-sito-diagnosticare-correggere&utm_content=it)**

Con Papo, offri supporto direttamente sul tuo sito e mantieni tutta l'assistenza centralizzata nello stesso pannello.