- Knowledge base
- Servizio
- Chatflows
- Il widget della chat non appare nelle pagine del sito web
Il widget della chat non appare nelle pagine del sito web
Ultimo aggiornamento: 9 marzo 2026
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
Quando si imposta una chat in tempo reale o un chatbot basato su regole, si potrebbe scoprire che il widget della chat non appare nelle pagine del sito web previste per i contatti previsti. Questo articolo spiega le cause comuni e fornisce i passaggi per la risoluzione dei problemi per aiutarvi a risolvere il problema.
Assicurarsi che il codice di tracciamento sia rata
Se si aggiunge un chatflow a un sito web ospitato esternamente da HubSpot, è necessario ratappare il codice di tracciamento di HubSpot sulle pagine del sito web. È possibile accedere al codice di tracciamento nelle impostazioni:
Nota bene: se il codice di tracciamento di HubSpot è già installato sul vostro sito web o se il vostro sito web è ospitato su HubSpot, non è necessario installare questo frammento di codice separatamente.
- Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.
- Nel menu della barra laterale sinistra, navigare su Tracciamento & Analisi dati > Codice di tracciamento.
- Per copiare il codice e aggiungerlo al sito web, fare clic su Copia. Oppure fate clic su Email to developer e inserite un indirizzo e-mail per inviare il codice allo sviluppatore web o alla risorsa IT.
Verificare la presenza di blocchi di script o di restrizioni al consenso dei cookie
Se il widget della chat continua a non apparire, verificare se un banner di consenso ai cookie, un blocco degli script o un altro JavaScript personalizzato o di terze parti impedisce il caricamento dello script di tracciamento di HubSpot. Alcune piattaforme di gestione del consenso bloccano gli script di Widget finché il visitatore non accetta i cookie, il che può impedire la visualizzazione del widget della chat.
Collaborate con il vostro sviluppatore per assicurarvi che gli script di HubSpot possano essere eseguiti quando necessario e verificate che nessuno strumento di terze parti o estensione del browser blocchi il caricamento degli script di HubSpot .
Attivare il chatflow
Per confermare che il Chatflow è attivato:
- Nel tuo account HubSpot, passa a Servizio clienti > Chatflow.
- Accanto al chatflow inattivo, nella colonna Stato , fare clic per attivare l'interruttore di stato .
Cancellare la cache del browser
Se il Chatflow non appare sul sito web dopo averlo attivato, provare a caricare il sito web in una finestra del browser in incognito. Se il chatflow appare in incognito, cancellare la cache e i cookie del browser per visualizzare il chatflow in una finestra del browser non in incognito.
Recensione delle regole di targeting
Quando si costruisce un chatflow, nelle impostazioni di targeting si può specificare in quali pagine deve apparire il widget della chat. È anche possibile definire il target in base alle informazioni note sul visitatore. Recensione delle regole di targeting nella schedaTarget di Chatflow per verificare che i criteri corrispondano a ciò che ci si aspetta di vedere sulle pagine del sito web.
Specificare il dominio e il sottodominio corretti
Innanzitutto, verificare che la pagina in cui ci si aspetta di vedere il Chatflow sia inclusa nelle regole di targeting. Se si desidera che il Chatflow appaia nelle pagine di un dominio specifico, assicurarsi di inserire il dominio corretto. Ad esempio, se la regola di targeting è Sito web | contiene | www.coffeeshop.com, il chatflow apparirà su qualsiasi pagina delsito web , inclusi www.coffeeshop.com, www.coffeshop.com/contact e www.coffeeshop.com/pricing.
Tuttavia, il chatflow non apparirà su blog.coffeeshop.com , a meno che non si aggiunga il sottodominio del blog alle regole di targeting.
In alternativa, è possibile specificare il dominio principale nelle regole di targeting. In questo esempio, se si utilizza la regola di targeting Sito web | contiene | coffeeshop.com, il chatflow apparirà su qualsiasi pagina del sito web con questo dominio principale.
Controllare le regole di esclusione
Se il Chatflow non appare come previsto, assicurarsi che l'URL della pagina non sia incluso nelle regole di esclusione. Passare al chatflow, quindi nella schedaDestinazione , recensire e rimuovere le regole di esclusione necessarie.
Verificare le informazioni e il comportamento dei visitatori
Se state indirizzando i chatflow in base alle informazioni e al comportamento dei visitatori, assicuratevi che il contatto soddisfi i criteri di destinazione. Ad esempio, se il chatflow viene visualizzato solo da un contatto che ha fatto clic su una CTA specifica sul sito web, passare al record del contatto e filtrare l'attività della CTA del contatto. Se il contatto non ha fatto clic sulla CTA selezionata, non vedrà il chatflow.
Se hanno fatto clic sulla CTA, recensite i passaggi aggiuntivi per la risoluzione dei problemi in questa guida o scoprite come i cookie di tracciamento possono influire sulla visualizzazione del chatflow.
Applicazioni a pagina singola
Se il vostro sito web è un'applicazione a pagina singola, o SPA, le regole di targeting potrebbero non funzionare come previsto a causa del modo in cui il contenuto del sito web di una SPA si aggiorna dinamicamente quando si passa ad altre pagine, invece di ricaricarsi. HubSpot non è in grado di rilevare il nuovo URL della pagina, il che può causare la comparsa del chatflow sbagliato in una pagina o impedirne la comparsa. Se si utilizza una chat in tempo reale o un bot nella propria applicazione a pagina singola, si consiglia di collaborare con uno sviluppatore per utilizzare il Chat in tempo reale SDK per indirizzare le pagine. Utilizzare il metodo .widget-refresh per specificare chatflow diversi su pagine diverse. Per saperne di più, consultate i documenti per sviluppatori di HubSpot Docs.
Controllare le impostazioni di disponibilità della chat
Se il chatflow non appare ancora nelle pagine, controllate le impostazioni di disponibilità del canale di chat. È possibile controllare quando nascondere il widget della chat, anche quando nessun membro del team è online o quando non è in orario di lavoro, modificando le impostazioni di disponibilità:
- Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.
- Nel menu della barra laterale sinistra, selezionare Posta in arrivo & Help desk:
- Per modificare un canale di chat collegato alla Posta in arrivo delle conversazioni, selezionare Posta in arrivo.
- Per modificare un canale di chat entrato in contatto con l'Help desk, selezionare Help desk. Quindi, in Sorgenti e instradamento dei ticket, fare clic su Canali.
- Passare il mouse sul canale di chat e fare clic su Modifica.
- Passare alla schedaDisponibilità . Selezionare un'opzione:
-
- In base alla disponibilità dell'utente: i visitatori possono chattare con il team se almeno un membro del team assegnato nelle regole di assegnazione è disponibile.
- In base agli orari di funzionamento della chat: impostate quando il vostro team deve essere disponibile per la chat e fate sapere ai visitatori quando possono aspettarsi una risposta.
- Utilizzate i menu a discesa per impostare gli orari di funzionamento del vostro team. Fare clic su + Aggiungi ore per aggiungere altri intervalli di giorni e orari.
- La chat è disponibile 24 ore su 24, 7 giorni su 7: selezionate questa casella di controllo se il vostro team è sempre disponibile a chattare.
- Nella sezione Comportamento di disponibilità , configurate l'esperienza di chat in base alla disponibilità del vostro team e fate sapere ai visitatori quando possono aspettarsi una risposta. Selezionare un'opzione:
-
- Per impostare l'esperienza del visitatore quando il team è disponibile, fare clic sulla scheda Disponibile . Fare clic sul menu a discesa Mostra il tempo tipico di risposta per indicare ai visitatori quando possono aspettarsi una risposta.
- Per impostare l'esperienza dei visitatori quando il team è assente durante l'orario di lavoro, fare clic sulla scheda Fuori sede . Fare clic sul menu a discesa Mostra un messaggio di allontanamento e selezionare un comportamento del widget in modalità di allontanamento.
Abbonamento richiesto È necessario un abbonamento Service Hub Enterprise per impostare l'esperienza dei visitatori quando il team è al massimo della capacità.
- Per impostare l'esperienza del visitatore quando il team è al massimo della capacità, fare clic sul menu a discesa Se tutti i membri del team sono al massimo della capacità e scegliere se mostrare un messaggio di attesa, nascondere l'avvio della chat o non fare nulla. Ulteriori informazioni sulla configurazione dei limiti di capacità della chat per gli utenti.
-
- Per impostare l'esperienza del visitatore al di fuori dell'orario di lavoro del team, fare clic sulla scheda Fuori orario e fare clic sul menu a discesa Imposta comportamento offline e scegliere se mostrare l'orario di rientro, mostrare un messaggio di allontanamento o nascondere l'avvio della chat quando un visitatore arriva sul sito al di fuori dell'orario di lavoro.
- Fai clic su Salva.
Se si utilizza un chatflow che include un bot, il chatflow potrebbe ancora apparire se non si sono personalizzate le preferenze di disponibilità del bot. Scoprite come modificare la visualizzazione del chatflow in base alla disponibilità del vostro team.
Verifica della priorità del chatflow
Quando avete più di un Chatflow che appare su una pagina, potete decidere quale HubSpot deve dare la priorità quando un visitatore arriva sul vostro sito. Se il chatflow previsto non appare, controllare la priorità del chatflow rispetto agli altri chatflow della pagina.
Viene visualizzato un chatflow inaspettato
Se un visitatore ha iniziato una discussione su una delle vostre pagine, poi converte in un'altra pagina in cui dovrebbe apparire un Chatflow diverso, la conversazione continuerà nella discussione originale . Pertanto, l'altro Chatflow non apparirà. Ad esempio:
- Il Chatflow A dovrebbe apparire su www.coffeeshop.com.
- Il Chatflow B dovrebbe apparire su blog.coffeeshop.com.
- Un visitatore ha iniziato una chatflow con Chatflow A, poi ha navigato verso blog.coffeeshop.com.
- Il Chatflow B non comparirà e il visitatore potrà continuare la discussione iniziata con il Chatflow A.
Cookie di tracciamento
Se dopo aver seguito i passaggi sopra descritti il widget della chat non appare ancora per i contatti che soddisfano i criteri di destinazione, molto probabilmente ciò è dovuto ai cookie di tracciamento. Affinché il widget della chat venga visualizzato da un visitatore, è necessario che un cookie di tracciamento sia associato al record del contatto del visitatore nel database dei contatti. Se il record del contatto non ha un cookie di tracciamento, il widget della chat non apparirà per il visitatore associato al record del contatto.
Come fa un visitatore a ricevere un cookie di tracciamento?
I visitatori vengono tracciati in modo anonimo con un cookie di tracciamento prima di diventare contatti. HubSpot può quindi associare l'attività del sito web sul cookie di tracciamento al record del contatto in due modi:
- Il visitatore compila un form di HubSpot.
- Il visitatore fa clic su un'e-mail di marketing HubSpot for Marketers che lo conduce a una pagina HubSpot o a una pagina non HubSpot con il codice di tracciamento HubSpot rata.
Inoltre, è possibile utilizzare il codice di tracciamento API per monitorare i visitatori del sito.
Finché il visitatore non esegue una delle conversazioni di cui sopra, HubSpot non sa chi sia il visitatore o di quali elenchi faccia parte il record del contatto del visitatore. Pertanto, se avete un contatto che non ha ancora convertito, non vedrà il vostro widget di chat anche se è un contatto del vostro database o un membro dell'elenco a cui vi rivolgete.
Nota bene: anche se il visitatore ha eseguito una delle due azioni sopra descritte per ottenere un cookie del browser, se nel frattempo ha cancellato i cookie del browser o ha visitato il vostro sito con un browser diverso, in una finestra in incognito o sul proprio dispositivo mobile, il suo cookie del browser non potrà essere rilevato e il widget della chat non apparirà per lui.
Perché ho dei contatti senza cookie di tracciamento?
Ecco alcuni modi comuni in cui i contatti possono essere presenti nel database dei contatti senza che siano stati convertiti su un form o abbiano cliccato su un link di marketing via e-mail:
- Il contatto è stato importato.
- Il contatto è stato aggiunto manualmente.
- Il contatto è stato creato da un' e-mail di vendita registrata.
Una volta che un contatto del vostro database viene tracciato con un cookie di tracciamento, HubSpot lo considera un contatto noto. Se soddisfano i criteri del vostro pubblico, il widget della chat apparirà per loro quando visiteranno il vostro sito.
Nota bene: in alcuni casi, alcuni pop-up blocker possono impedire il caricamento del widget della chat. Se si disattivano i blocchi pop-up installati nel browser e il widget della chat appare, è probabile che l'estensione impedisca il caricamento del widget della chat come previsto.