全开源 PHP+Vue 在线客服平台源码下载 | 支持 WSS 实时通讯与多项目独立运营-猫源码

PHP +VUE
# 服务器最低配置要求

## 最低环境

– Linux 服务器，推荐 Ubuntu 22.04、Debian 12 或宝塔 Linux。
– 1 个公网 IPv4 地址，域名 `A` 记录指向服务器。
– 1 核 CPU。
– 2 GB RAM。
– 至少 10 GB 可用磁盘空间；上传文件较多时需要额外空间。
– PHP 8.2 或更高版本，并启用：`pdo_mysql`、`openssl`、`curl`、`mbstring`、`json`、`session`、`redis`、`fileinfo`。
– MySQL 8.0 或兼容版本，数据库账号需要建表、改表、索引和读写权限。
– Redis 6 或更高版本。
– Node.js 20.19+ 或 22.12+，仅在服务器上重新构建前端时需要。

## 必须运行的服务

– Nginx 或 Apache，网站根目录指向项目的 `public/`。
– PHP-FPM 8.2+。
– MySQL。
– Redis。
– 项目的队列 Worker 和 WSS 实时服务。

## 网络端口

– 对外开放 `80` 端口；HTTPS 可由 Cloudflare 代理提供。
– Redis、MySQL 和 WSS 内部端口不应直接暴露公网。
– WSS 默认监听服务器本机回环地址，由 Nginx 反向代理 WebSocket 请求。

# 客服系统端口配置

本项目使用 Cloudflare 代理公网 HTTPS/WSS，公网证书由 Cloudflare 管理。项目不配置或检查 SSL，源站只接收 HTTP 80 回源。以下规则同时适用于云服务器安全组和宝塔防火墙。
## 一、产品概述

本系统是一套支持独立部署、多商户运营和多语言服务的在线客服平台，包含平台运营后台、商户管理后台、客服工作台、访客客服组件、帮助中心和官网展示端。

系统适用于跨境电商、独立站、在线服务、会员平台、SaaS 平台等需要实时在线咨询、客户管理、知识库、AI 辅助和运营管理的业务场景。

主要特点：

– 支持平台管理员、商户管理员、客服坐席和访客四类使用角色。
– 支持多个商户、项目和客服团队独立运营。
– 支持网页客服组件、移动端 H5 客服页面和帮助中心。
– 支持实时消息、人工接待、AI 辅助、自动翻译和浏览器通知。
– 支持知识库、咨询流程、客户资料、运营公告和风险控制。
– 支持本地存储与 Cloudflare R2 对象存储。
– 支持独立域名、独立数据库和私有化部署。

## 二、角色与使用入口

不同角色使用独立登录入口和权限边界，商户之间的数据相互隔离。

## 三、实时客服工作台

### 1. 会话接待

– 实时接收访客消息和会话状态变化。
– 按待接入、人工处理中、AI 处理中、已解决等状态筛选会话。
– 支持客服主动接管、转接、结束和重新查看会话。
– 支持按项目切换工作区，并显示各项目未读数量。
– 支持消息已读、未读计数和历史消息同步。
– 网络中断或页面恢复后自动重新同步会话状态。

### 2. 消息处理

– 支持文本、图片和附件消息。
– 支持消息撤回及实时同步。
– 支持快捷回复和知识内容辅助回复。
– 回复失败时保留尚未发送的文字和附件，便于重新提交。
– 支持新消息声音提醒和浏览器 Push 通知。

### 3. 客户协作

– 在工作台查看客户资料、会话记录和业务上下文。
– 支持客户标签、内部备注和跟进信息。
– 支持客服分组和指定分组转人工。
– 支持客服在线状态、接待状态和权限配置。

## 四、访客客服组件

### 1. 网站接入

– 每个项目拥有独立的客服组件地址和接入标识。
– 支持通过 JavaScript 将客服入口嵌入业务网站。
– 支持独立 H5 客服页面，适配桌面端和移动端访问。
– 支持配置品牌名称、主题颜色、入口位置和入口文案。

### 2. 访客体验

– 支持发起新咨询和继续历史会话。
– 支持查看帮助中心及知识文章。
– 支持发送文字、图片和附件。
– 支持咨询选项、资料收集和转人工流程。
– 支持访客端新消息提醒与浏览器 Push。
– 会话凭据采用受控方式保存，避免敏感凭据进入普通 URL 查询参数。

## 五、项目与渠道管理

– 一个商户可创建和管理多个客服项目。
– 每个项目可独立设置名称、语言、品牌、客服入口和运行状态。
– 支持项目密钥及接入参数管理。
– 支持访客身份和客户资料对接。
– 支持签名请求、时间戳和随机数校验，降低伪造与重放风险。
– 支持项目级客服分配、知识内容、咨询流程和 AI 策略。

## 六、客服与权限管理

– 创建、编辑、启用或停用客服账号。
– 支持客服角色、分组和项目授权。
– 支持为新客服生成一次性登录凭据。
– 支持平台、商户和客服独立登录入口。
– 支持安全的后台身份切换与授权交接。
– 高权限操作保留审计记录。

## 七、客户关系管理

– 统一管理客户基本资料和来源信息。
– 查看客户关联项目、会话和历史沟通记录。
– 支持客户标签、备注及业务资料字段。
– 支持外部系统提交或更新客户资料。
– 数据查询严格限制在当前商户和项目范围内。

## 八、AI 客服能力

– 支持按项目配置 AI 服务与回复策略。
– 支持 AI 自动参与咨询，并按规则转接人工客服。
– AI 可结合知识库内容生成回复。
– 记录 AI 调用状态、回答来源和处理结果，便于人工复核。
– AI 消息和后台任务采用一致的持久化流程，降低任务丢失或重复执行风险。
– 支持在作用域失效、项目停用或会话结束时停止无效调用。

