# gofly客服-在线客服IM在线聊天系统

**Repository Path**: tuzichicao/go-fly

## Basic Information

- **Project Name**: gofly客服-在线客服IM在线聊天系统
- **Description**: golang 在线客服聊天即时通讯系统 ,网页客服 ,WEB IM 访客-客服即时通讯在线聊天  , 下载发行版压缩包,依赖安装很少 , 可以独立二进制部署 , js代码直接引入使用 /open source live
 customer chat by golang
- **Primary Language**: Go
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://gofly.v1kf.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 155
- **Created**: 2024-06-24
- **Last Updated**: 2025-04-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 项目简介

Golang语言客服系统，主要使用了gin + jwt-go + websocket + go.uuid + gorm + cobra + VueJS + ElementUI + MySQL等技术

### 还需要完成的工作


| 工作内容                                               | 作用                           |
| ------------------------------------------------------ | ------------------------------ |
| 前端做成前后端分离                                     | 现在不分离的情况下写法无法扩展 |
| 增加对话分配规则添加能根据域名或者用户名分配到指定代理 | 现在后端缺少对应的分配规则     |
| 团队管理                                               | 现在的角色权限太简单           |

### 安装使用

* 先安装和运行mysql数据库 ，版本>=5.5 ，创建数据库

```
 create database kefu charset utf8mb4;
```

* 配置数据库链接信息，在config目录mysql.json中

```php
{
	"Server":"127.0.0.1",
	"Port":"3306",
	"Database":"kefu",
	"Username":"root",
	"Password":""
}
```

* 安装配置Golang运行环境，请参照下面的命令去执行

```text
wget https://studygolang.com/dl/golang/go1.20.2.linux-amd64.tar.gz
tar -C /usr/local -xvf go1.20.2.linux-amd64.tar.gz
mv go1.20.2.linux-amd64.tar.gz /tmp
echo "PATH=\$PATH:/usr/local/go/bin" >> /etc/profile
echo "PATH=\$PATH:/usr/local/go/bin" >> ~/.bashrc
source /etc/profile
go version
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct
```

* 下载代码 进入go-fly 目录
* 导入数据库 go run go-fly.go install
* 调试运行 go run go-fly.go server
* 源码打包 go build -ldflags="-s -w" -tags="windows" -o kefu.exe  会生成kefu可以执行文件（注意配置linux的打包参数）
* 源码打包 go build -ldflags="-s -w"  -o kefu  会生成linux下的kefu可以执行文件
* 二进制文件运行

  linux:   ./kefu server [可选 -p 8082 -d]

  windows: kefu.exe server [可选 -p 8082 -d]
* 关闭程序

  killall kefu

程序正常运行后，监听端口8081，可以直接ip+端口8081访问

也可以配置域名访问，反向代理到8081端口，就能隐藏端口号

### 客服对接

聊天链接

http://127.0.0.1:8081/chatIndex?kefu_id=kefu2

弹窗使用

```
  <script >
	  (function(a, b, c, d) {
		  let h = b.getElementsByTagName('head')[0];let s = b.createElement('script');
		  s.type = 'text/javascript';s.src = c+"/static/js/kefu-front.js";s.onload = s.onreadystatechange = function () {
			  if (!this.readyState || this.readyState === "loaded" || this.readyState === "complete") d(c);
		  };h.appendChild(s);
	  })(window, document,"http://192.168.2.105:8081",function(u){
		  KEFU.init({
			  KEFU_URL:u,
			  KEFU_KEFU_ID: "",
			  VISITOR_EMAIL:"",
			  VISITOR_FIRST_NAME:"",
			  VISITOR_LAST_NAME:"",
		  })
	  });
  </script>

```

```text
1.仪表盘这个暂时省略2.客服对话收件箱只要这几个选项
    1.所有打开且未分配的对话
     2.所有打开和已分配的对话
     3.所有已经解决的对话
     4.我创建的所有主题
     5.我创建的所有对话
3.聊天页面省略
     1.常见问题预设答案
    2.发送日历
    3.右边搜索要能搜出客户的用户名
```

![示例图片](backend/doc/img.png)

```text
右边用户管理要能备注更改用户名
4.联系人拨号电话沟通省略
5.应答机器人功能省略
6.常见问题的预设回复中的文档编辑省略
7.客户旅程省略
```
```text
1.频道保留
  

2.配置和工作流程
1模版
  
2.工作流程
  
对话分配规则添加能根据域名或者用户名分配到指定代理  
3.生产率
 
3.自动服务和人工智能省略
4市场与整合
 
5.团队管理
 
6.数据和安全
 在加一个能阻止用户名功能
7.账户和账单省略

```

```text
如果出现nginx代理无法转发static下的图片，使用下面的命令处理一下
sudo chcon -R -t httpd_sys_content_t /path/to/your/directory
```