bvoce su un sito fatto a mano
Aggiornato il 17 ottobre 2026
Risposta in breve. Su un sito scritto a mano basta una riga prima di chiudere il body: lo script di bvoce con la tua chiave. Pesa meno di 5 KB, non usa cookie e la chat si carica solo quando qualcuno la tocca. Se il sito ha una Content-Security-Policy, aggiungi tre voci.
Cosa serve
- La riga con la tua chiave, dalla pagina Installa del pannello.
- L'accesso al file che si ripete su ogni pagina (layout, template, piè di pagina).
- Se hai una CSP, l'accesso alle intestazioni del server.
Come mettere bvoce su un sito fatto a mano
Copia dalla pagina Installa del pannello bvoce la riga con la tua chiave.
Apri il file HTML che si ripete su ogni pagina (il piè di pagina, il layout, il template) e incolla la riga subito prima di </body>.
La riga da incollare <script src="https://bvoce.blagoweb.com/w.js" data-chiave="bvk_ESEMPIO_la_tua_chiave" async></script>Se in basso hai una barra sempre visibile, aggiungi la sua altezza in pixel con data-bvoce-alto: il bottone resta sopra.
La riga con la barra fissa <script src="https://bvoce.blagoweb.com/w.js" data-chiave="bvk_ESEMPIO_la_tua_chiave" data-bvoce-alto="80" async></script>Carica il file sul tuo hosting e svuota la cache del server, se ce l'hai.
Nel pannello bvoce, alla voce Installa, Su quali siti, controlla che l'indirizzo del tuo sito sia nell'elenco. Poi aprilo: il bottone è in basso.
La chiave che vedi negli esempi (bvk_ESEMPIO_la_tua_chiave) è finta: la tua sta nella pagina Installa del pannello bvoce, dopo l'accesso.
Se il sito ha una Content-Security-Policy
Aggiungi l'indirizzo di bvoce a tre direttive: lo script, la chat e la richiesta dell'aspetto.
script-src https://bvoce.blagoweb.com
frame-src https://bvoce.blagoweb.com
connect-src https://bvoce.blagoweb.comContent-Security-Policy: script-src https://bvoce.blagoweb.com; frame-src https://bvoce.blagoweb.com; connect-src https://bvoce.blagoweb.com;Se qualcosa non va
- Il bottone non compare. Apri la console del browser: se vedi un errore di Content-Security-Policy, aggiungi le tre voci qui sotto.
- Compare ma non risponde. Il dominio da cui lo apri deve essere nell'elenco «Su quali siti» del pannello bvoce, con e senza www.
- Su un'applicazione a pagina singola il blocco incorporato non compare. Il loader cerca il blocco una volta, quando parte: mettilo in una pagina già caricata.
Cosa vede bvoce del tuo sito
Dal tuo sito non parte nessun dato verso bvoce: nella pagina c'è solo una riga con l'indirizzo del loader e la tua chiave pubblica. Quello che scrivono i visitatori nella chat va a bvoce, come spiegato nella pagina sulla sicurezza.
Domande frequenti
Posso nascondere il bottone e aprire la chat da un mio pulsante?
Sì: usa la riga senza bottone e dai al pulsante l'attributo data-bvoce-apri. Gli esempi sono nella guida per sviluppatori.
Posso mettere la chat dentro la pagina invece del bottone?
Sì, con un blocco div con l'attributo data-bvoce="incorporato" e la riga senza bottone.
Va in head o in body?
In fondo al body, subito prima di </body>.
Posso scaricare il file di bvoce e servirlo dal mio server?
No: il loader si aggiorna da solo dal nostro server, e una copia ferma smetterebbe di funzionare.