## Il widget non appare nel sito - Controlla il codice sorgente della pagina nel browser (clic destro → «Visualizza sorgente pagina»), non solo l'editor del tuo CMS: alcune piattaforme mettono in cache i template e impiegano tempo a propagare la modifica, o richiedono di pubblicare esplicitamente. - Prova in una finestra in incognito senza estensioni: alcuni blocchi pubblicitari o di privacy bloccano gli script di chat di terze parti. - Controlla che lo snippet non sia stato incollato due volte (per esempio, nel tema e in un plugin di codice contemporaneamente) né in conflitto con un altro widget di chat di un altro fornitore. ## «Manca l'identificatore del widget» Appare quando l'attributo `data-widget` non arriva con un valore al browser — tipicamente perché si è tagliato copiando e incollando a mano, o perché un template con variabili non ha sostituito il valore. Il widget mostra questo avviso invece di fallire in silenzio. Soluzione: torna a **Canali → Widget Web**, copia di nuovo lo snippet con il pulsante «Copia» e sostituisci il blocco completo, senza modificarlo a mano. ## Il widget appare ma non si connette o non risponde - **Dominio non consentito:** se in **Impostazioni → Personalizzazione widget → Domini consentiti** c'è almeno un dominio registrato, il widget si connette solo da quei domini e dai loro sottodomini (vedi capitolo 4). Controlla che il dominio che serve la pagina con lo snippet sia nell'elenco (ricorda: `www.tuaagenzia.it` non copre `tuaagenzia.it» da solo; il dominio radice sì copre il `www`). Con l'elenco vuoto, questa causa è esclusa. - **`data-api` senza `/api/v1`:** se la tua installazione usa un backend proprio e hai aggiunto manualmente l'attributo `data-api`, l'URL deve includere il suffisso `/api/v1` (per esempio `https://api.tuodominio.it/api/v1`). Se manca, il widget chiama percorsi che non esistono e non riesce a connettersi. Nel caso normale (backend condiviso della piattaforma) non devi usare questo attributo. ## Stato «Offline, nuovo tentativo…» Il widget ha rilevato che non riesce a parlare con il server (un'interruzione puntuale di rete o del backend). Mostra un avviso con il pulsante «Riprova» e riprova anche automaticamente. La conversazione non si perde: riconnettendosi continua da dove era rimasta. Se l'avviso persiste per diversi minuti, contatta i dati di contatto del tuo fornitore.