Integrazione Smartsupp Chat: configurazione e aiuto

Ti servono un account già esistente nel servizio e il relativo identificativo Website Key. Configura le conversazioni e il widget visibile nell'account del servizio.

L’azione "Configure" del modulo apre Configurazione Smartsupp. Questa pagina mostra anche un avviso di configurazione richiesta e un banner di integrità. Usa le pagine Configurazione, Integrità, Licenza, Assistenza e Aggiornamento del modulo per le relative operazioni di manutenzione.

Trova il valore di connessione

Copia _smartsupp.key dal codice di installazione della chat Smartsupp. Il form ti rimanda a "Settings" > "Chat box". Incolla solo l'identificativo. Non incollare un URL o uno script completo.

Il valore predefinito è vuoto. Per gli identificativi nuovi o modificati, il modulo richiede da 16 a 128 lettere, numeri, trattini o trattini bassi. Se un identificativo viene rifiutato, la configurazione salvata in precedenza rimane invariata. Correggi il valore e salva di nuovo.

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

Gruppi di pagine

La selezione usa i nomi dei controller. Un controller di checkout personalizzato non presente in questo elenco non è incluso da Solo pagine checkout. Non esiste un campo per regole URL personalizzate. Mostra su mobile usa il rilevamento dei dispositivi mobili di PrestaShop, non soltanto la larghezza del browser.

Campi cliente

Il modulo si collega usando _smartsupp.key. Quando il passaggio dei dati cliente è attivo, trasmette a Smartsupp anche l’e-mail (_smartsupp.email) e il nome (_smartsupp.name) del cliente che ha effettuato l’accesso.

Questo modulo non trasmette a Smartsupp campi di identità cliente di PrestaShop per i visitatori che non hanno effettuato l’accesso. Il servizio può comunque raccogliere informazioni tramite il proprio widget. Questo modulo non sincronizza la cronologia degli ordini né il contenuto del carrello.

Esempio di configurazione

Per le pagine di checkout su desktop, scegli Solo pagine checkout, imposta Mostra su mobile su No e Ritardo di fallback (secondi) su 2. Il loader si avvia alla prima interazione o dopo due secondi senza interazione.

Il modulo registra displayBeforeBodyClosingTag. Prima controlla l'interruttore di attivazione, il valore di connessione, la regola del dispositivo e la regola della pagina. Poi inserisce un loader differito verso la fine della pagina.

Scorri, fai clic, tocca la pagina o premi un tasto per avviare il caricamento. Senza interazione, attendi il tempo di attesa configurato. È l’attesa totale, senza ulteriori ritardi successivi. Con il valore iniziale 0, attendi 10 secondi prima di considerare un errore il mancato caricamento su una pagina inattiva.

Negli strumenti per sviluppatori del browser, verifica la presenza di una richiesta corrispondente a:

https://www.smartsuppchat.com/loader.js?

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

Gestisci operatori, disponibilità, notifiche, registrazioni e chatbot in Smartsupp. Il modulo non crea un account né configura queste funzioni del servizio.

• Se non viene generato alcun loader, controlla Abilita chat Smartsupp, Website Key, Mostra sulle pagine e Mostra su mobile.
• Se la pagina rimane senza interazione, attendi il fallback o interagisci con la pagina. Ritardo di fallback (secondi) impostato su 0 non significa caricamento immediato.
• Se il salvataggio non riesce, mantieni compilato l'identificativo, verificane 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 nella console del browser, il blocco degli script, la Content Security Policy e gli strumenti per il consenso del tuo negozio.
• Se lo script si carica ma manca il pulsante di apertura, controlla la pubblicazione del widget nel servizio, la disponibilità dell'account e le regole di visualizzazione.
• 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 anch'essa lo script del servizio, controlla nella pagina generata la presenza di codice di installazione duplicato o in conflitto.

Verifica un tema personalizzato

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

{hook h='displayBeforeBodyClosingTag'}

Per modificare il template del tema, copia:

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

in:

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

Mantieni le variabili Smarty del modulo e l'escaping dell'identificativo. Il wrapper di interazione condiviso si applica ancora a questo template dell'hook.

Il form usa il prefisso MPRSMART_ per i nomi dei campi inviati dal form. Attualmente i dati sono memorizzati per il modulo mprsmartsupp nella tabella condivisa mpr_config, con chiavi brevi:

ENABLED
WEBSITE_KEY
SHOW_MOBILE
PAGES
DELAY
PASS_USER_DATA

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

Imposta Abilita chat Smartsupp su No e salva lasciando l'identificativo compilato per sospendere l'output di questo modulo. Puoi anche disattivare il modulo in "Module Manager".

Per rimuoverlo, usa "Uninstall" in "Module Manager" e conferma. La disinstallazione rimuove la configurazione del modulo e le relative voci del menu di amministrazione. Non chiude l'account del servizio esterno né rimuove il codice inserito da un altro modulo o tema.