Integrazione Freshchat: configurazione e aiuto

Collega il tuo negozio a Freshchat con un account del servizio esistente e il relativo identificativo Token. Configura le conversazioni e il widget visibile nell'account del servizio.

L'azione "Configure" del modulo apre Configurazione Freshchat. La pagina mostra anche un avviso di configurazione necessaria 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 connessione

Copia il Token dal codice di installazione di Freshchat Web Messenger. Il modulo ti rimanda a "Settings" > "Web Messenger". 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 un UUID contenente cifre esadecimali nel formato 8-4-4-4-12. Se un identificativo viene rifiutato, la configurazione salvata in precedenza rimane invariata. Correggi il valore e salva di nuovo.

Imposta questi campi in Configurazione Freshchat, 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 di 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 widget usa il token salvato e si collega a https://wchat.freshchat.com. Quando Trasmetti dati cliente è attivo, invia l'email del cliente connesso come identificatore cliente e indirizzo email, e il nome completo come nome.

Questo modulo non fornisce agli ospiti campi di identità cliente di PrestaShop. 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 di checkout, imposta Mostra su mobile su No e "Fallback Delay (seconds)" su 2. Il loader si avvia alla prima interazione o dopo due secondi senza interazione.

Il loader del widget appare verso la fine delle pagine consentite del negozio quando il modulo è attivo, il valore di connessione è compilato e la regola del dispositivo lo consente.

Scorri, fai clic, tocca la pagina o premi un tasto per attivare il loader. Senza interazione, attendi il fallback configurato. Con il valore predefinito di installazione 0, attendi 10 secondi prima di considerare il mancato caricamento su una pagina senza interazione come un errore.

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

https://wchat.freshchat.com/js/widget.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.

Questo modulo non ha un'impostazione "Host". Un host regionale o personalizzato richiede una modifica al template da parte di uno sviluppatore. Gestisci saluti, colori, bot, campagne, agenti e regole della posta in arrivo in Freshchat.

• Se non viene generato alcun loader, controlla Attiva Freshchat, Token, Mostra nelle pagine e Mostra su mobile.
• Se la pagina rimane senza interazione, attendi il fallback o interagisci con la pagina. "Fallback Delay (seconds)" 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/mprfreshchat/views/templates/hook/displayBeforeBodyClosingTag.tpl

in:

themes/your-theme/modules/mprfreshchat/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 MPRFCHAT_ per i nomi dei campi inviati dal form. Attualmente i dati sono memorizzati per il modulo mprfreshchat nella tabella condivisa mpr_config, con chiavi brevi:

ENABLED
TOKEN
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 Attiva Freshchat 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.