Integrazione Crisp Chat: configurazione e aiuto

Avvio rapido

  1. Carica lo ZIP mprcrispchatintegration tramite Moduli > "Module Manager" > "Upload a module".
  2. Fai clic su "Configure" per aprire Configurazione Crisp.
  3. Copia il tuo ID sito web Crisp dalle istruzioni di configurazione dello spazio di lavoro e inseriscilo come UUID in ID sito web.
  4. Controlla Trasmetti dati cliente, Mostra su mobile e Mostra nelle pagine.
  5. Lascia Fallback Delay (seconds) a 0 per il fallback predefinito di 10 secondi, oppure inserisci un tempo massimo di attesa positivo.
  6. Imposta Attiva Crisp Chat su Sì e salva.
  7. Apri una pagina consentita e scorri o fai clic per mostrare la sezione Privacy della chat. Scegli Consenti la chat Crisp, poi verifica il fumetto. Prova anche il fallback senza interagire.

Richiede PrestaShop 1.6 o successivo e PHP 7.1 o successivo.

Manuale di configurazione

Installazione e configurazione

Segui i passaggi in Avvio rapido.

Configurazione Crisp

Apri "Configure" in "Module Manager". Devi avere uno spazio di lavoro Crisp esistente. Il pannello Configurazione Crisp fornisce le istruzioni per l’ID sito web e mostra l’ID salvato.

Impostazione Valore predefinito Cosa configuri
Attiva Crisp Chat Sì Consenti i controlli privacy della chat nelle pagine idonee. È comunque richiesto un ID sito web.
ID sito web Vuoto Inserisci l’UUID riportato nelle istruzioni di configurazione Crisp, ad esempio 12345678-90ab-cdef-1234-567890abcdef.
Trasmetti dati cliente Sì Offri ai clienti connessi una scelta separata, inizialmente non selezionata, per condividere email e nome completo con Crisp. Disattiva per omettere questa scelta e il trasferimento.
Mostra su mobile Sì Consenti la visualizzazione sui dispositivi che PrestaShop rileva come mobili.
Fallback Delay (seconds) 0 Imposta l’attesa massima prima di mostrare i controlli privacy senza interazione. Zero usa 10 secondi. Questo non concede il permesso per la chat.
Mostra nelle pagine Tutte le pagine Scegli Tutte le pagine, Solo pagine prodotto, Solo pagine di categoria o Solo pagine di checkout.

Il targeting del checkout corrisponde a cart, order, order-opc, orderopc e checkout. Controlla il nome del controller, non URL di checkout arbitrari. Usa Tutte le pagine se un controller di checkout personalizzato non è incluso.

Il caricatore condiviso mostra i controlli privacy alla prima interazione, come scorrere, fare clic o toccare la pagina, oppure al momento di fallback configurato. Il valore 5 indica al massimo cinque secondi di attesa. Interagire o attendere non concede mai il consenso. Un permesso già salvato per questa scheda può quindi caricare la chat automaticamente.

Le modifiche all’ID sito web vengono convalidate prima del salvataggio. Una modifica non valida mantiene la configurazione precedente. L’avviso di verifica controlla anche il formato UUID. I controlli privacy appaiono solo con un ID presente, il modulo attivo e pagina e dispositivo consentiti. Inserisci l’ID dal modulo di configurazione.

Comportamento nel negozio e dati cliente

Il modulo usa displayFooter su PrestaShop 1.6 e displayBeforeBodyClosingTag nelle versioni successive. Dopo l’attivazione del caricatore condiviso mostra la sezione Privacy della chat e carica il file locale views/js/consent.js. Solo la scelta esplicita Consenti la chat Crisp, o un permesso ricordato, inizializza window.$crisp, assegna window.CRISP_WEBSITE_ID e carica https://client.crisp.chat/l.js in modo asincrono.

Se Trasmetti dati cliente è attivo e il cliente è connesso, i controlli mostrano una casella separata, inizialmente non selezionata, per nome ed email. Solo selezionandola prima di consentire la chat vengono accodati user:email e user:nickname con email e nome completo. Consentire solo la chat non trasmette l’identità dell’account. Il modulo non trasmette nome/email per gli ospiti. Il tuo team gestisce le conversazioni in Crisp.

