# Il widget non compare sul mio sito

> Una checklist per quando il widget manca, non è aggiornato o non risponde, nell'ordine in cui le cause sono più comuni.

Una checklist per quando il widget manca, non è aggiornato o non risponde, nell'ordine in cui le cause sono più comuni.

Procedi con questi controlli dall'alto: la maggior parte dei problemi si risolve con i primi tre.

## 1\. Il widget è pubblicato?

Apri la schermata Widget e guarda lo stato in alto. Se dice Bozza: non pubblicata, i visitatori non vedono ancora nulla: clicca su Pubblica. Vedi [Salva, pubblica e metti offline](https://konvuno.com/it/help/widget/publish).

## 2\. Il tuo dominio è autorizzato?

Nella scheda Installa, controlla **Domini consentiti**:

- Il tuo dominio è nell'elenco? Con un elenco vuoto il widget non si carica da nessuna parte.
- È scritto esattamente come l'indirizzo nella barra degli indirizzi del browser?
- Il tuo sito usa un sottodominio, come `shop.example.com`? Ha bisogno di una riga a sé: `example.com` copre solo `example.com` e `www.example.com`.

Vedi [Autorizza il tuo dominio](https://konvuno.com/it/help/widget/install#domains).

## 3\. Lo snippet è nella pagina?

Apri il tuo sito, fai clic con il tasto destro sulla pagina e scegli **Visualizza sorgente pagina**, poi cerca (Ctrl+F o ⌘F) `cdn.konvuno.com`. Se non lo trovi, lo snippet non è in questa pagina:

- Su WordPress, Wix, Squarespace e costruttori di siti simili, controlla di aver salvato **e pubblicato** la modifica.
- Se l'hai incollato in una sola pagina, spostalo in un punto che compare in ogni pagina: il footer o l'impostazione del codice personalizzato per tutto il sito.
- Se il tuo sito usa una cache o una CDN, svuotala.

Vedi [Copia lo snippet](https://konvuno.com/it/help/widget/install#snippet).

## 4\. Questa pagina è nascosta di proposito?

Nella scheda Comportamento, guarda **Nascondi su pagine specifiche**. Una riga come `/shop` nasconde anche ogni pagina sotto di essa, e un dominio da solo nasconde l'intero sito. Vedi [Nascondi il widget su alcune pagine](https://konvuno.com/it/help/widget/behavior#hidden-pages).

## 5\. Hai appena pubblicato?

Le modifiche arrivano sul tuo sito entro circa cinque minuti. Ricarica la pagina, oppure aprila in una finestra di navigazione privata per saltare la copia salvata dal browser.

## 6\. Il tuo sito blocca gli script esterni?

Alcuni siti, spesso quelli realizzati da uno sviluppatore o con un plugin di sicurezza, permettono solo script di un elenco approvato, chiamato Content Security Policy. Il widget viene allora bloccato, e la console per sviluppatori del browser (F12) mostra un messaggio che parla di «Content Security Policy». Manda questo testo a chi gestisce il tuo sito:

> Se il tuo sito applica una Content-Security-Policy, consenti le origini Konvuno: https://cdn.konvuno.com in script-src e frame-src, e https://api.konvuno.com in connect-src. Aggiungere https://api.konvuno.com a img-src è consigliato ma facoltativo — un logo bloccato viene incorporato automaticamente come immagine inline.

## Il widget compare, ma dice di non essere disponibile

Se la chat si apre ma dice Il nostro assistente non è al momento disponibile. Lascia la tua domanda e ti ricontatteremo., il widget è installato correttamente: è Konvuno ad aver messo in pausa le risposte. Succede quando:

- le conversazioni del tuo piano per questo periodo di fatturazione sono [esaurite](https://konvuno.com/it/help/settings/billing#limit): tornano all'inizio del periodo successivo, oppure subito se passi a un piano superiore; oppure
- c'è un problema con il tuo abbonamento, per esempio un [pagamento non riuscito](https://konvuno.com/it/help/settings/billing#failed-payment).

Controlla [il tuo piano e l'utilizzo](https://konvuno.com/it/help/settings/billing#usage) nella sezione **Impostazioni**. Il widget torna da solo quando la causa è risolta: non devi pubblicare di nuovo.

## Non hai ancora risolto?

Usa [Contatta l'assistenza](https://konvuno.com/it/help/more/support) nel menu di aiuto in cima alla dashboard. Dicci l'indirizzo del tuo sito e cosa hai già controllato di questo elenco: ci risparmia un giro di domande.

---

Canonical: https://konvuno.com/it/help/widget/troubleshooting
Index: https://konvuno.com/llms.txt
