唯一客服 — 私有化在线客服系统
原生 Golang 架构，完整源码交付，一次购买永久使用。
数据本地存储，不经过第三方 — 用得起、用得放心、用得自由。
为什么选择唯一客服源码产品？
编译版与全源码版共享的六项核心竞争力
私有化部署，数据自主可控
整套系统部署在你自己的服务器上，聊天记录、客户信息、业务数据全部本地存储，不经过任何第三方中转。没有云端泄密风险，满足企业数据合规与安全审计要求。
原生 Golang 架构，高并发低占用
服务端采用 Go 语言编写，编译为单一二进制文件，内存占用低至几十 MB。单台 1 核 2G 云服务器即可稳定承载上千并发会话，性能远超传统 PHP/Java 客服系统。
源码开放，支持深度定制
全源码版提供前后端全部源代码，无加密、无混淆、不依赖远程服务。你可自由修改界面、新增业务模块、对接内部系统，让产品与业务深度适配，真正做到产权自主。
全终端同步，PC 与移动端一致体验
访客端自适应 PC、平板、手机浏览器；客服端支持 PC 网页 + 手机 H5 双端接待。消息实时同步，切换设备不丢记录，客服随时随地回复。
灵活授权，一次付费长期使用
两种方案均无月租、无年费。相比 SaaS 模式，长期使用成本降低 80% 以上。
简易部署，宝塔面板可视化操作
上传解压 → 配置数据库 → ./kefu install 初始化 → ./kefu server -d 后台运行，几条命令即可完成。配合宝塔面板或 Nginx 反向代理，全程图形化操作，不熟悉 Linux 也能在 30 分钟内上线。
系统界面一览
先看整体，再看细节 — 后台管理界面全景展示
核心功能全景展示
四大功能板块逐项拆解 — 场景说明 + 实景截图，一目了然
多坐席智能分配与管理
注册即享多商家多坐席 SaaS 架构，智能分配 + 角色权限，团队协作井然有序
账号注册与登录
降低注册门槛，无需记忆密码即可使用，提升转化。账号默认需管理员审核开通，防止违规。
Register · Scan Login
在线充值
线上注册账号不区分主账号和子账号，可直接在后台主页选择充值时间，微信扫码支付。无需联系商务即可自助开通和续费，降低采购流程摩擦。
多商家多坐席的分配原则
系统本身是多商家多坐席 SaaS 架构，每个商家独立隔离，子账号坐席之间自动分配，超管可管理所有用户。
聊天链接中的 kefu_id 可指定优先分配账号；未指定时按当前接待数优先分配给负载最少的坐席；下次来访优先分配给上次接待的客服；所有坐席离线时自动分配给主账号。用无痕浏览器分别登录各子账号即可验证效果。熟客分配确保回头客由熟悉客服接待，减少重复沟通。
角色与权限：支持超级管理员、管理员、普通客服多级角色。同一后台，不同角色看到的内容不同，保证数据安全同时不影响操作效率。支持通过邮箱验证码重置密码，新密码自动发送至邮箱。
消息通知与多渠道接待
微信公众号实时推送 + 企业微信机器人通知 + 手机 H5 免密回复，永不漏读消息
微信扫码绑定公众号通知
后台主页面板展示微信二维码，扫码关注公众号即可将客服账号与公众号绑定，通过公众号模板消息收取访客消息提醒。
公众号生成带参二维码，存储当前登录的客服账号。扫码关注时，客服账号与微信 OpenID 绑定，访客消息通过 OpenID 精准推送到指定微信。
客服离开电脑也能实时收到新消息提醒，不会漏单。
WeChat Official Account · Notification
企业微信内部群机器人通知
在企业微信中创建内部群机器人，获取 webhook URL 接口地址，配置在客服系统内：「菜单」→「团队设置」→「微信客服」→「企业微信应用」→「企业微信群新消息通知机器人 webhook」。配置后，新消息实时推送至企业微信群。团队可以在企业微信群中同步看到客服消息动态，适合多人协作场景下的消息分发与监督。
手机端 H5 接待 — 免密登录回复
客服不方便 PC 接待时，可后台扫码关注公众号。有新消息时，公众号推送模板消息，点击通知卡片即可免密登录 H5 客服端直接回复。也可配置企业微信机器人 webhook 收取消息提醒，点击同样免密登录 H5 回复。H5 端也可直接访问 https://域名/h5/。
随时随地在手机上回复访客，无需专门开发手机 APP。不开发 APP 的原因：消息推送需对接各大手机厂商推送通道，个人开发的 APP 接不了。PC 网页 + 浏览器通知 + 公众号通知 + 企业微信 bot 的多通道组合已完全覆盖所有消息触达场景。
发送消息类型
系统支持多种消息类型：文本、表情、图片、文件、录音、地理位置等，满足丰富的沟通场景。文件类型消息会展示后缀图标、文件名称和大小，点击可下载，手机端通过浏览器同样支持文件上传。MP4 格式视频文件上传后可直接在线播放，适合产品演示场景。
消息能力与智能回复
不止是发文字 — 图文、表情、文件、自动回复，构建丰富的沟通体验
图文 / 表情 / 文件发送
客服端支持发送图片、表情、文件附件（限定格式与大小），访客端同样可以上传图片与文件。纯文字沟通信息密度太低，售后场景中用户截图比文字描述更直观。支持文件传输后，商务场景可直接发送报价单、合同等文档，沟通即闭环。
Image · Emoji · File
聊天记录永久保存与检索
所有会话记录完整存储在本地数据库，支持按关键词、时间区间、坐席、访客等条件多维度检索。服务质量回溯、纠纷取证、客服绩效考核，全部依赖完整可信的聊天记录。所有数据在自己服务器上，不需要向第三方申请导出，也不需要担心云服务商清理历史数据。
关键词自动回复
配置关键词与对应回复规则，当访客消息命中关键词时系统自动回复。支持完全匹配与模糊匹配两种模式。大量标准化问题（如"地址在哪""客服电话多少""支持什么快递"）可以用机器人直接回答，减少人工介入次数。关键词库持续积累后，自动回复覆盖率可达 40% 以上。
Keyword Match · Auto Reply
灵活对接与开放能力
可嵌入任意网站，提供 API 接口，轻松融入你的技术生态
一行 JS 嵌入网站
在网页中插入一段 JavaScript 代码，即可在页面右下角加载客服聊天窗口。支持自定义窗口颜色、位置、LOGO 等视觉元素。无需复杂的插件安装或框架适配，任何 HTML 网站（包括 WordPress、自研 CMS、单页应用）都能在 5 分钟内接入。
One-line JS Embed
商城订单对接
商城会员跳转到聊天链接时，会员唯一标识作为 visitor_id 带入客服系统。客服在聊天面板右侧，通过 iframe 嵌入自己独立开发的订单列表页面 URL。订单页面从传入的 visitor_id 获取会员标识，查询并展示该会员的订单记录，客服无需切换系统即可掌握订单上下文。
产品 / 订单卡片推送
客服和访客均可发送结构化 JSON 卡片消息，系统自动渲染为包含图片、名称、价格、链接等信息的卡片展示。比纯文字描述更直观，点击即可跳转查看详情或下单，缩短沟通到成交的路径。
企业微信 / 公众号对接
支持对接企业微信客服、微信公众号、微信小程序客服等微信生态产品。如果你的客户主要在微信端，客服系统可与微信渠道打通，客服在一个后台统一接待来自网站、公众号、小程序的所有咨询，无需多平台切换。
AI 大模型对接
原生支持对接 Coze、Dify、FastGPT 等主流 AI 工作流平台，可接入企业私有知识库与大模型。让机器人先接待常见问题，人工客服只处理复杂场景。AI 辅助坐席在回复时自动推荐话术，显著提升效率。支持私有模型部署，确保企业数据不出域。
AI Model · Coze / Dify / FastGPT
系统概述与接入指南
了解系统定位，快速掌握各渠道接入方式
1 唯一客服系统是什么
为网站或 APP 提供在线即时聊天功能，让客户与客服人员实时沟通。目标用户为中小互联网科技公司，拥有自研产品（会员系统、商城等），希望嵌入在线客服，实现类似电商平台的咨询体验。
微信生态对接
- 企业微信客服（非个人微信号）
- 企业微信应用、微信公众号
- 微信小程序客服等有 API 的微信产品
技术优势
独立私有化部署，服务端编译为二进制程序包，运行速度极快，搭建比同类型 PHP/Java 客服系统简单得多。
多商家 SaaS
每个商家独立隔离，子账号坐席自动分配。同一后台，角色不同看到的界面不同，超管可管理所有用户。
2 体验接入使用
网页链接接入
前往「部署」→「团队设置」→「网站接入」→「普通模式」，获取聊天链接，直接放入网站任意位置即可。还提供根据该链接生成的二维码，可截图分发。注意：尽量不要在主域名下向微信大量分发，避免域名被腾讯封禁。
URL 传递访客参数
可通过 URL 参数传入会员信息：visitor_id 自定义会员 ID、visitor_name 自定义会员名称、avator 自定义头像。语言参数 lang=en（cn 中文 / en 英文 / tw 繁体），默认自动跟随浏览器语言。
JS 弹窗接入
前往「部署」→「团队设置」→「网站接入」→「弹窗模式」，复制 JS 代码粘贴到网页任意位置，即可在右下角出现客服弹窗，无需跳转页面。
JS 核心参数
KEFU_URL：网站 URL 地址KEFU_KEFU_ID：客服账号用户名KEFU_ENT：客服商户 IDKEFU_LANG：cn 中文 / en 英文KEFU_SHOW_TYPES：0=隐藏 / 1=右下角 / 2=圆形 iconKEFU_AUTO_OPEN：true 自动弹出VISITOR_ID / VISITOR_NAME / VISITOR_AVATOR：访客信息
自定义客服图标
设置 KEFU_SHOW_TYPES: 0 隐藏默认图标，自行开发按钮，添加点击事件 KEFU.showPanel() 打开聊天窗口。如用 iframe 嵌入聊天链接，需添加参数 &show_title=yes 才会展示头部。
APP 接入
移动端网页可直接跳转聊天链接，聊天界面基于响应式设计，表现良好。移动端 APP 可使用 WebView 组件嵌入聊天链接，也可跳转默认浏览器打开。
单独部署聊天页面
如无自有网站，仅需客户扫码聊天，可将聊天页面部署到自有域名下使用。注意：涉及大量营销内容的域名易被微信封禁，请勿将主域名大量分发至微信或 QQ。系统禁止任何违法业务，一经发现立即关停。
API 接入
在自行开发程序时，如需使用客服系统的关键词回复、AI 回复，或想将访客与自己系统用户对接，可调用 API 接口实现。在后台「API 接入」中查看自己的 API 调用参数。
交付方案与部署
两种交付模式，按需选择 — 无论是预算敏感还是深度定制，都有合适方案
编译版·域名授权
- 编译后的服务端二进制文件（Go 编译产物）
- 完整前端源码（可自行修改界面样式）
- 本地授权文件验证，不经过远程服务，完全私有化独立部署
- 绑定指定域名，换域名需重新授权
- 功能与全源码版完全相同，无阉割
- 适用场景：单一站点 / 不需要二次开发业务逻辑 / 预算有限的中小企业
授权费更低 · 性价比之选
全源码交付
- Go 服务端 + 前端全部源代码，无保留
- 无加密、无混淆、无远程授权依赖
- 不限制域名、不限制部署数量
- 支持自由修改、二次分发、深度集成
- 适用场景：多站点运营 / 需要定制功能模块 / 对外商用 / 有自研团队的企业
产权买断 · 无任何限制
技术架构与二次开发
全源码交付用户可以自由定制 — 架构简明，半天即可上手修改
系统架构
Golang Gin 框架 + MySQL + ElementUI 前端
Go 是 Google 开发的编译型语言，天生支持高并发。编译产物为单一二进制文件，无需安装运行环境，内存占用极低。编译版用户可自由修改前端 ElementUI 界面；全源码版用户可深入 Go 后端，实现任意业务逻辑定制。
极简 MVC，无绕圈设计
项目刻意避开了复杂设计模式与臃肿的分层架构，沿用最经典的 MVC 结构：
后端：路由定义 → 控制器处理逻辑调用 model 层，结构清晰直白。
前端：路由定义 → 控制器渲染页面，ElementUI 组件拼装界面。
没有黑魔法、没有过度抽象，有经验的开发者半天就能理清全项目结构并开始修改。
前端修改指引 — 传统模板直改，无需 Node 编译
前端采用传统开发模式，不是 Node 编译后部署的形式，没有独立的前端项目。所有页面由 Gin 后端渲染 HTML 模板，打开模板文件即可直接修改。
页面路由原理
Gin 框架在路由处理中加载模板页面，所有前端路由逻辑集中在 ./router/view.go。例如访问 /douyin.html，对应代码：
engine.GET("/douyin.html", func(c *gin.Context) {
c.HTML(http.StatusOK, "douyin.html", gin.H{})
})
页面模板文件统一存放在 ./static/templates/ 目录下。
修改访客聊天页
聊天页面模板位于 ./static/templates/default/chat_page.html，想要删除或隐藏工具栏按钮，直接找到对应元素删除即可。
如果找不到元素位置，在 ./static/templates/ 下全局搜索页面中不可变的字符串（如 class 属性名），即可快速定位目标代码。
通用部署流程
无需编写代码，宝塔面板可视化操作 + 几条终端命令，半小时内完成部署
宝塔新建站点
进入宝塔面板创建新站点与数据库，只需 Nginx 域名绑定功能，无需关心 PHP 版本。
上传解压赋权
通过宝塔文件管理，上传完整包并解压到站点目录，全部文件 chmod 777。
配置数据库
编辑 config/mysql.json，填入创建的数据库名、用户名与密码。
初始化数据库
终端切到站点目录，执行 ./kefu install 自动建表，Windows 下用 kefu.exe install。
启动服务
./kefu server -d 以守护进程启动，默认监听 8081 端口。-p 可指定端口。
开放端口
宝塔安全页 + 云服务器安全组开放 8081 端口，访问 http://公网IP:8081/main 验证。
配置 Nginx 反代
宝塔站点设置 → 伪静态，粘贴反代规则。支持 WebSocket，无需另配反向代理。
开启 HTTPS
宝塔 SSL → Let's Encrypt 一键申请免费证书。配置完成后即可通过 https://域名 访问。
Complete Documentation Included