Características principales

Estructura de archivos

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

Flujo de solicitud

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

Comunicación en tiempo real

Utiliza eventos enviados por el servidor (SSE) para actualizaciones en tiempo real. El panel de administración mantiene una conexión SSE persistente para:

• Recuento de visitantes en vivo y actualizaciones de estado
• Notificaciones de mensajes nuevos
• Cambios de cola
• Indicadores de escritura mediante sondeo de reserva

Autenticación

Autenticación de administrador mediante autenticación PHP basada en sesión. El widget utiliza la huella digital del visitante (hash del navegador + IP + cookie) para garantizar la continuidad de la sesión.

Acciones orientadas a widgets (18)

Acciones de cara al administrador (37)

Código de integración

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

Idiomas admitidos (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'});

Rangos de fechas

Compatible con rangos de 7, 30 y 90 días. Todos los datos se agregan en el servidor con almacenamiento en caché.

Subpestañas

• Descripción general: 6 KPI, línea de tendencia, barras horarias, canales, calidad, referentes, embudo, nuevos/recurrentes, métricas de chat
• Conversaciones: Alerta de chats perdidos, distribución del tiempo de respuesta, duración, tendencia de CSAT, orígenes de los chats, temas de los mensajes
• Visitantes: Mapa de calor de tipos de dispositivos, idiomas, países y horas pico (cuadrícula de 7×24)
• Actuación: Navegadores, sistemas operativos, resoluciones de pantalla con gráficos de barras
• Contenido: Tipos de páginas, páginas de entrada/salida, páginas generadoras de chat, tabla de páginas completa con ordenación/filtro/búsqueda

Filtros de datos

Tráfico de bots excluido por defecto. IP internas configurables en Ajustes. Todos los gráficos usan Chart.js con lienzo adaptable.

1. Subir archivos a modules/livechat/
2. Configurar config.php con credenciales de base de datos
3. Ejecutar configuración — tablas creadas automáticamente en la primera carga
4. Agregar widget - incluir livechat.js en tu plantilla
5. Configurar SSE — garantizar que el servidor admita EventSource
6. Prueba — abra el panel de administración y verifique la conexión

Configuración de config.php

V5 — Actual

• Análisis avanzado con 5 subpestañas y mapas de calor
• Traducción en tiempo real (35 idiomas)
• Sistema de gestión de bots
• Cadena de escalada de inactividad
• Programación de vacaciones
• Widget llamativo

V4

• Panel de contexto de conversación
• Respuestas predefinidas con búsqueda
• Soporte para compartir archivos
• Gestión de colas
• Sistema de devolución de llamada

V3

• Motor de reglas de activación automática
• Perfil y cronología del visitante
• Sistema de baneo avanzado (IP + temporizado)
• Perfiles de administrador con avatares

V2

• Actualizaciones de SSE en tiempo real
• Notificaciones de escritorio
• Alertas de sonido
• Indicadores de mecanografía

Versión 1

• Funcionalidad básica del chat
• Seguimiento de visitantes
• Interfaz de respuesta del administrador