# 优乐客服系统

**Repository Path**: youlesc/youlekefu

## Basic Information

- **Project Name**: 优乐客服系统
- **Description**: 企业级在线客服系统解决方案，一个现代化、高性能的在线客服系统，采用Go语言开发，支持私有化部署。多座席、多商户、多分组客服系统
- **Primary Language**: Go
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://youlekefu.cn
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-09-14
- **Last Updated**: 2025-09-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 客服, 在线客服, 客服系统, 聊天, 即时通讯

## README

# 在线客服系统 - 优乐客服系统
企业级在线客服系统解决方案，一个现代化、高性能的在线客服系统，采用Go语言开发，支持私有化部署。多座席、多商户、多分组客服系统！
<p>自定义菜单，排队功能，自动回复，发送图片、视频、office文件，客服消息撤回，引用回复，快捷回复，留言表单，多渠道接入，集成脚本，自定义外观样式，主动弹出聊天，自定义欢迎语，用户来源信息，聊天记录导出，客服会话分配、转接，客服绩效统计，服务评价，黑名单，企业微信推送，邮箱通知等</p>

[客服系统官网](https://youlekefu.cn/) · [官方文档](https://docs.youlekefu.cn/)

## 在线体验

[用户访问端](https://demo.youlekefu.cn/)


[客服管理端](https://demo.youlekefu.cn/admin) &nbsp; 账号：kefu 密码：123456


[超级管理端](https://demo.youlekefu.cn/super-admin)  &nbsp; 账号：admin 密码：123456


## 产品介绍
### 用户访问端
1. 自定义菜单点击发送，超链接点击
1. 发送文件，支持多种格式文件，如图片文件、视频、txt、excel、ppt、docx等
### 客服管理端
1. 客服间分配功能（实现转接）
1. 实时聊天，待回复强烈提醒标志，其他客服已分配和已回复标记
1. 快捷回复设置，设置自己的跨界回复语
1. 拉黑用户，分配给客服后可选择是否关闭自动回复
1. 用户来源详细信息查看，如来源域名、分组、设备信息等
### 超级管理端
1. 仪表盘：会话数与消息数统计；客服绩效统计，每个客服当日、昨日、本周、本月会话数与消息数统计，平均回复时间统计
1. 客服管理：添加/删除/编辑客服基本信息
1. 会话管理：客服消息数据查看，数据导出
1. 快捷回复管理：方便客服直接使用快捷回复语
1. 自动回复管理：预设关键词自动回复
1. 实时聊天：超级管理员可以以任何客服身份回复用户消息；可撤回用户消息和客服消息；引用回复功能；用户来源信息记录；备注用户信息；切换用户分组；分配指定客服
1. 网站分组功能：管理不同网站的分组配置，实现多站点客服系统；分组权限特别说明：
1. 系统设置：安全设置，访问验证，关键词屏蔽等
## 特色功能
1. 初次访问引导语
2. 多渠道接入
3. 客服系统自定义名称、系统公告设置
4. 排队人数显示设置
5. 安全访问验证
6. 文件上传配置，文件大小和格式
7. 商城下单设置、收款码配置
8. 快捷回复、自动回复
9. 转接功能
10. 新消息通知客服，邮箱、微信通知
11. 集成脚本，可自定义参数和外观样式
12. 消息撤回，引用功能
13. 自定义页面样式
14. 现代化UI设计

## 技术栈
- 后端：Go 语言
- 数据库：MySQL
- 部署：宝塔面板


## 安装教程
### 环境要求
- Nginx 1.28+ - Web服务器
- MySQL 5.7+ - 数据库服务
- Redis - 缓存服务（宝塔应用商店安装最新版）

### 下载并部署程序
```bash
# 创建项目目录（如果不存在）
mkdir -p /www/wwwroot/chat

# 进入刚刚创建的目录
cd /www/wwwroot/chat

# 下载并解压程序安装包
wget https://gitee.com/youlesc/youlekefu/releases/download/v1.3.0/v1.3.0.zip

# 解压程序文件到刚刚创建的目录
unzip -j v1.3.0.zip -d /www/wwwroot/chat
```
解压后会有多个安装脚本（在/www/wwwroot/chat目录下）

### 清理并执行安装脚本
```bash
# 进入安装目录
cd /www/wwwroot/chat

# 清理其他脚本，只保留download-linux.sh
rm -f download-windows.bat download-macos.sh

# 赋予执行权限
chmod +x download-linux.sh

# 执行程序
./download-linux.sh
```
脚本会自动检测系统架构、下载对应的程序安装包，自动解压到当前目录

### 配置Go项目
1. 点击「网站」菜单
1. 选择「Go项目」
1. 点击「添加项目」
1. 选择项目可执行程序：选择解压后的程序文件 customer-service
1. 端口填写 8180、勾选「放行端口」、勾选「开机启动」
1. 点击「确定」完成项目添加

### 配置数据库
#### 创建数据库
在宝塔面板「数据库」中创建新数据库
- 数据库名：chat（可自定义）
- 用户名：chat（可自定义）
- 密码：自定义强密码
#### 修改程序配置文件
```bash:line-numbers
cd /www/wwwroot/chat
vim config.yaml
```
更新数据库配置
```bash
database:
  host: "127.0.0.1"
  port: 3306
  user: "chat"
  password: "你的数据库密码"
  dbname: "chat"
```
### 启动服务
在宝塔面板的「Go项目」中找到刚添加的项目，点击「启动」按钮
### 访问系统
- 客户端访问：http://你的服务器IP:8180
- 客服后台：http://你的服务器IP:8180/admin
- 超级管理员后台：http://你的服务器IP:8180/super-admin
### 默认账号密码
#### 超级管理员账号
> 用于系统管理和配置
- 访问地址：/super-admin
- 用户名：admin
- 密码：123456
#### 客服账号
> 用于日常客服工作
- 访问地址：/admin
- 用户名：service
- 密码：123456

安全提醒：首次登录后请立即修改默认密码，确保系统安全！
### 配置域名访问（可选）
如果你有域名，宝塔面板提供了最简单的域名绑定方式：

1. 在宝塔面板「网站」→「Go项目」中，找到你的项目
1. 点击「设置」→「域名管理」，添加你的域名
1. 系统会自动配置反向代理，无需手动操作，SSL证书的话也可以一键申请

## 更新日志
### v2.0.0
- 更新时间：即将更新
- 更新内容：即将更新
### v1.3.0
- 更新时间：2025年8月31日
- 更新内容：
#### 新增功能
1. 新增自动回复网站分组功能，支持指定自动回复在特定网站分组内生效，提升回复精准性
1. 新增前台页面右上角图标自定义功能，可根据接入的客服头像自动匹配显示
1. 增加主页访问时自动弹出公告开关配置项，灵活控制公告展示时机
1. 新增前台智能助手名称与头像自定义配置项，支持品牌化个性化设置
1. 新增消息关键词屏蔽功能，增强内容安全管控能力
1. 新增客服会话分配功能，支持会话列表按分配状态筛选，优化会话流转效率
1. 新增客服分配后的系统提示信息，支持二次分配机制，提升问题解决效率与用户体验
1. 新增客服咨询排队人数显示功能，支持网站配置开关控制，帮助用户感知等待时长
1. 完善消息通知模块，新增邮件、Webhook、WxPusher 多渠道通知支持
1. 在用户信息区域新增快捷操作按钮，支持客服快速接入、转接、拉黑及结束会话等操作
1. 新增客服主动控制会话自动回复状态的开关，客服接入会话后可以一键关闭以避免消息冲突，可手动开启
#### 功能优化
1. 优化消息已读状态通知逻辑，解决重复通知问题，提升系统性能
1. 优化用户、客服及系统通知的默认头像样式，增强视觉识别度
1. 优化部分页面细节样式，修复一些小样式渲染问题等
1. 优化会话列表显示规则，去除无内容的空会话展示，提升列表浏览效率与整洁度​
1. 在超管后台新增详细时间显示功能，便于管理员精准追溯操作记录与系统事件​
#### 问题修复
1. 修复管理员修改密码后未自动退出登录的安全问题
1. 修复客服后台引用消息后无法取消引用状态的交互问题
1. 修复自动定时关闭会话功能异常的问题，保障会话管理稳定性
1. 修复客户前台刷新页面后无法正常获取客服头像和名称的显示问题
1. 修复客户前台可能出现多个事件重复触发接口请求的性能问题


## 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


## 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)