lckt-server/plugin/customerservice/README.md

70 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[## GVA 客服聊天功能[前端用户聊天基于gva-shop的uniapp端]
### 手动安装方法
1.解压zip获得customerservice文件夹
2.将 customerservice/web/plugin/customerservice 放置在web/plugin下
3.将 customerservice/server/plugin/customerservice 放置在server/plugin下
4.将 customerservice/uni 下的文件放到gva-shop商城插件下的uni里
5.在gva-shop的uni下的pages.json里新增
{
"path" : "pages/service/index",
"style" :
{
"navigationBarTitleText" : "客服"
}
}
#### 1. 前往GVA主程序下的initialize/router.go 在Routers 方法最末尾按照你需要的及安全模式添加本插件
PluginInit(PublicGroup, customerservice.CreateCustomerServicePlug())
到gva系统角色管理分配角色的api权限即可插件会自动注册api需要手动分配。
会自动生成如下表sys_service、sys_service_msg、sys_service_record、sys_service_reply、sys_service_script
### 2. 配置说明
#### 2-1 后台主要功能
客服管理、客服话术、客服自动回复配置等
#### 2-2 使用说明
1、在前端vue部分路由需要手动配置
web/src/router/index.js下新增如下配置
{
path: '/kefu/login',
name: 'ServiceLogin',
component: () => import('@/plugin/customerservice/view/login/index.vue'),
meta:{
client:true
}
},
{
path: '/kefu/main',
name: 'ServiceMain',
component: () => import('@/plugin/customerservice/view/chat/index.vue'),
meta:{
client:true
}
},
{
path: '/kefu/test',
name: 'ServiceUserTest',
component: () => import('@/plugin/customerservice/view/chat/test.vue'),
meta:{
client:true
}
},
2、后台使用方法
启动gva项目安装后在客服列表添加客服然后可以从客服列表的进入工作台进入客服聊天页或者打开客服登录页
http://localhost:8080/#/kefu/login进行登录
3、此插件涉及的图片上传使用了插件管理中《图库》插件可根据自己喜好进行替换
4、后台客服websocket连接的地方在插件view/chat/index.vue连接地址改成自己项目地址
客服websocket.value = new WebSocket(`ws://localhost:8888/service/serve_ws?token=${token.value}`)
5、用户websocket连接的地方在uni/pages/service/index.vue下连接地址改成自己项目地址websocket.value = new WebSocket(`ws://localhost:8888/service/ws?token=${token.value}`)
6、项目没进行过啥大的测试仅供参考学习
#### 2-3 参数说明
### 3. 方法API