Configura aspetto, posizione, disponibilità, casella di posta e automazioni in Crisp. Il permesso per la chat e la scelta separata sui dati vengono ricordati in sessionStorage per la scheda corrente, in base al percorso del negozio, all’ID sito web e al cliente. Se la memoria del browser è bloccata, il permesso vale solo per la pagina corrente. Dopo un rifiuto i visitatori possono riaprire la sezione Privacy della chat o revocare lì il permesso. La revoca ricarica la pagina e impedisce ulteriori caricamenti del modulo; non elimina i dati o i cookie già conservati da Crisp.

Personalizzare il template

Copia il template sorgente nel tuo tema e modifica la copia:

/modules/mprcrispchatintegration/views/templates/hook/displayBeforeBodyClosingTag.tpl
/themes/your_theme/modules/mprcrispchatintegration/views/templates/hook/displayBeforeBodyClosingTag.tpl

Il template riceve {$mprcrisp.website_id}, {$mprcrisp.delay}, {$mprcrisp.customer_email} e {$mprcrisp.customer_name}, oltre all’URL dello script locale, all’ambito del consenso e alle etichette privacy tradotte. Usa l’alias cr. Il renderer condiviso imposta il ritardo del template a zero perché gestisce i tempi di interazione/fallback.

Nella copia del tema conserva i controlli del consenso, i loro ID e attributi data-crisp-*, il riferimento allo script locale e l’escaping. Il trasferimento dei dati cliente ora avviene nello script del consenso e non tramite comandi incorporati nel template. La casella facoltativa è:

{if $cr.customer_email || $cr.customer_name}
<label><input type="checkbox" data-crisp-share> {$cr.share_label|escape:'html':'UTF-8'}</label>
{/if}

Le chiavi di configurazione sono ENABLED, WEBSITE_ID, SHOW_MOBILE, PAGES, DELAY e PASS_USER_DATA, memorizzate per mprcrispchatintegration nel sistema di configurazione condiviso. Modificale dal back office.

Verificare il widget

Apri una pagina consentita come ospite in una nuova scheda. Scorri o fai clic e verifica che i controlli appaiano senza richieste a Crisp. Prova anche il fallback senza interagire. Rifiuta e verifica che la chat resti disattivata; riapri le impostazioni e consenti la chat, poi controlla client.crisp.chat/l.js e il fumetto. Prova le pagine consentite ed escluse e un dispositivo mobile quando la visibilità mobile è disattivata.

Accedi come cliente di prova. Con Trasmetti dati cliente attivo, consenti prima la chat senza selezionare la condivisione e verifica l’assenza di comandi email/nickname. Revoca il permesso, riapri i controlli, seleziona la casella e consenti la chat per provare il trasferimento. Disattiva l’impostazione del commerciante e verifica su una pagina ricaricata che scelta e trasferimento siano assenti. Prova la navigazione nella scheda, la memoria bloccata e la revoca. Nessuna di queste azioni elimina i dati già conservati in Crisp.

Risolvere i problemi

Se il widget è assente, controlla Attiva Crisp Chat, ID sito web, targeting delle pagine, rilevamento mobile e timer di interazione/fallback. Apri la sezione Privacy della chat e consenti la chat. Verifica l’hook displayFooter su PrestaShop 1.6 o displayBeforeBodyClosingTag nelle versioni successive, JavaScript attivo ed eventuali blocchi dello script locale del consenso o della richiesta Crisp.

Se il salvataggio non riesce, inserisci un UUID completo e controlla l’avviso di configurazione. Se esiste un override nel tema, confrontalo con il template attuale del modulo. Rimuovi i caricatori Crisp duplicati dal tema o da altri moduli.

Se aspetto o disponibilità differiscono dalle aspettative, controlla le impostazioni dello spazio di lavoro Crisp. Usa la pagina "Integrity" del modulo se mancano file del modulo o la sua infrastruttura di configurazione condivisa.

Disattivazione o disinstallazione

