Integrazione Zendesk Chat: configurazione e aiuto

Collega il tuo negozio a Zendesk Web Widget con un account del servizio esistente e il relativo identificatore Chiave del widget. Configura le conversazioni e il widget visibile nell'account del servizio.

L'azione "Configure" del modulo apre Configurazione di Zendesk Web Widget. 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 collegamento

In Zendesk Admin Center, apri "Channels" > "Messaging and social" > "Messaging", seleziona il tuo Web Widget e apri "Installation". Copia solo il valore dopo key= nello snippet. Incolla soltanto l'identificatore, non un URL completo o uno script.

Il valore predefinito è vuoto. Per gli identificatori nuovi o modificati, il modulo richiede la chiave fornita nello snippet attuale di Zendesk Web Widget. Il form controlla solo che il campo Chiave del widget non sia vuoto, quindi apri il negozio e controlla che il widget della chat si carichi.

Imposta questi campi in Configurazione di Zendesk Web Widget, 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. Con Mostra su mobile disattivato, il widget appare solo sui dispositivi rilevati come computer desktop.

Campi cliente

Quando Trasmetti dati cliente è attivo, il modulo invia a Zendesk nome ed e-mail del cliente connesso dopo il caricamento del widget. Non fornisce una verifica firmata dell'identità del cliente. Conferma la ricezione nel tuo spazio Zendesk.

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 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 ritardo di ripiego configurato. 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:

https://static.zdassets.com/ekr/snippet.js?key={Widget Key}

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.

Il modulo usa Zendesk Web Widget e riutilizza un'installazione del widget già presente nella pagina. Gestisci messaggistica, instradamento, orari, ticket e automazione in Zendesk.

• Se non viene inserito alcun loader, controlla Attiva Zendesk Web Widget, Chiave del widget, 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/mprzendeskchat/views/templates/hook/displayBeforeBodyClosingTag.tpl

in:

themes/your-theme/modules/mprzendeskchat/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 MPRZDCHAT_ per i nomi dei campi inviati. L'archiviazione attuale usa il modulo mprzendeskchat nella tabella condivisa mpr_config, con chiavi brevi:

ENABLED
WIDGET_KEY
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 Zendesk Web Widget 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.