🎧 独立客服系统

0它是什么

这套客服系统是独立的：它有自己的域名、自己的数据库、自己的后台， 不属于任何一个网站，也不依赖任何一个网站的数据。

• 任何网站都能接：加一行 script 标签就行，不用改你网站的其它代码
• 它只做一件事：和访客对话。访客说什么，它就记什么
• 它唯一需要知道的：这个访客来自哪个网站（一个站点标识，如 danci）， 好让你在后台一眼看出人在哪
• 站点之间互不干扰：接 10 个网站，后台按站点区分，数据各归各的

1接入你的网站（只改一行）

把下面这一行放到任意网页的 </body> 之前，就接好了：

<!-- 客服挂件：一行接入，地址换成客服系统的域名 -->
<script src="https://客服域名/assets/widget.js"></script>

想让客服一眼认出是谁（推荐），在它前面再加一段，把网站里已有的信息传过去：

<!-- 放在上面那行之前 -->
<script>
  window.KF_CONFIG = {
    site:  'danci',          // 站点标识，每接一个网站换个名字
    name:  '张小明',         // 访客称呼（用你网站里已有的数据）
    sid:   'S1234',          // 编号 / 学号，可空
    grade: '七年级上册'       // 其它想带过去的信息，可空
  };
</script>
<script src="https://客服域名/assets/widget.js"></script>

2客服在后台接待

• 打开后台，输入管理密码登录
• 左边是所有来咨询的人（来自哪个网站 + 称呼 + 编号 + 最近一句话 + 未读数）
• 点一个人就能像微信一样一对一聊天
• 访客最后一句话会触发「可能的答案」推荐，点一下直接发出去

3话术库（自动推送）

在后台「📚 知识库」里维护文章，每篇填一组 关键词，并选一个「适用站点」：

• 通用（默认）：所有接入的网站都能收到这条
• 指定站点：只推给那个网站的访客，而且命中时优先级更高 —— 这样就实现「共用一套话术，个别网站单独定制」

访客消息命中关键词时：客户端自动收到最匹配的那篇；客服端右侧同步提示 「访客可能想问这些」，点一下就能发。想验证效果，用「🔍 测试匹配效果」输入一句话， 立刻看到命中哪几篇、各多少分、是通用还是专属。

4部署（宝塔面板）

推荐做成一个独立网站（比如 kefu.你的域名）：

• 宝塔 → 网站 → 添加站点，域名填 kefu.你的域名
• 把本目录的全部文件上传到那个站点的根目录
• 宝塔 → 数据库 → 添加数据库，库名 kefu（客服自己的库，不用和别的网站共用）
• 把库名 / 用户 / 密码填进 api/config.php，顺便改掉管理密码
• 导入建表 SQL：把 sql/kefu.sql 在 phpMyAdmin 里执行一次 （或者浏览器访问一次 https://kefu.你的域名/api/install.php）
• 建完表后把 install.php 改名或删除，防止被人反复访问
• 最后到各个网站加上那一行 script 就接好了