Integrazione LiveChat: configurazione e aiuto

Avvio rapido

  1. Carica e installa lo ZIP mprlivechatintegration in Moduli > "Module Manager".
  2. Fai clic su "Configure".
  3. Copia solo il valore ID licenza dallo script di installazione LiveChat.
  4. In Configurazione LiveChat, imposta ID licenza sul valore del tuo account e lascia Attiva LiveChat su Sì.
  5. Scegli Trasmetti dati cliente, lascia Mostra nelle pagine su Tutte le pagine e mantieni Fallback Delay (seconds) a 0.
  6. Fai clic su Salva. Apri una pagina consentita del negozio e scorri o fai clic, oppure attendi 10 secondi.
  7. Verifica che il widget LiveChat venga caricato. Invia una conversazione di prova e conferma che arrivi nel tuo account LiveChat.

Richiede PrestaShop 1.6 o successivo e PHP 7.1 o successivo.

Manuale di configurazione

Installazione e prima configurazione

Nelle versioni precedenti di PrestaShop, usa la pagina equivalente per l’installazione dei moduli. Apri questo modulo tramite "Configure" ogni volta che vuoi tornare alle impostazioni.

Configurazione LiveChat

Impostazione Valore predefinito Cosa fai
Attiva LiveChat Sì Disattiva per interrompere l’output dello script nel negozio mantenendo le impostazioni di connessione.
ID licenza Vuoto Inserisci 3-32 cifre da window.__lc.license. Non incollare lo script.
ID gruppo Vuoto Inserisci facoltativamente 1-32 cifre per impostare window.__lc.group. Lascia vuoto per l’instradamento predefinito dell’account.
Trasmetti dati cliente Sì Invia il nome completo e l’email del cliente connesso. Disattiva se non vuoi questa identificazione.
Mostra su mobile Sì Consenti il widget per i visitatori rilevati come mobili da PrestaShop. Disattiva per nasconderlo su quei dispositivi.
Fallback Delay (seconds) 0 Carica al primo scorrimento, clic, tocco o pressione di un tasto. Un valore positivo imposta l’attesa passiva massima in secondi. 0 usa un fallback di 10 secondi.
Mostra nelle pagine all Scegli Tutte le pagine, Solo pagine prodotto, Solo pagine di categoria o Solo pagine di checkout.

Mostra nelle pagine offre Tutte le pagine, Solo pagine prodotto, Solo pagine di categoria e Solo pagine di checkout. Il checkout corrisponde a cart, order, order-opc, orderopc e checkout. Mostra su mobile usa il rilevamento dei dispositivi di PrestaShop. Fallback Delay (seconds) è l’attesa passiva massima, non un ritardo aggiunto dopo l’interazione.

I valori di connessione modificati vengono convalidati prima di salvare le impostazioni. Le modifiche non valide mantengono la configurazione precedente. Il controllo del negozio richiede un valore non vuoto; non ripete la convalida del formato per i valori precedenti memorizzati.

Copia il numero assegnato a window.__lc.license nel codice di installazione del widget LiveChat. Un esempio limitato al checkout usa ID licenza 12345678, Mostra nelle pagine Solo pagine di checkout, Mostra su mobile No e Fallback Delay (seconds) 5. Una prima interazione avvia comunque il caricamento prima del fallback di cinque secondi. Per un team specifico, inserisci ID gruppo 2.

Comportamento nel negozio e verifica

Il tema deve richiamare displayBeforeBodyClosingTag. Il modulo visualizza l’output solo quando è abilitato, il valore di connessione non è vuoto e le regole mobile e di pagina lo consentono. Il caricatore condiviso trattiene il widget fino a scorrimento, clic, tocco, pressione di un tasto o timer di fallback. È richiesto JavaScript.

Il widget carica https://cdn.livechatinc.com/tracking.js. Imposta window.__lc.license e facoltativamente window.__lc.group. Quando l’identificazione cliente è attiva, imposta window.__lc.visitor con name e email. I visitatori senza JavaScript non vedono il link alternativo alla chat.

Verifica una volta come ospite e una volta come cliente connesso. Con Trasmetti dati cliente attivo, controlla il nome e l’email del cliente connesso in LiveChat. Questa opzione non invia contenuti del carrello, dettagli dell’ordine o identità degli ospiti. Configura aspetto del widget, operatori, disponibilità, saluti, automazioni e report in LiveChat. Devi avere un account presso il fornitore; la fatturazione dell’account e la disponibilità del servizio non rientrano nel modulo.

Personalizzazione del tema e risoluzione dei problemi

Per una modifica del template a livello di tema, usa:

themes/your-theme/modules/mprlivechatintegration/views/templates/hook/displayBeforeBodyClosingTag.tpl
  • Se non compare alcun widget, controlla l’interruttore di abilitazione, il valore di connessione, la regola di pagina, la regola mobile e l’hook del tema. Avvia un’interazione o attendi il fallback.
  • Se il salvataggio non riesce, copia solo l’identificatore e usa il formato indicato nella tabella delle impostazioni.
  • Se una richiesta di script non riesce, controlla il registro di rete del browser per individuare un URL del fornitore bloccato e verifica la configurazione di sicurezza dei contenuti o di blocco degli script.
  • Se manca l’identificazione, verifica che il cliente sia connesso e che Trasmetti dati cliente sia attivo.
  • Configura gli eventuali blocchi del consenso necessari nell’integrazione del consenso del negozio. Questo modulo non aggiunge una schermata di consenso né un testo sulla privacy.

