Integrazione Crisp Chat: configurazione e aiuto
Avvio rapido
- Carica lo ZIP
mprcrispchatintegrationtramite Moduli > "Module Manager" > "Upload a module". - Fai clic su "Configure" per aprire Configurazione Crisp.
- Copia il tuo ID sito web Crisp dalle istruzioni di configurazione dello spazio di lavoro e inseriscilo come UUID in ID sito web.
- Controlla Trasmetti dati cliente, Mostra su mobile e Mostra nelle pagine.
- Lascia Fallback Delay (seconds) a 0 per il fallback predefinito di 10 secondi, oppure inserisci un tempo massimo di attesa positivo.
- Imposta Attiva Crisp Chat su Sì e salva.
- 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.








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
Messaggi di amministrazione rimasti in inglese
L’amministrazione del modulo non si apriva
Vecchie impostazioni della chat non migrate
Richieste funzionalità
7
Implementato
Widget di chat Crisp
Trasmissione dei dati del cliente
Controlli di visualizzazione della chat
Verifiche della configurazione della chat
Aggiornamenti del modulo dal back office
Altre lingue di amministrazione
Testi multilingue per i visitatori
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.