主な特徴

ファイル構造

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

JavaScript API

// 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グリッド）
• パフォーマンス： ブラウザ、OS、画面解像度を棒グラフで表示
• コンテンツ： ページの種類、入口/出口ページ、チャット生成ページ、並べ替え/フィルター/検索機能付きフルページテーブル

データフィルター

ボットトラフィックはデフォルトで除外されます。内部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リアルタイムアップデート
• デスクトップ通知
• サウンドアラート
• 入力インジケーター

V1

• 基本的なチャット機能
• 訪問者追跡
• 管理者返信インターフェース