LiveChat 管理员 — WeSellMachines（演示）

在线聊天系统概述

128

方法

AJAX 操作

数据库表

管理员标签页

语言

版本

主要特点

实时监控
由 SSE 提供支持的实时访客跟踪

自动翻译
35种语言的双向

机器人检测
基于模式 + 启发式

自动触发器
页面感知消息规则

深度分析
5份报告+热力图

IP/封禁系统
限时封禁 + IP封禁

文件结构

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）来实现会话连续性。

数据库模式（12 个表）

在线聊天访客

ID、会话 ID、姓名、电子邮件、公司、电话、IP 地址、国家/地区、城市、设备、浏览器、操作系统、屏幕、语言、来源页面、UTM 来源、UTM 媒介、首次访问时间、最后访问时间、是否为机器人、机器人评分、备注、标签

在线聊天消息

id、visitor_id、sender_type、sender_id、message、translated_message、original_lang、target_lang、attachment、read_at、created_at

在线聊天规则

id、名称、页面类型、URL模式、最小页面数、延迟、最大触发次数、冷却时间、仅返回、优先级、消息、激活状态、创建时间

在线聊天页面浏览量

id、visitor_id、url、title、page_type、referrer、duration、created_at

在线聊天活动

id、visitor_id、event_type、event_data、page_url、created_at

在线聊天预设回复

ID、快捷方式、标题、消息、类别、使用次数、创建时间

在线聊天设置

id、设置键、设置值、更新时间

在线聊天队列

id、visitor_id、department、priority、status、assigned_to、created_at

在线聊天回调

id、visitor_id、phone、preferred_time、department、notes、status、created_at

在线聊天通知

id、admin_id、type、title、message、read、data、created_at

livechat_admin_profiles

id、admin_id、display_name、role、avatar_color、greeting、signature、available、settings

livechat_ip_bans

id、ip地址、原因、持续时间、被封禁者、过期时间、创建时间

类方法（128）

AJAX API（55 个操作）

面向控件的操作（18）

行动	方法	描述
`init_chat`	邮政	初始化访客会话
`send_message`	邮政	发送访客留言
`get_messages`	得到	获取对话历史记录
`track_page`	邮政	跟踪页面浏览量
`typing_status`	邮政	更新输入指示器
`upload_file`	邮政	上传文件附件
`request_callback`	邮政	提交回调请求
`rate_chat`	邮政	提交客户满意度评分
`check_online`	得到	查看代理商是否在线

管理员操作（37）

行动	方法	描述
`admin_get_conversations`	得到	列出所有对话
`admin_get_messages`	得到	获取对话消息
`admin_send_reply`	邮政	发送管理员消息
`admin_get_live_visitors`	得到	吸引活跃访客
`admin_advanced_analytics`	得到	完整分析数据
`admin_get_rules`	得到	列表触发规则
`admin_save_rule`	邮政	创建/更新规则
`admin_toggle_rule`	邮政	启用/禁用规则
`admin_ban_visitor`	邮政	禁止访客
`admin_get_settings`	得到	获取系统设置
`admin_save_setting`	邮政	更新设置
`admin_manage_bot`	邮政	标记为/取消标记为机器人

小部件集成

集成代码

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

管理员标签页和功能

1. 控制面板
实时统计数据、趋势图表、设备、转化漏斗、引荐来源、页面

2. 实时访客
实时追踪、隐藏机器人、筛选/排序、屏蔽、标记机器人

3. 对话
分屏显示、翻译、上下文面板、文件上传、预设、禁止

4. 排队
优先级队列、分配、解决、部门路由

5. 回调函数
电话回电、首选时间、状态管理

6. 所有访客
历史数据、搜索、筛选、排序、分页、个人资料模态框

7. 分析
5个子标签页、热图、漏斗图、客户满意度、主题、内容分析

8. 自动触发器
规则 CRUD、页面定位、延迟、冷却时间、模板

9. 设置
个人资料、罐头、系统、翻译、机器人管理

10. 指南和文档
架构、数据库模式、方法、API、变更日志

分析指南

日期范围

支持今日、7天/30天/90天三种时间段。所有数据均在服务器端聚合并缓存。

子标签

概述： 6 项关键绩效指标、趋势线、小时柱状图、渠道、质量、推荐来源、转化漏斗、新用户/回访用户、聊天指标
对话： 未接聊天提醒、响应时间分布、持续时间、客户满意度趋势、聊天来源、消息主题
访客： 设备类型、语言、国家/地区、高峰时段热力图（7×24 网格）
表现： 浏览器、操作系统、屏幕分辨率（附柱状图）
内容： 页面类型、入口/出口页面、聊天生成页面、带排序/筛选/搜索功能的完整页面表格

数据筛选器

默认情况下排除机器人流量。内部 IP 地址可在设置中配置。所有图表均使用 Chart.js 和响应式画布。

安装指南

上传文件 到 modules/livechat/
配置 config.php 使用数据库凭据
运行设置 — 首次加载时自动创建表
添加小部件 - 包括 livechat.js 在您的模板中
配置 SSE — 确保服务器支持 EventSource
测试打开管理面板并验证连接

配置

config.php 设置

钥匙	默认	描述
`DB_HOST`	本地主机	数据库主机
`DB_NAME`	—	数据库名称
`SSE_INTERVAL`	3	SSE推送间隔（秒）
`MAX_IDLE_TIME`	300	访客空闲超时时间（秒）
`TYPING_TIMEOUT`	5	输入指示器超时
`TRANSLATION_API`	谷歌	翻译服务提供商
`MAX_FILE_SIZE`	10	最大上传文件大小（MB）

更新日志

V5 — 当前版本

高级分析功能，包含 5 个子标签页和热图
实时翻译（35种语言）
机器人管理系统
不活跃升级链
节假日安排
吸睛小部件

V4

对话上下文面板
搜索的罐头回复
文件共享支持
队列管理
回调系统

V3

自动触发规则引擎
访客概况及时间线
高级封禁系统（IP + 时间）
管理员个人资料及头像

V2

SSE实时更新
桌面通知
声音警报
类型指示器

V1

基本聊天功能
访客追踪
管理员回复界面

在线聊天

仪表板

在线访客

对话

—

—

接触

设备与技术

订婚

时间线

笔记

标签

行动

队列

回调函数

所有访客

分析

自动触发规则

设置

约翰·多伊

罐头回复

实时翻译

消息检测

双向

已缓存

测试翻译