AI 模型及接口凭据由部署方安装后自行配置，出售包不包含第三方 AI 账号或额度。

## 九、知识库与帮助中心

– 支持知识文章和快捷问答管理。
– 支持按项目、行业和语言组织知识内容。
– 支持导入行业基础知识，并保留商户自行编辑的内容。
– 内置覆盖 20 个行业的基础知识结构。
– 快捷问答可配置所需客户资料、内部备注和转接分组。
– 知识文章可直接展示在访客帮助中心。
– 支持多语言知识内容和内容去重。

## 十、咨询流程

– 支持创建结构化咨询流程和咨询选项。
– 可在会话开始阶段引导访客选择问题类型。
– 支持根据选项收集必要资料、添加内部备注或路由到指定客服组。
– 支持流程草稿、发布、归档和删除管理。
– 流程状态与会话状态联动，避免已失效流程继续产生新会话。

## 十一、多语言与翻译

– 系统包含 10 套语言目录，覆盖中文、英文及多种常用国际语言。
– 平台可统一控制允许使用的语言。
– 商户和项目可设置默认语言及启用语言。
– 支持访客、客服界面和知识内容的多语言展示。
– 支持消息、草稿和业务字段翻译。
– 翻译请求包含计费、失败重试和恢复处理机制。

翻译供应商账号、密钥和生产额度需由部署方自行配置。

## 十二、平台运营后台

### 1. 商户与套餐

– 创建、查看和管理商户。
– 管理商户状态、有效期和资源使用范围。
– 配置套餐、价格和服务权益。
– 支持平台代登录商户后台，并记录相关审计信息。

### 2. 支付、账务与推荐

– 管理支付订单和到账状态。
– 支持商户余额、消费记录和人工账务调整。
– 支持推荐关系、推广记录和返佣管理。
– 提供异常订单和风险状态的后台处理入口。

支付通道、链上网络或第三方账务服务需要在真实环境中单独配置和验收。

### 3. 平台内容与运营

– 管理全局知识内容和咨询流程模板。
– 发布系统通知和运营公告。
– 配置官网品牌、SEO、营销内容和账户策略。
– 支持平台语言和商户注册相关设置。

### 4. 存储与维护

– 支持本地文件存储。
– 支持配置 Cloudflare R2 对象存储及公开访问地址。
– 提供系统维护、运行状态和升级管理入口。
– R2 默认关闭，启用后由平台管理员填写自己的账号、密钥和存储桶信息。

## 十三、通知能力

– 支持站内通知和运营公告。
– 支持客服端浏览器 Push 通知。
– 支持访客端新消息 Push 通知。
– 支持通知订阅、取消订阅和失效订阅清理。
– 支持新消息声音提醒。

浏览器 Push 需要 HTTPS、Service Worker 和部署方自己的 VAPID 配置。

## 十四、安全与稳定性

– 平台、商户和项目级数据隔离。
– 登录、接口和高权限操作具有明确权限校验。
– 私有运行配置与公开 Web 目录分离。
– 数据库、Redis、字段加密和公开地址配置采用受控加载规则。
– 上传和公开媒体 URL 使用统一安全校验。
– 支持操作审计、风险管理和敏感操作记录。
– 队列与实时服务提供健康心跳和公开地址绑定校验。
– 支持主备 WSS、业务队列和 Push 队列进程。
– 发布包不包含数据库连接、密钥、Session、日志或历史上传数据。

## 十五、官网与品牌配置

– 内置官网展示端和法律页面入口。
– 支持配置平台品牌名称、站点标题、描述和 SEO 信息。
– 支持自定义商户项目品牌和客服组件样式。
– 出售版不绑定固定品牌或固定业务域名。

## 十六、部署方式

– 支持独立服务器私有化部署。
– 生产环境基于 Nginx、PHP 8.2、MySQL、Redis 和 Supervisor。
– 支持 Cloudflare 提供公网 HTTPS 和 WebSocket 代理。
– 首次安装通过 Web 安装页填写公开地址、数据库和平台管理员信息。
– 支持空数据库全新安装和已有系统的增量升级。
– 支持构建生产 ZIP、发布树校验和 SHA-256 文件校验。

详细部署流程参见 [部署.md](部署.md)，服务器要求参见 [配置要求.md](配置要求.md)。

## 十七、交付说明

出售版交付以下内容：

– PHP 后端、Vue 前端和已构建的生产静态资源。
– 数据库 Schema、初始化数据和 Web 安装器。
– Nginx、Supervisor、队列及 WSS 部署配置。
– 发布构建、环境检查和生产验证脚本。
– 默认关闭且不含凭据的 R2、AI、翻译、Push 和支付集成能力。

出售版不包含以下内容：

– 原系统数据库和业务数据。
– 原服务器的数据库、Redis 或字段加密配置。
– 登录 Session、日志和历史上传文件。
– R2 账号、密钥、存储桶配置或云端对象。
– AI、翻译、支付、邮件、Google、Cloudflare 等第三方账号与密钥。

友情提示

本站仅提供代码研究与学习交流，请在下载后24小时内删除，以避免任何潜在的法律风险。本站所提及的“运营”、“线上”等术语，仅代表代码完整度，严禁将本代码用于任何商业运营或对外开放。本站内容来源于互联网，仅供参考和学习使用，并非本站原创，版权归原作者所有。用户在使用本站内容时，必须遵守相关法律法规，任何未经授权的使用行为，均可能侵犯他人版权，用户应自行承担由此产生的所有法律责任。本站不对因使用本站内容而引起的任何直接或间接损失承担责任。

THE END