Chatta con i visitatori con WebBlocks Live Chat

Per installare plugin usa un sito di prova e un account Super admin. Il pacchetto pubblicato richiede PHP >=8.4 e CMS ^1.106.2; il catalogo indica Laravel ^13.0. Questa versione minima del CMS avvia i canali di notifica e i componenti del pannello dei plugin installati nelle normali richieste, anche su host con rotte in cache. Verifica la compatibilità del tuo host prima di scaricare il pacchetto dal catalogo ufficiale dei plugin.

Prepara una pagina raggiungibile dai visitatori e un account operatore con accesso al suo sito. La pagina fittizia è Talk to Northstar Studio, all'indirizzo /studio-help. Titoli e schede sono normali blocchi CMS: non viene inserito un blocco Live Chat. Il plugin attivo fornisce il pulsante di apertura nelle pagine pubbliche del sito selezionato.

Decidi chi risponderà e che cosa devono promettere i testi online e offline. La disponibilità è un'impostazione manuale di ricezione: non rileva la presenza degli operatori e non garantisce una risposta immediata. Le normali risposte appaiono nel widget. In questa versione le email di risposta ai visitatori sono disattivate, anche quando viene indicato un indirizzo.

1. Apri System → Plugins come Super admin.
2. Seleziona Browse Plugin Catalog e cerca WebBlocks Live Chat.
3. Esamina versione, esito di compatibilità e note di rilascio.
4. Usa Install from Catalog, apri i dettagli dell'installazione e seleziona Enable Plugin.
5. Se l'amministratore fornisce l'archivio pubblicato attendibile, sceglilo in Plugin ZIP, premi Upload Plugin ZIP, esamina il pacchetto installato e attivalo.

L'esempio usa lo ZIP ufficiale pubblicato. Un plugin appena installato è inizialmente disattivato.

L'installazione e l'attivazione correnti del CMS applicano le modifiche del database del plugin. Controlla nei dettagli la versione prevista, lo stato Enabled e l'archiviazione pronta. Risolvi gli avvisi di migrazione o compatibilità prima di raccogliere messaggi. Un avviso sui livelli sovrapposti di un host precedente non è puramente estetico: aggiorna a un host compatibile prima di distribuire questa versione.

Apri Open Settings oppure usa Live Chat → Live Chat Settings nella navigazione. Il titolo delle impostazioni identifica il sito scelto. In un'installazione multisito, seleziona quello corretto prima di modificare impostazioni o aprire la posta in arrivo.

Live Chat separa lettura, risposta e configurazione:

Concedi lettura e risposta agli operatori che rispondono. Chi gestisce le impostazioni necessita anche della lettura se lavora nella posta in arrivo. L'accesso al sito costituisce un ulteriore limite: i permessi del plugin non aprono le conversazioni di tutti i siti. Consulta Ruoli e permessi prima di cambiare un ruolo condiviso.

Diversamente dall'elenco Support specifico del richiedente, Live Chat è una posta in arrivo per gli operatori del sito. Gli operatori autorizzati possono gestire le conversazioni dei suoi visitatori. Ricorda questa distinzione quando concedi accesso a conversazioni che possono contenere dati personali.

In Live Chat Settings → General settings, imposta:

Seleziona Save settings nella scheda generale. Attivare il plugin e attivare il widget pubblico di un sito sono operazioni separate.

La pagina mostra anche la politica di notifica ereditata dal sito e lo stato registrato dello scheduler. Riguardano la consegna email, non la possibilità di iniziare una conversazione online. Configureremo l'email dopo aver verificato i messaggi in entrambe le direzioni.

Scorri fino a Language texts. Ogni lingua attiva del sito ha una scheda. Per l'inglese inserisci:

Seleziona Save language texts in questa scheda. Il modulo è separato da General settings: salvare i testi conserva le opzioni generali, mentre salvare le opzioni conserva i testi. Verifica il messaggio di successo del modulo effettivamente salvato.

