Caractéristiques principales

Structure des fichiers

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 requêtes

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

Communication en temps réel

Utilise les événements envoyés par le serveur (SSE) pour les mises à jour en temps réel. Le panneau d'administration maintient une connexion SSE permanente pour :

• Nombre de visiteurs et mises à jour en direct
• Notifications de nouveaux messages
• Changements de file d'attente
• Indicateurs de saisie via un système de repli par interrogation

Authentification

L'authentification de l'administrateur se fait via une authentification PHP basée sur les sessions. Le widget utilise l'empreinte numérique du visiteur (hash du navigateur + adresse IP + cookie) pour assurer la continuité de la session.

Actions liées au widget (18)

Actions destinées à l'administrateur (37)

Code d'intégration

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

Langues prises en charge (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'});

Plages de dates

Prise en charge des données d'aujourd'hui et des périodes de 7, 30 et 90 jours. Toutes les données sont agrégées côté serveur avec mise en cache.

Sous-onglets

• Aperçu: 6 indicateurs clés de performance (KPI), courbe de tendance, barres horaires, canaux, qualité, référents, entonnoir, nouveaux/anciens clients, statistiques de chat
• Conversations : Alertes de conversations manquées, répartition des temps de réponse, durée, tendance CSAT, sources des conversations, sujets des messages
• Visiteurs : Types d'appareils, langues, pays, carte thermique des heures de pointe (grille 7×24)
• Performance: Navigateurs, systèmes d'exploitation, résolutions d'écran avec graphiques à barres
• Contenu: Types de pages, pages d'entrée/sortie, pages de génération de chat, tableau pleine page avec tri/filtrage/recherche

Filtres de données

Le trafic des bots est exclu par défaut. Les adresses IP internes sont configurables dans les paramètres. Tous les graphiques utilisent Chart.js avec un canevas adaptatif.

1. Téléverser des fichiers à modules/livechat/
2. Configure config.php avec les identifiants de base de données
3. Exécuter la configuration — Tables créées automatiquement lors du premier chargement
4. Ajouter un widget - inclure livechat.js dans votre modèle
5. Configurer SSE — s'assurer que le serveur prend en charge EventSource
6. Test — Ouvrez le panneau d'administration et vérifiez la connexion

Paramètres config.php

V5 — Actuel

• Analyses avancées avec 5 sous-onglets et cartes thermiques
• Traduction en temps réel (35 langues)
• Système de gestion des bots
• chaîne d'escalade de l'inactivité
• Planification des vacances
• widget accrocheur

V4

• Panneau de contexte de conversation
• Réponses prédéfinies avec recherche
• Prise en charge du partage de fichiers
• Gestion des files d'attente
• Système de rappel

V3

• moteur de règles de déclenchement automatique
• Profil et chronologie du visiteur
• Système de bannissement avancé (IP + durée)
• Profils d'administrateur avec avatars

V2

• Mises à jour en temps réel SSE
• Notifications de bureau
• Alertes sonores
• Indicateurs de frappe

V1

• Fonctionnalités de chat de base
• Suivi des visiteurs
• Interface de réponse de l'administrateur