Integrazione JivoChat: configurazione e aiuto

Collega il tuo negozio a JivoChat. Ti servono un account già esistente nel servizio e il relativo identificativo ID widget. Configura le conversazioni e il widget visibile nell'account del servizio.

L'azione "Configure" del modulo apre Configurazione JivoChat. La pagina di configurazione 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 l'identificativo ID widget dal codice di installazione del canale del tuo sito web in JivoChat. Il pannello di configurazione rimanda a "Manage" > "Channels" > "Website widget". 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 5 a 128 lettere o numeri. Se un identificativo viene rifiutato, la configurazione salvata in precedenza rimane invariata. Correggi il valore e salva di nuovo.

Imposta questi campi in Configurazione JivoChat, 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

Quando Trasmetti dati cliente è attivo e il cliente è connesso, il modulo registra window.jivo_onLoadCallback prima di caricare il widget. Quando JivoChat richiama questa funzione e jivo_api è disponibile, invia nome ed email tramite jivo_api.setContactInfo. Imposta No per omettere questo trasferimento.

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 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 attivare il loader. Senza interazione, attendi il fallback configurato. Il loader condiviso rimuove il ritardo interno del template, quindi le due attese non si sommano. 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:

//code.jivosite.com/widget/{Widget ID}

Apri il widget e invia un messaggio di prova. Verifica che arrivi nella casella di posta del servizio. Infine, prova le pagine e i dispositivi mobili esclusi.

Gestisci operatori, canali, instradamento, moduli offline e automazione in JivoChat. Questo modulo fornisce il loader del widget nel negozio e le regole di visualizzazione.

• Se non viene generato alcun loader, controlla Attiva JivoChat, ID widget, 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 mancano nome o email del cliente connesso, controlla Trasmetti dati cliente, ricarica la pagina e cerca errori o un’altra integrazione che sostituisce window.jivo_onLoadCallback.
• 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/mprjivochat/views/templates/hook/displayBeforeBodyClosingTag.tpl

in:

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

ENABLED
WIDGET_ID
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 JivoChat 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.