Ripeti per le altre lingue attive quando necessario. Il testo mancante ricade prima sulla lingua predefinita, poi sui testi precedenti. Titoli ed etichette ammettono fino a 120 caratteri; messaggi localizzati di benvenuto e offline fino a 500 caratteri. Se manca una lingua, attivala prima seguendo Aggiungere una lingua a un sito.

Prometti il canale che offri davvero. «Rispondiamo qui» è appropriato per questa versione; «Invieremo la risposta via email» descriverebbe in modo errato la consegna al visitatore.

Apri una pagina pubblicata del sito configurato. Nell'esempio, Northstar mostra Chat with Northstar in basso a destra. Il pannello resta chiuso finché il visitatore non seleziona il pulsante.

Il widget è fornito dalle risorse pubbliche del plugin. Non aggiungi script esterni, account di chat ospitata o blocchi chat a ogni pagina. Se manca il pulsante, verifica attivazione, sito selezionato, abilitazione del widget e caricamento delle risorse CMS supportate nel layout pubblico.

Prova in una sessione visitatore appropriata. Live Chat applica limiti distinti all'avvio delle conversazioni, all'invio e alle richieste di aggiornamento. Le normali richieste di notifica non consumano la quota di avvio. Se compare Too Many Attempts, interrompi gli invii ripetuti, attendi la scadenza della finestra normale e riprova una volta.

Seleziona il pulsante. Il pannello mostra titolo e benvenuto salvati. Nell'esempio online, scrivi Ada in Your name, lascia vuoto Email (optional) e descrivi la richiesta in How can we help?.

Seleziona Start conversation. Il primo messaggio appare nella conversazione e il modulo diventa un campo messaggio con Send.

I nomi ammettono fino a 100 caratteri, gli indirizzi email fino a 255 e i messaggi dei visitatori fino a 4 000. Scrivi un primo messaggio breve e utile, evitando informazioni riservate estranee all'assistenza. Fornire un indirizzo non abilita email di risposta al visitatore.

Il browser conserva una credenziale privata per continuare il thread. Non è un accesso operatore. Non copiarla in schermate, URL condivisi con colleghi o note diagnostiche. Cancellare la memoria del browser, cambiare profilo o origine può far perdere l'accesso al thread; qui il plugin non offre un recupero tramite email.

Apri Live Chat nel CMS e verifica il sito sotto il titolo. La posta in arrivo mostra stato del widget, disponibilità manuale e viste con contatori:

Ada compare inizialmente con 1 unread e Awaiting reply. L'elenco mostra l'ultimo messaggio e offre View conversation.

L'ordine predefinito delle conversazioni aperte dà priorità a quelle in attesa di risposta, partendo dalla data più vecchia dell'ultimo messaggio. Puoi scegliere anche Latest message first o Oldest message first. La vista chiusa parte per impostazione predefinita dal più recente. Scegli l'ordine adatto al tuo processo, senza considerare la prima riga una decisione automatica di priorità.

Apri il nome di Ada o View conversation. I messaggi del visitatore sono a sinistra e quelli dell'operatore a destra, con separatori dei giorni e orari nel fuso del sito.

Leggere in fondo a una conversazione visibile contrassegna i messaggi come letti. Torna alla posta prima di rispondere: Unread conversations è a zero, ma Awaiting reply rimane a uno. Aprire la conversazione non ha risposto ad Ada.

Durante la lettura dei messaggi precedenti, un nuovo arrivo non forza lo scorrimento in fondo. New messages riporta agli ultimi messaggi. Posta e conversazioni si aggiornano ogni cinque secondi quando visibili; le schede in secondo piano sospendono le richieste e controllano di nuovo tornando visibili. Sono aggiornamenti tramite polling, non una connessione WebSocket o una garanzia di consegna istantanea.

Apri il thread di Ada, inserisci la risposta in Reply e seleziona Send reply:

Controlla Reply sent. e il messaggio dell'operatore. Torna al widget e verifica che la risposta sia visibile al visitatore. Lo scambio locale reale mostra quel messaggio da entrambi i lati.

La nota sotto il modulo è intenzionale: Replies appear in the chat widget. No reply email is sent. Chiedi ai visitatori di mantenere disponibile lo stesso browser o tornarvi. Una risposta salvata non dimostra una consegna via email.

