Il widget non viene visualizzato

Se il widget di chat Conviro non compare sul tuo sito web, segui questa checklist passo dopo passo.

1. Verifica l’Embed Code

• Vai su Dashboard -> Assistants -> Il tuo bot -> Embed Code.
• Copia lo snippet più recente e assicurati che sia inserito correttamente nel tuo HTML.
• Il tag script deve essere inserito prima del tag di chiusura \</body\> (non nel \<head\>).
• Verifica che non ci siano errori di battitura o caratteri mancanti.

2. Controlla la Public Key

• Nell’embed code, verifica che il valore publicKey corrisponda alla chiave mostrata nel Dashboard.
• Le public key iniziano con pk_.
• Se hai rigenerato la chiave, aggiorna l’embed code sul tuo sito web.

3. Verifica l’elenco dei domini consentiti

• Vai su Dashboard -> Assistants -> Il tuo bot -> Channels.
• Assicurati che il dominio del tuo sito web sia nell’elenco Allowed Domains.
• Includi tutte le varianti: example.com, www.example.com e localhost per lo sviluppo.
• Non includere il protocollo (https://) – solo il nome del dominio.

4. Conferma che il bot sia attivo

• Vai su Dashboard -> Assistants.
• Lo stato del tuo bot deve essere Active (indicatore verde).
• Se è in pausa o inattivo, fai clic per attivarlo.

5. Controlla gli errori JavaScript

• Apri il tuo sito web in un browser.
• Premi F12 (o fai clic con il tasto destro -> Inspect) per aprire i Developer Tools.
• Vai alla scheda Console.
• Cerca errori relativi a Conviro o al widget:
• Widget init failed – problema con la public key o il dominio
• 403 Forbidden – il dominio non è nell’elenco dei domini consentiti
• 404 Not Found – l’URL dello script del widget non è corretto
• net::ERR_BLOCKED_BY_CLIENT – un ad blocker sta bloccando lo script

6. Disattiva gli ad blocker

Gli ad blocker (uBlock Origin, AdBlock Plus, Brave Shields) possono bloccare lo script del widget.

• Disattiva temporaneamente l’ad blocker e ricarica la pagina.
• Se il widget compare, aggiungi il tuo dominio alla whitelist nelle impostazioni dell’ad blocker.

7. Controlla la cache

• Se usi un plugin di cache (WP Super Cache, Cloudflare, ecc.), svuota la cache dopo aver aggiunto l’embed code.
• Prova a caricare la pagina in una finestra del browser in incognito/privata per aggirare la cache.

8. Controlla gli script in conflitto

• Altri widget di chat o librerie JavaScript possono entrare in conflitto con Conviro.
• Controlla la Console per individuare errori provenienti da altri script.
• Prova a rimuovere temporaneamente gli altri widget di chat per isolare il problema.

9. Content Security Policy (CSP)

Se il tuo sito ha una Content Security Policy restrittiva, potrebbe essere necessario consentire:

• script-src: cdn.conviro.io
• connect-src: api.conviro.io
• frame-src: cdn.conviro.io

10. Non funziona ancora?

Se nessuna delle indicazioni precedenti risolve il problema:

• Fai uno screenshot degli errori nella Console.
• Annota l’URL del tuo sito web, il browser e il sistema operativo.
• Contatta il supporto all’indirizzo [email protected] fornendo questi dettagli.