Imposta Attiva Crisp Chat su No e salva per arrestare questa integrazione mantenendo le impostazioni. Disinstalla tramite "Module Manager" per rimuovere il menu e i valori di configurazione. Lo spazio di lavoro Crisp, le conversazioni e i dati cliente presso il fornitore vengono gestiti separatamente in Crisp.

Schermate di riferimento

Usa i nomi delle impostazioni riportati sopra quando una schermata di riferimento differisce dalla versione installata.

Crisp Chat Integration, pagina Crisp nel back office

Crisp Chat Integration, posizionamento e comportamento della chat nel back office

Crisp Chat Integration, configurazione Crisp 1000w

Crisp Chat Integration, configurazione della chat nel back office

Crisp Chat Integration, configurazione Crisp

Crisp Chat Integration, configurazione Crisp confermata 1000w

Crisp Chat Integration, configurazione Crisp confermata

Crisp Chat Integration, pagina Crisp nel back office 1000w

Domande

Ancora nessuna domanda su questo modulo

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

Problemi noti

4

Stato di installazione obsoleto dopo il salvataggio

RisoltoAggiornato:
Risolto nella versione: 1.1.19
Il banner dello stato di installazione poteva continuare a riflettere le impostazioni precedenti all’ultimo salvataggio.

Messaggi di amministrazione rimasti in inglese

RisoltoAggiornato:
Risolto nella versione: 1.1.19
Alcuni messaggi di amministrazione non usavano le traduzioni installate.

L’amministrazione del modulo non si apriva

RisoltoAggiornato:
Risolto nella versione: 1.1.15
Una dipendenza di compatibilità mancante nel pacchetto poteva causare un errore fatale aprendo l’amministrazione del modulo.

Vecchie impostazioni della chat non migrate

RisoltoAggiornato:
Risolto nella versione: 1.1.14
Un aggiornamento poteva lasciare le impostazioni della chat nel vecchio archivio, facendo sembrare persa la configurazione del modulo.

Richieste funzionalità

7

Implementato

Widget di chat Crisp

Implementato
Aggiungi Crisp al negozio usando il Website ID del negozio.

Trasmissione dei dati del cliente

Implementato
Trasmetti facoltativamente a Crisp il nome e l'email del cliente connesso.

Controlli di visualizzazione della chat

Implementato
Scegli la visibilità sui dispositivi mobili, il ritardo di visualizzazione e le pagine di destinazione del widget di chat.

Verifiche della configurazione della chat

Implementato
Controlla le impostazioni Crisp richieste e lo stato dell'installazione del modulo dall'amministrazione.

Aggiornamenti del modulo dal back office

Implementato
Verifica la disponibilità degli aggiornamenti del modulo e installali dall'amministrazione.

Altre lingue di amministrazione

Implementato
Usa i testi del modulo tradotti in francese, tedesco, spagnolo, italiano e polacco.

Testi multilingue per i visitatori

Implementato
Configura i testi della chat per i visitatori separatamente per ogni lingua del negozio.

Registro modifiche

v1.1.142026-05-27

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

v1.1.142026-05-26

  • Certified the release ZIP with the shared package surface gate.
  • Rebuilt the package without source maps, build tooling or leaked shared-package development files.
  • Aligned module source, config.xml, composer metadata, package metadata and live release metadata.
  • Refreshed localized product descriptions so translated pages explain the same Crisp integration scope as the English page.

v1.1.132026-05-25

  • Completed locale coverage for Crisp Chat configuration and storefront labels.
  • Confirmed product-page content with real Crisp configuration screenshots and code references.

v1.1.x

  • Crisp Website ID configuration from PrestaShop Back Office.
  • Optional logged-in customer email and name handoff to Crisp.
  • Mobile visibility, fallback delay and page targeting controls.
  • Back-office readiness checks for the required Crisp Website ID configuration.

Demo

Prova il modulo completo

  • Negozio demo pronto Esplora un negozio demo pronto nel tuo browser.
  • Senza registrazione Nessun account, e-mail o dominio del negozio richiesto.

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

Caricamento...
Torna su