Ada prepara un messaggio successivo:

Chiudi il widget con Close chat, poi riaprilo dal pulsante. La bozza non inviata resta nel campo del messaggio. Chiudere il pannello è diverso dalla chiusura della conversazione da parte dell'operatore.

Seleziona Send quando sei pronto. Il thread torna in attesa di risposta perché l'ultimo messaggio ora è del visitatore. Mantieni insieme i messaggi correlati: una nuova domanda non richiede un'altra conversazione se il tema è ancora aperto.

Gli operatori autorizzati ricevono un badge di conversazioni non lette sul collegamento laterale Live Chat e sul relativo gruppo compresso. Un nuovo messaggio può mostrare anche un avviso generico nel pannello con View unread conversations, mentre lavori altrove nel CMS. L'avviso non contiene nome, indirizzo email o testo del visitatore.

La prima istantanea delle notifiche stabilisce lo stato corrente: non ripropone vecchi arrivi come nuovi toast. La conversazione aperta, una scheda nascosta o un'altra scheda del pannello influenzano il momento in cui appare il toast. Badge e avvisi non segnano messaggi come letti e non rispondono. Sono notifiche interne, separate da permessi del sistema operativo ed email; usa le viste dei non letti e delle attese per gestire il lavoro effettivo.

Nella posta in arrivo cerca workshop e seleziona Filter. La conversazione di Ada corrisponde a un messaggio precedente anche se l'anteprima dell'ultimo descrive ormai sei partecipanti e l'orientamento del marchio.

La ricerca comprende nomi, email e cronologia nel sito e nella vista scelti. La riga continua a mostrare l'ultimo messaggio anziché sostituirlo con il risultato storico. I contatori della vista riguardano il sito indipendentemente dalla ricerca. Clear torna alla vista aperta e all'ordine predefiniti del sito.

Usa Awaiting reply per il lavoro senza risposta e Unread per i messaggi ancora da leggere. Nessuna vista sostituisce un processo concordato sui tempi di risposta. Un collega che apre un thread può cambiarne lo stato di lettura senza risolvere la domanda.

Quando la conversazione è terminata, aprila e seleziona Close conversation. L'operatore vede Closed e l'azione Reopen conversation al posto del normale modulo di risposta.

Il widget mostra This conversation is closed., disattiva le risposte e offre Start a new conversation.

Avviare una nuova conversazione cancella dal browser la credenziale e il testo del thread salvato, tornando al modulo iniziale. Un messaggio non inviato può passare al nuovo modulo. È un thread nuovo, non un modo per riaprire l'originale. La cronologia chiusa resta accessibile agli operatori autorizzati del sito.

L'operatore può selezionare Reopen conversation. Il thread torna aperto e il widget esistente riprende ad accettare risposte dopo il prossimo aggiornamento.

Abbiamo provato chiusura e riapertura dello stesso thread. La riapertura non ripristina una credenziale già cancellata avviando un altro thread o eliminando la memoria del browser. Usala quando ha senso continuare l'originale e verifica che il visitatore possa ancora accedervi.

L'email è facoltativa e separata dal widget. Chiedi prima all'amministratore dell'hosting di configurare il trasporto in uscita e l'URL attendibile dell'applicazione. Il plugin usa la configurazione email del CMS, senza memorizzare nuove credenziali SMTP nelle impostazioni.

Apri Sites → Edit site → Contact e controlla Site message notifications. La politica vale per i canali partecipanti, incluso Live Chat. Nell'esempio locale manteniamo Alert only, scegliamo Immediate e disattiviamo Daily pending-message summary, così la prova non richiede consegna pianificata.

Le opzioni di contenuto hanno effetti diversi:

• Alert only: conteggi minimi e un normale collegamento alla posta protetta; la notifica minima esclude nomi, indirizzi, testi, URL di origine e credenziali private della conversazione.
• Full: include più informazioni sulla conversazione e il contenuto del messaggio. Sceglilo solo se adatto all'organizzazione e alla destinazione email.

Anche la frequenza di consegna è condivisa:

