Integrazione HubSpot Chat: configurazione e aiuto

Usa questa guida per collegare il tuo negozio a HubSpot. Ti servono un account del servizio esistente e il valore del campo ID portale. Configura le conversazioni e il widget visibile nell'account del servizio.

L'azione "Configure" del modulo apre Configurazione HubSpot Chat. Il controller di configurazione mostra anche un avviso di configurazione richiesta e un banner di integrità. Usa le pagine Configurazione, "Integrity", Licenza, Assistenza e Aggiorna del modulo per le rispettive attività di manutenzione.

Trova il valore di collegamento

Copia il tuo ID numerico del portale HubSpot, chiamato anche Hub ID, dai dettagli dell'account o dal codice di installazione. Il pannello del modulo indica "Settings" > "Account Defaults" > "Account Info". Incolla solo l'identificatore, non un URL completo o uno script. La navigazione nell'account del fornitore è ripresa dalle istruzioni del modulo e può differire nel tuo account.

Il valore predefinito è vuoto. Per gli identificatori nuovi o modificati, il modulo richiede da 1 a 20 cifre. Un identificatore rifiutato mantiene la configurazione salvata in precedenza. Correggi il valore e salva di nuovo.

Imposta questi campi in Configurazione HubSpot Chat, poi fai clic su Salva.

Gruppi di pagine

Il targeting usa i nomi dei controller. Un controller di checkout personalizzato esterno all'elenco non è incluso da Solo pagine di checkout. Non c'è un campo per regole URL personalizzate. Mostra su mobile usa il rilevamento mobile di PrestaShop anziché la sola larghezza del browser.

Campi cliente

Prima di caricare lo script, il template accoda _hsq.push(['identify', {email: 'customer@example.com'}]) per un cliente connesso con passaggio dati attivo. Invia solo l’indirizzo e-mail; i nomi dei clienti non vengono inviati. Il loader usa hs-script-loader e non inserisce un secondo elemento con questo ID.

Il modulo non trasmette campi di identità cliente PrestaShop per gli ospiti. Il servizio può comunque raccogliere informazioni tramite il proprio widget. Il modulo non sincronizza la cronologia degli ordini o il contenuto del carrello.

Esempio di configurazione

Per le pagine di checkout su desktop, scegli Solo pagine di checkout, imposta Mostra su mobile su No e "Fallback Delay (seconds)" su 2. Il loader parte alla prima interazione o dopo due secondi senza interazione.

Il modulo registra displayBeforeBodyClosingTag. Controlla prima l'interruttore di attivazione, il valore di collegamento e le regole di dispositivo e pagina. Poi inserisce un loader differito verso la fine della pagina.

Scorri, fai clic, tocca la pagina o premi un tasto per attivare il loader. Senza interazione, attendi il ritardo di ripiego configurato. Il loader condiviso elimina il ritardo interno del template, quindi le due attese non si sommano. Con il valore iniziale 0, attendi 10 secondi prima di considerare una pagina senza interazioni come un errore di caricamento.

Negli strumenti di sviluppo del browser, cerca una richiesta corrispondente a:

//js.hs-scripts.com/{Portal ID}.js

Apri il widget e invia un messaggio di prova. Verifica che arrivi alla casella del servizio. Prova un account connesso se hai attivato Trasmetti dati cliente e verifica quali campi di identità riceve il servizio. Infine, prova le pagine e i dispositivi mobili esclusi.

Pubblica e configura il tuo chatflow in HubSpot. Gestisci aspetto, instradamento della casella, riunioni e comportamento CRM in HubSpot.

• Se non viene inserito alcun loader, controlla Attiva HubSpot Chat, ID portale, Mostra nelle pagine e Mostra su mobile.
• Se la pagina resta inattiva, attendi il caricamento di ripiego o interagisci con essa. "Fallback Delay (seconds)" a 0 non significa caricamento immediato.
• Se il salvataggio non riesce, mantieni l'identificatore compilato, controlla il formato, ricarica la pagina di configurazione e riprova. Non usare credenziali segnaposto per una prova reale.
• Se la richiesta esterna non riesce, controlla gli errori della console, il blocco degli script, la Content Security Policy e gli strumenti di consenso del negozio.
• Se lo script si carica ma manca il pulsante di apertura, controlla la pubblicazione del widget, la disponibilità dell'account e le regole di visualizzazione nel servizio.
• Se manca un campo cliente, accedi e verifica che Trasmetti dati cliente sia su Sì. Confronta con i campi esatti elencati sopra.
• Se un'altra integrazione inserisce lo stesso script del servizio, cerca codice di installazione duplicato o in conflitto nella pagina generata.

Verifica un tema personalizzato

Il tema deve eseguire l'hook di chiusura del body. Uno sviluppatore può ripristinare questa chiamata prima di </body> se manca nel tema:

{hook h='displayBeforeBodyClosingTag'}

Per modificare il template nel tema, copia:

modules/mprhubspotchat/views/templates/hook/displayBeforeBodyClosingTag.tpl

in:

themes/your-theme/modules/mprhubspotchat/views/templates/hook/displayBeforeBodyClosingTag.tpl

Mantieni le variabili Smarty del modulo e l'escaping dell'identificatore. Il wrapper di interazione condiviso continua ad applicarsi a questo template dell'hook.

Il form usa il prefisso MPRHSCHAT_ per i nomi dei campi inviati. L'archiviazione attuale usa il modulo mprhubspotchat nella tabella condivisa mpr_config, con chiavi brevi:

ENABLED
PORTAL_ID
SHOW_MOBILE
PAGES
DELAY
PASS_USER_DATA

La tabella usa il prefisso delle tabelle del tuo negozio, quindi ps_mpr_config è solo un nome di esempio. Usa il modulo di configurazione per le modifiche ordinarie. Non considerare i nomi dei campi come le chiavi attuali del database.

Imposta Attiva HubSpot Chat su No e salva mantenendo l'identificatore per sospendere l'output del modulo. Puoi anche disattivare il modulo in "Module Manager".

Per rimuoverlo, usa "Uninstall" in "Module Manager" e conferma. La disinstallazione elimina la configurazione del modulo e le voci del menu amministrativo. Non chiude l'account del servizio esterno e non rimuove codice inserito da altri moduli o dal tema.