Основные характеристики

Структура файлов

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

Последовательность обработки запросов

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

Связь в режиме реального времени

Использует Server-Sent Events (SSE) для обновлений в режиме реального времени. Панель администратора поддерживает постоянное SSE-соединение для:

• Обновления в режиме реального времени: количество посетителей и статус посещения.
• Уведомления о новых сообщениях
• Изменения в очереди
• Индикаторы ввода с резервным вариантом опроса

Аутентификация

Аутентификация администратора осуществляется с помощью PHP-аутентификации на основе сессий. Виджет использует идентификацию по отпечатку посетителя (хеш браузера + IP-адрес + cookie) для обеспечения непрерывности сессии.

Действия, отображаемые на виджетах (18)

Действия, доступные администратору (37)

Интеграционный код

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

Поддерживаемые языки (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'});

Диапазоны дат

Поддерживаются диапазоны дней: сегодня, 30 июля, 90 дней. Все данные агрегируются на стороне сервера с использованием кэширования.

Вкладки

• Обзор: 6 KPI, линия тренда, почасовые столбцы, каналы, качество, источники переходов, воронка продаж, новые/возвращающиеся клиенты, метрики чата
• Разговоры: Оповещение о пропущенных чатах, распределение времени ответа, продолжительность, тенденция CSAT, источники чатов, темы сообщений.
• Посетители: Тепловая карта пиковых часов по типам устройств, языкам, странам (сетка 7×24)
• Производительность: Браузеры, операционные системы, разрешения экрана с гистограммами.
• Содержание: Типы страниц, страницы входа/выхода, страницы для генерации чата, таблица на всю страницу с сортировкой/фильтрацией/поиском.

Фильтры данных

По умолчанию трафик ботов исключен. Внутренние IP-адреса настраиваются в разделе «Настройки». Все диаграммы используют Chart.js с адаптивным холстом.

1. Загрузка файлов к modules/livechat/
2. Настройка config.php с учетными данными базы данных
3. Запуск настройки — таблицы создаются автоматически при первой загрузке
4. Добавить виджет - включать livechat.js в вашем шаблоне
5. Настройка SSE — убедиться, что сервер поддерживает EventSource
6. Тест — Откройте панель администратора и проверьте соединение.

Настройки config.php

V5 — Текущая версия

• Расширенная аналитика с 5 подвкладками и тепловыми картами.
• Перевод в реальном времени (35 языков)
• система управления ботами
• Цепочка эскалации бездействия
• Планирование отпусков
• Привлекательный виджет

V4

• Панель контекста разговора
• Шаблонные ответы с поиском
• Поддержка обмена файлами
• Управление очередями
• система обратного вызова

V3

• механизм правил автоматического запуска
• Профиль посетителя и хронология
• Усовершенствованная система блокировки (IP + временная блокировка)
• Административные профили с аватарами

V2

• Обновления SSE в режиме реального времени
• Уведомления на рабочем столе
• Звуковые оповещения
• Индикаторы ввода

В1

• Базовый функционал чата
• Отслеживание посетителей
• Интерфейс ответа администратора