NB LiveChat

零依赖 Node 在线客服插件 — 访客网页悬浮窗发消息，客服后台网页实时回复
打开客服后台 访客演示页

1. 把这一行放到任意网页里

<script src="http://localhost:8787/widget.js" data-site-id="demo" async></script>

把 localhost:8787 换成服务器地址即可。多站点用 data-site-id 区分，各自可在 config.json 配标题/颜色/欢迎语。

2. 客服在后台回复

访问 /console，输入 config.json 里的 agentPassword 登录。左侧会话列表 → 选中 → 输入回复，访客端实时收到。支持未读计数、输入中提示、已读回执、快捷回复、桌面通知、结束/重开会话。

点左下角 设置齿轮 可以改：弹窗标题、副标题、欢迎语、客服名称、头像、主题色、访客快捷提问、客服快捷回复、自动弹出、上传开关。保存即生效，在线访客的窗口立刻变样，不用刷新。

访客快捷提问可以配固定回复：访客点一下，提问发出来的同时系统自动按你预设的内容作答，不用客服盯着。

两侧都能发图片和文件：回形针按钮、拖拽、或者直接粘贴截图。图片点击放大。

3. 接口一览

方法路径说明
GET/widget.js访客端加载器（跨域可用）
GET/embed聊天窗（iframe 内页）
GET/console客服后台
POST/api/session建立/恢复访客会话
GET/api/stream?role=visitor|agentSSE 实时下行
POST/api/send访客发消息（可带 attachment）
POST/api/upload上传图片 / 文件
POST/api/agent/send客服回复
GET/api/agent/conversations会话列表
GET/POST/api/agent/config读取 / 保存窗口设置
POST/api/agent/close结束/重开会话

JS 控制接口

window.LiveChat.open();          // 打开聊天窗
window.LiveChat.close();
window.LiveChat.identify({ id: 'user_123', name: '张三' });
window.LiveChat.on('unread', n => console.log(n));

// 页面加载前配置
window.LiveChatConfig = { siteId: 'demo', color: '#2f6bff', autoOpen: false };