Característiques principals

Estructura de fitxers

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

Flux de sol·licituds

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

Comunicació en temps real

Utilitza esdeveniments enviats pel servidor (SSE) per a actualitzacions en directe. El tauler d'administració manté una connexió SSE persistent per a:

• Recompte de visitants en directe i actualitzacions d'estat
• Notificacions de nous missatges
• Canvis de cua
• Indicadors d'escriptura mitjançant un sondeig alternatiu

Autenticació

Autenticació d'administrador mitjançant autenticació PHP basada en sessió. El widget utilitza l'empremta digital dels visitants (hash del navegador + IP + galeta) per a la continuïtat de la sessió.

Accions orientades al widget (18)

Accions orientades a l'administrador (37)

Codi d'integració

<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>

Idiomes compatibles (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 de 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'});

Intervals de dates

Admet els intervals d'avui, 30/7/90 dies. Totes les dades agregades al costat del servidor amb emmagatzematge en memòria cau.

Subpestanyes

• Visió general: 6 KPI, línia de tendència, barres horàries, canals, qualitat, referents, embut, nous/recurrents, mètriques de xat
• Converses: Alerta de xats perduts, distribució del temps de resposta, durada, tendència de xats per a la conversa (CSAT), fonts del xat, temes dels missatges
• Visitants: Tipus de dispositius, idiomes, països, mapa de calor de les hores punta (quadrícula de 7×24)
• Rendiment: Navegadors, sistemes operatius, resolucions de pantalla amb gràfics de barres
• Contingut: Tipus de pàgina, pàgines d'entrada/sortida, pàgines generadores de xat, taula de pàgines completes amb ordenació/filtre/cerca

Filtres de dades

Trànsit de bot exclòs per defecte. Les IP internes es poden configurar a Configuració. Tots els gràfics utilitzen Chart.js amb un llenç responsiu.

1. Puja fitxers a modules/livechat/
2. Configura config.php amb credencials de base de dades
3. Executar la configuració — taules creades automàticament en la primera càrrega
4. Afegeix un widget — incloure livechat.js a la teva plantilla
5. Configura SSE — assegureu-vos que el servidor admeti EventSource
6. Prova — obriu el tauler d'administració i verifiqueu la connexió

Configuració del fitxer config.php

V5 — Actual

• Analítica avançada amb 5 subpestanyes i mapes de calor
• Traducció en temps real (35 idiomes)
• Sistema de gestió de bots
• Cadena d'escalada d'inactivitat
• Programació de vacances
• Widget que crida l'atenció

V4

• Panell contextual de conversa
• Respostes predefinides amb cerca
• Suport per compartir fitxers
• Gestió de cues
• Sistema de devolució de trucada

V3

• Motor de regles d'activació automàtica
• Perfil i cronologia del visitant
• Sistema de prohibició avançat (IP + temporitzat)
• Perfils d'administrador amb avatars

V2

• Actualitzacions en temps real de SSE
• Notificacions d'escriptori
• Alertes sonores
• Indicadors d'escriptura

V1

• Funcionalitat bàsica de xat
• Seguiment de visitants
• Interfície de resposta de l'administrador