Caratteristiche principali

Struttura del file

modules/livechat/
├── LiveChat.php          (Main class - 128 methods)
├── admin-livechat.php    (Admin panel - this file)
├── livechat.tpl          (Widget template)
├── livechat.js           (Widget JS - visitor facing)
├── config.php            (Configuration)
└── assets/
    ├── notification.mp3
    └── widget.css

Flusso di richiesta

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  Widget JS   │────▶│  AJAX Handler │────▶│  LiveChat   │
│  (Browser)   │◀────│  (PHP)       │◀────│  Class      │
└─────────────┘     └──────────────┘     └──────┬──────┘
                                                 │
┌─────────────┐     ┌──────────────┐            │
│  Admin Panel │────▶│  SSE Stream  │◀───────────┘
│  (This page) │◀────│  (Real-time) │     ┌──────┴──────┐
└─────────────┘     └──────────────┘     │  Database    │
                                          │  (12 tables) │
                                          └─────────────┘

Comunicazione in tempo reale

Utilizza gli eventi inviati dal server (SSE) per gli aggiornamenti in tempo reale. Il pannello di amministrazione mantiene una connessione SSE persistente per:

• Conteggio visitatori in tempo reale e aggiornamenti sullo stato
• Notifiche di nuovi messaggi
• Modifiche alla coda
• Indicatori di digitazione tramite fallback di polling

Autenticazione

Autenticazione amministratore tramite autenticazione PHP basata sulla sessione. Il widget utilizza l'impronta digitale del visitatore (hash del browser + IP + cookie) per garantire la continuità della sessione.

Azioni rivolte ai widget (18)

Azioni rivolte all'amministratore (37)

Codice di integrazione

<script src="/modules/livechat/livechat.js"></script>
<script>
  WeSellMachines.LiveChat.init({
    position: 'bottom-right',
    primaryColor: '#3498db',
    greeting: 'Need help? Chat with us!',
    offlineMessage: 'We are offline. Leave a message!'
  });
</script>

Lingue supportate (35)

en, de, fr, es, it, nl, pl, pt, ja, zh, ko, ru, ar, tr, sv, no, fi, da, cs, hu, ro, bg, el, hr, sk, sl, lt, lv, et, uk, sr, he, th, vi, id

API JavaScript

// Open chat programmatically
WeSellMachines.LiveChat.open();

// Send automatic message  
WeSellMachines.LiveChat.sendMessage('How can I help?');

// Track custom event
WeSellMachines.LiveChat.trackEvent('viewed_listing', {id: 1234});

// Set visitor info
WeSellMachines.LiveChat.setVisitor({name: 'John', email: 'john@example.com'});

Intervalli di date

Supporta intervalli di giorni: Oggi, 7/30/90. Tutti i dati sono aggregati lato server con memorizzazione nella cache.

Sotto-schede

• Panoramica: 6 KPI, linea di tendenza, barre orarie, canali, qualità, referenti, funnel, nuovi/ritornanti, metriche di chat
• Conversazioni: Avviso di chat perse, distribuzione del tempo di risposta, durata, tendenza CSAT, fonti di chat, argomenti dei messaggi
• Visitatori: Tipi di dispositivi, lingue, paesi, mappa termica delle ore di punta (griglia 7×24)
• Prestazione: Browser, sistema operativo, risoluzioni dello schermo con grafici a barre
• Contenuto: Tipi di pagina, pagine di ingresso/uscita, pagine di generazione di chat, tabella a pagina intera con ordinamento/filtro/ricerca

Filtri dati

Traffico bot escluso per impostazione predefinita. IP interni configurabili nelle Impostazioni. Tutti i grafici utilizzano Chart.js con canvas reattivo.

1. Carica file A modules/livechat/
2. Configurare config.php con credenziali del database
3. Esegui l'installazione — tabelle create automaticamente al primo caricamento
4. Aggiungi widget — includere livechat.js nel tuo modello
5. Configurare SSE — assicurarsi che il server supporti EventSource
6. Test — apri il pannello di amministrazione e verifica la connessione

Impostazioni config.php

V5 — Corrente

• Analisi avanzate con 5 sotto-schede e mappe di calore
• Traduzione in tempo reale (35 lingue)
• Sistema di gestione dei bot
• Catena di escalation dell'inattività
• Pianificazione delle vacanze
• Widget accattivante

V4

• Pannello del contesto della conversazione
• Risposte predefinite con ricerca
• Supporto per la condivisione dei file
• Gestione delle code
• Sistema di richiamata

Versione 3

• Motore di regole di attivazione automatica
• Profilo e cronologia dei visitatori
• Sistema di ban avanzato (IP + temporizzato)
• Profili amministrativi con avatar

Versione 2

• Aggiornamenti in tempo reale SSE
• Notifiche desktop
• Avvisi sonori
• Indicatori di digitazione

Versione 1

• Funzionalità di chat di base
• Monitoraggio dei visitatori
• Interfaccia di risposta dell'amministratore