Integrazione Chatra Chat: configurazione e aiuto

Ti servono un account del servizio esistente e il valore del campo ID widget. Configura le conversazioni e il widget visibile nell'account del servizio.

L'azione "Configure" del modulo apre Configurazione Chatra. Il controller di configurazione mostra anche un avviso di configurazione richiesta e un banner di integrità. Usa le pagine Configurazione, "Integrity", Licenza, Supporto e Aggiorna del modulo per le rispettive attività di manutenzione.

Trova il valore di collegamento

Copia ChatraID dal codice di installazione del widget Chatra. Il pannello di configurazione indica "Settings" > "General" > "Widget code". Incolla solo l'identificatore, non un URL completo o uno script.

Il valore predefinito è vuoto. Per gli identificatori nuovi o modificati, il modulo richiede da 8 a 128 lettere, numeri, trattini o trattini bassi. Un identificatore rifiutato mantiene la configurazione salvata in precedenza. Correggi il valore e salva di nuovo.

Imposta questi campi in Configurazione Chatra, 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. Mostra su mobile usa il rilevamento mobile di PrestaShop anziché la sola larghezza del browser.

Campi cliente

Quando Trasmetti dati cliente è attivo, il modulo invia il nome completo e l’indirizzo e-mail dei clienti connessi a Chatra tramite ChatraIntegration. Imposta No per omettere entrambi i campi.

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 modulo registra displayBeforeBodyClosingTag. Controlla prima l'interruttore di attivazione, il valore di collegamento e le regole di dispositivo e 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 ritardo di ripiego configurato. Il loader condiviso elimina il ritardo interno del template, quindi le due attese non si sommano. 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://call.chatra.io/chatra.js

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.

Gestisci operatori, conversazioni, trigger e aspetto del widget in Chatra.

• Se non viene inserito alcun loader, controlla Attiva Chatra Chat, ID 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/mprchatra/views/templates/hook/displayBeforeBodyClosingTag.tpl

in:

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

ENABLED
WIDGET_ID
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 Chatra Chat 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.