I riepiloghi giornalieri restano minimi anche con contenuto Full. Il riepilogo giornaliero separato del lavoro in sospeso può ricordare messaggi non letti o senza risposta; richiede anch'esso pianificazione. Salva consapevolmente la politica perché anche gli altri canali partecipanti la ereditano.

Torna a Live Chat Settings. Imposta Availability su Offline, mantieni attivo Require email when offline e salva. Il widget resta attivo: Offline modifica la ricezione, mentre disattivare il widget elimina il pulsante pubblico.

Se il team vuole avvisi email, attiva Notify operators of offline messages, inserisci il destinatario Offline notification recipient previsto e seleziona Save settings. Il nostro studio@example.test è fittizio e accettato solo dal ricevitore locale. Per verificare la tua consegna usa una vera casella di prova sotto il tuo controllo.

Con il permesso di gestione puoi cambiare disponibilità anche dall'interruttore Availability nella posta. Salva subito e conserva le altre opzioni. Non autentica il personale e non ne rileva la presenza. Senza JavaScript usa il controllo Save adiacente o il modulo delle impostazioni.

Usa una conversazione nuova invece di supporre che un'impostazione cambi retroattivamente la ricezione di un thread esistente. Nell'esempio il precedente viene chiuso e il visitatore seleziona Start a new conversation. Il widget aggiornato mostra il testo offline e Email (required).

Inserisci Robin, robin@example.test e una breve domanda. In questa nuova conversazione offline l'email non può più essere vuota; la ricezione online consente ancora di ometterla.

Invia una volta, poi controlla come operatore la posta del sito scelto. Apri il thread di Robin, leggi il messaggio e verifica Offline operator notification. La prova mostra Sent to mail transport e il ricevitore SMTP locale ha accettato l'avviso con la politica salvata Alert only / Immediate e riepiloghi giornalieri disattivati. Questo conferma il passaggio al trasporto configurato, non l'arrivo in una vera casella. Le risposte a Robin restano nel widget e non vengono inviate per email.

Se la consegna è in coda, controlla prima la politica ereditata. Lotti e invii giornalieri possono normalmente attendere. Per un avviso Immediate ancora in attesa, chiedi all'amministratore di verificare versioni supportate, canale attivo, destinatario e trasporto in uscita. Un messaggio già incluso nelle notifiche offline può essere inviato anche dopo il passaggio a Online. Disattivare il canale o chiudere la conversazione annulla il lavoro in coda. I tentativi falliti o dall'esito ambiguo non vengono ripetuti automaticamente; non promettere un'email consegnata per ogni messaggio salvato.

Live Chat Settings mostra le evidenze di Scheduler and notification worker. Un'attività registrata non dimostra che lo scheduler dell'hosting funzioni. L'amministratore o il fornitore deve eseguire la pianificazione Laravel ogni minuto con l'utente dell'applicazione e la corretta versione PHP da riga di comando. Segui Notifiche pianificate e stato dello scheduler.

Notifiche in lotti e giornaliere, oltre ai promemoria quotidiani del lavoro in sospeso, richiedono questo collegamento. I soli avvisi immediati senza riepiloghi giornalieri non ne hanno bisogno; badge, toast del pannello e normali richieste della chat non richiedono uno scheduler email.

L'esempio locale è intenzionalmente privo di pianificazione di produzione verificata. Non abbiamo trasformato un'etichetta non verificata in un successo né usato l'invio manuale come prova di un cron funzionante. Verifica consegna reale e pianificazione nel tuo hosting prima di farvi affidamento.

Prima di invitare visitatori reali verifica sito, testi, permessi e disponibilità. Prova messaggio del visitatore, risposta dell'operatore, seguito, distinzione tra letto e in attesa e chiusura. Se usi ricezione offline, verifica l'email obbligatoria in una nuova conversazione e la ricezione di un vero avviso di prova da parte del destinatario previsto.

Mantieni accurati i testi di disponibilità, assegna agli operatori una procedura per la coda e spiega dove apparirà la risposta. Parti dal riferimento Live Chat per impostazioni e API, o da Ruoli e permessi per delegare l'accesso senza dare a tutti i diritti di configurazione.