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

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

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) │
                                          └─────────────┘

Зв'язок у реальному часі

Використовує події, надіслані сервером (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'});

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

Підтримує діапазони "Сьогодні", "7/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 мов)
• Система управління ботами
• Ланцюг ескалації бездіяльності
• Розклад свят
• Привертає увагу віджет

В4

• Панель контексту розмови
• Готові відповіді з пошуком
• Підтримка обміну файлами
• Управління чергою
• Система зворотного дзвінка

В3

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

В2

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

Версія 1

• Базові функції чату
• Відстеження відвідувачів
• Інтерфейс відповіді адміністратора