WebBlocks Live Chat

Gestisci sul tuo server conversazioni di assistenza tra visitatori e operatori del CMS. I visitatori aprono un componente di chat sul sito; gli operatori leggono e rispondono da Live Chat nel pannello del CMS. Non servono un account di chat esterno o un servizio WebSocket. Questa guida documenta Live Chat 0.7.1.

Usa PHP 8.4 o successivo e WebBlocks CMS ^1.95.1, che fornisce il runtime WebBlocks UI necessario. Scarica lo ZIP compatibile dalla pagina di Live Chat nel catalogo. Installalo in Sistema → Plugin, attivalo e verifica che la configurazione del database sia riuscita. Un'applicazione host meno recente può segnalare un avviso di salute del plugin; aggiorna l'host prima di usare questa versione.

Apri Live Chat → Impostazioni e seleziona il sito. Le impostazioni generali controllano attivazione, disponibilità online/offline, posizione sinistra/destra, obbligo di email offline e notifiche facoltative agli operatori. La disponibilità è scelta manualmente: non rileva la presenza di un operatore.

I testi per lingua hanno un modulo separato. Imposta titolo, messaggio di benvenuto, messaggio offline ed etichetta del pulsante di apertura per ogni lingua abilitata. Salvare le impostazioni generali conserva i testi; salvare i testi conserva le impostazioni generali. I testi mancanti usano prima la lingua predefinita, poi il testo precedente già presente.

Il componente abilitato si apre solo quando il visitatore preme il pulsante. Il visitatore fornisce nome ed email facoltativa; puoi richiedere l'email per le nuove conversazioni offline. La chiusura conserva la bozza non inviata. Dopo la chiusura di una conversazione, Avvia una nuova conversazione torna al modulo iniziale. Messaggi e risposte arrivano tramite interrogazioni periodiche.

Gli operatori necessitano di Visualizzare la chat dal vivo per leggere, Rispondere alla chat dal vivo per rispondere o chiudere e Gestire la chat dal vivo per configurare il componente. Il sito selezionato limita elenco e azioni disponibili.

Usa le viste aperte, in attesa di risposta, non lette e chiuse. La ricerca trova nomi, indirizzi email e cronologia dei messaggi. La vista aperta predefinita dà precedenza alle conversazioni in attesa; sono disponibili anche ordinamenti dal più recente o dal più vecchio. Non letta e in attesa di risposta sono condizioni diverse: leggere non equivale a rispondere.

Posta in arrivo e conversazione si aggiornano ogni cinque secondi quando visibili. Leggere in fondo a una conversazione visibile segna come letti i messaggi del visitatore. Se risali ai messaggi precedenti, i nuovi arrivi non spostano la posizione; Nuovi messaggi riporta agli ultimi. Invia una risposta, chiudi una conversazione risolta o riaprila se occorre aiuto. Riaprirla consente nuovamente le risposte del visitatore.

Gli operatori autorizzati ricevono anche indicatori di non lette nel menu laterale e avvisi nel pannello per i nuovi messaggi. Questi avvisi non segnano le conversazioni come lette e non inviano notifiche del sistema operativo.

Le notifiche offline agli operatori sono facoltative. Configura il destinatario e attivale solo se necessarie. Le email di risposta ai visitatori sono disabilitate: le risposte arrivano nel componente di chat.

Contenuto e frequenza ereditano la politica di notifica del sito CMS. Secondo la politica, l'invio può essere immediato, raggruppato o incluso in un riepilogo giornaliero. I messaggi di solo avviso omettono nomi, indirizzi, corpi dei messaggi e token privati delle conversazioni. I riepiloghi giornalieri contengono sempre informazioni minime.

Invii raggruppati/giornalieri e promemoria giornalieri richiedono lo scheduler Laravel dell'host ogni minuto. Controlla la salute registrata dello scheduler quando la posta resta in attesa. Le sole notifiche immediate senza promemoria giornalieri non richiedono invio pianificato. L'invio usa la configurazione email del CMS; la consegna al trasporto non dimostra l'arrivo nella casella del destinatario.

Il plugin attivo espone le proprie rotte tramite discovery API del CMS e OpenAPI. Usa GET /webadmin/api/plugins/webblocks-live-chat/settings?site_id=1 con live-chat.read. PATCH o PUT sulla stessa rotta richiedono live-chat.settings.write e una site_id esplicita.

Le scritture aggiornano solo i campi inviati e uniscono i valori per lingua ai testi esistenti. Sono accettate soltanto le lingue abilitate del sito. Continuano a valere le restrizioni del token e l'accesso delegato attuale. Consulta la politica delle capacità dei token del CMS installato: non presumere che l'attivazione del plugin conceda accesso.

Se manca il pulsante di apertura, controlla attivazione del plugin, sito selezionato, attivazione del componente e compatibilità dell'host. La modalità offline modifica i testi iniziali; l'attivazione del componente è separata. Se le risposte si interrompono, verifica che la conversazione non sia stata chiusa. Per email in attesa, controlla destinatario, posta del CMS, politica ereditata e salute dello scheduler.

Torna alla panoramica dei plugin, consulta la versione del catalogo oppure usa il riferimento dell'Internal Content API.