Usa la pagina "Integrity" del modulo per verificare la configurazione richiesta e gli hook. Licenza, Assistenza e Aggiorna sono disponibili come pagine di manutenzione.

Disattivazione o disinstallazione

Disattiva Attiva LiveChat e salva per mantenere le impostazioni di connessione. Il form principale richiede comunque l’identificatore di connessione. Puoi anche disattivare il modulo dall’elenco dei moduli.

Disinstalla tramite il gestore moduli per rimuovere la configurazione del modulo e le voci del menu di amministrazione. Questo non annulla l’account presso il fornitore e non elimina la cronologia delle conversazioni.

Domande

Ancora nessuna domanda su questo modulo

Chiedi qualsiasi cosa su installazione, compatibilità o configurazione. Le risposte compaiono qui.

Problemi noti

4

Il testo della chat salvato acquisisce caratteri di escape

RisoltoAggiornato:
Risolto nella versione: 1.1.18
Il salvataggio del testo della chat visibile ai visitatori poteva aggiungere caratteri di escape indesiderati. Ora il testo viene salvato senza doppio escape.

Testi del back office tradotti

RisoltoAggiornato:
Risolto nella versione: 1.1.18
Alcuni testi del back office restavano in inglese anche con un'altra lingua selezionata. Ora le etichette usano le traduzioni disponibili.

L'avviso di configurazione mostra le vecchie impostazioni

RisoltoAggiornato:
Risolto nella versione: 1.1.18
L'avviso di configurazione poteva continuare a segnalare un problema subito dopo il salvataggio di impostazioni valide. Ora riflette le impostazioni appena salvate.

Le pagine del back office non si aprono

RisoltoAggiornato:
Risolto nella versione: 1.1.14
L'apertura della configurazione del modulo poteva mostrare un errore anziché le impostazioni. Ora le pagine delle impostazioni si aprono correttamente.

Richieste funzionalità

5

Implementato

Verifiche della configurazione LiveChat

Implementato
Verifica quali impostazioni di connessione obbligatorie devi completare prima che il widget della chat possa apparire.

Amministrazione multilingue

Implementato
Usa le impostazioni di LiveChat tradotte in tedesco, francese, spagnolo, italiano e polacco.

Gestione della licenza

Implementato
Visualizza e gestisci la licenza del modulo da una pagina dedicata del back office.

Aggiornamenti del modulo con un clic

Implementato
Cerca e installa gli aggiornamenti del modulo dal back office.

Testi della chat per lingua

Implementato
Modifica i testi dell’integrazione visibili ai visitatori separatamente per ogni lingua del negozio usando il selettore della lingua.

Registro modifiche

v1.1.132026-10-02

  • Addedcomplete FR/DE/ES/IT/PL translations
  • FixedMigrate chat config from ps_configuration to ConfigTable
Versioni precedenti

v1.3.02026-04-20

  • Addedadmin menu management via MenuInstaller for streamlined module setup
  • AddedLicense management tab with key management and renewal options
  • Addedself-healing integrity checks for automatic diagnostics and repair
  • Addedcomplete FR/DE/ES/IT/PL translations

v1.2.02026-02-16

  • Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
  • Addedcart data push to LiveChat agent panel: item list, quantities, and cart total
  • Improvedcustomer data forwarding: order count and lifetime value synced on login
  • Fixedwidget not loading on pages served through Nginx FastCGI cache
  • Addedticketing escalation integration: open a ticket from within the chat without leaving LiveChat

v1.1.02025-06-17

  • Addedrouting rules: route chats to different agent groups by product category or page type
  • Improvedanalytics integration: LiveChat reports synced with Google Analytics 4 via dataLayer
  • Fixedduplicate chat session opened after customer navigated back using browser history
  • Addedconfigurable greeting message per page type for proactive engagement

v1.0.02025-04-16

  • Initialrelease: LiveChat widget integration for PrestaShop
  • InitialLicense ID configuration with automatic widget injection on all front-office pages
  • InitialCustomer identification: passes name and email to agent panel for recognised customers
  • InitialPage exclusion list configurable from the module admin panel

Demo

Prova il modulo completo prima di acquistare

Acquista la licenza in seguito e mantieni le tue impostazioni.

  • La tua demo di 30 giorni Provalo sul tuo negozio per 30 giorni dalla prima installazione.
  • Negozio demo pronto Esplora un negozio demo pronto nel tuo browser.
  • Senza registrazione Nessun account, e-mail o dominio del negozio richiesto.
Avvia il negozio demo

Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.

Aprendo questa demo accetti i termini della demo e la politica sulla privacy.

Caricamento...
Torna su