Installare il widget su un sito web

Lo script, il token e il dominio formano un unico controllo

Il codice fornito da Wavize carica il widget con un token pubblico firmato. "Pubblico" significa che può essere visibile nel browser; non significa che possa essere riutilizzato su qualsiasi sito. Il token è collegato al dominio registrato.

Installa il blocco senza modificare il suo ID, poi testa la pagina effettivamente servita al visitatore. Un editor può mostrare il codice senza pubblicarlo, e una cache può continuare a fornire una versione vecchia.

Non condividere dati errati
Il token del widget può essere ispezionato dal lato browser. Al contrario, una chiave WooCommerce, PrestaShop, Shopify, Wix, Klaviyo o Mailchimp è segreta e non deve mai essere inserita nell’HTML.

Prepara il dominio corretto

Il dominio inserito durante l’onboarding deve corrispondere all’indirizzo pubblico su cui stai testando.

1. HTTPS e variante www

   Verifica il reindirizzamento finale nel tuo browser. Se il sito arriva su www.esempio.com, non testare solo esempio.com senza confermare che il dominio autorizzato copre la variante finale.

2. Un token per dominio autorizzato

   Non copiare il codice da un ambiente a un altro dominio di produzione o preproduzione. Genera o seleziona il token corrispondente in Assistant > Installazione.

3. Abbonamento disponibile

   Il caricamento pubblico dipende anche dall'accesso alla formula. Uno script corretto può rimanere invisibile se l’abbonamento non è più attivo.

Posizionare il codice secondo la piattaforma

Il metodo dipende dal CMS, ma il risultato atteso è sempre lo stesso: lo script appare una sola volta in tutte le pagine desiderate.

1. Sito HTML o gestore tag

   Incolla il blocco prima della chiusura del body o in un posizionamento globale eseguito dopo il consenso richiesto. Evita di caricarlo sia nel tema che nel gestore tag.

2. WordPress / WooCommerce

   Usa il modulo scaricato durante l’onboarding, attivalo e incolla il token nella configurazione. Un’ottimizzazione JavaScript non deve ritardare o unire lo script rendendolo invalido.

3. PrestaShop

   Installa il modulo dal gestore, apri la configurazione e inserisci il token. Poi svuota la cache Smarty/PrestaShop e, se presente, quella del CDN.

4. Shopify e Wix

   Shopify App Store normalmente gestisce App Embed e connessione. Su Wix, usa il codice personalizzato globale solo se la tua offerta Wix permette questo tipo di inserimento e mettilo su tutte le pagine.

Pubblica e ispeziona nel browser

Testa in navigazione privata per separare problemi di cache, consenso o sessione amministratore.

1. Cerca lo script caricato

   Apri il sorgente o la scheda Rete e cerca Wavize. Se assente, il problema è prima della chiamata a Wavize: pubblicazione, tema, tag o cache.

2. Leggi console e rete

   Un errore CSP indica che la policy di sicurezza blocca un dominio script o connessione. Un 401 / 403 indica token, dominio o accesso; un blocco da estensione spesso sparisce disattivando l’ad blocker.

3. Controlla cookie e overlay

   Accetta la categoria di consenso prevista dalla tua policy. Se il pulsante esiste ma è nascosto, verifica posizione, z-index e sovrapposizione con carrello, navigazione o banner cookie.

Test minimo dopo pubblicazione

Fai questo test sia su computer sia su telefono reale.

• Apertura — Il pulsante appare, apre il widget e non distorce la pagina.
• Conversazione — Un messaggio del visitatore riceve risposta e appare nella inbox.
• Accoglienza proattiva — La campagna appare secondo il suo ritardo e limite, non a ogni ricaricamento.
• Pagina secondaria — Una seconda pagina conferma che l’installazione è globale.