Salta ai contenuti

Costruire

Verifica e risoluzione dei problemi

  • 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.

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

Sezione intitolata “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.

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.