TapCub 正式上线:统计、分析、客服一个平台免费用
帮助中心

打开客服挂件

客服在你已经装好的代码上加载。拨一个开关、设好外观、决定离线时怎么办,没有网站的地方就分享独立聊天链接。

在线客服3 分钟阅读最后更新 2026 年 9 月 29 日TapCub 团队

开始之前

  • 统计代码已安装,实时报表里能看到访问。没有的话先完成安装指南。
  • 你的角色是所有者或管理员——只有这两个角色能打开客服设置。
  • 访客使用的域名在已登记主机名里;客服复用统计的那份列表。

不需要贴第二段脚本。第一次页面浏览之后,服务端会告诉 client.js 客服已开启,它再从客服域名(chat.askcub.com 或你所在区域的客服域名)按需加载客服启动器 widget.js。分步说明见网站怎么添加在线客服。

启用

  1. 打开 客服聊天设置外观与品牌。 打开启用在线客服并保存。页面顶部的状态从关闭变为开启。
  2. 刷新你的网站。 已经打开的标签需要刷新一次。气泡出现在页面角落。
  3. 发一条测试消息。 点开气泡随便输入点什么。在 客服客服工作台 里它出现在待接入下——如果自动分配已开启且你在线,则直接进入我的。回复一次,确认访客窗口收到了。

外观

所有视觉项都在同一个外观页:

设置作用
品牌名、副标题、Logo显示在聊天窗口头部。品牌名留空时使用站点名。Logo 正方形,不超过 200 KB。
主色气泡和发送按钮。选一个和页面背景有对比度的颜色。
位置右下或左下。
深色模式跟随访客系统、始终浅色或始终深色。
手机端隐藏气泡窗口窄于 640 px 或浏览器是手机时隐藏。
招呼语有坐席在线一句,没人在线一句。控制在一句话——太长的开场白读起来像一条会被关掉的弹窗。
预告卡到达约 4 秒后,气泡上方弹出一次卡片。已有会话的访客不会看到。

Free 套餐在窗口底部显示一行小字「Powered by TapCub」;Pro 及以上可以在这里关掉。

工作时间与离线

在 客服聊天设置工作时间 下打开启用工作时间,选时区、工作日、开始和结束时间。时段内有坐席在线时气泡显示在线;时段外访客看到离线招呼语和一个填邮箱与问题的小表单。这些记录在离线留言下,状态有新建、已回复、已关闭。

不启用工作时间,气泡全天跟随坐席的真实在线状态。如果把 AI 助手设为无人在线时回答,知识库会先回复,只有它答不上来时才出现表单——见 AI 回复。

独立聊天页

客服聊天设置安装 提供一个全屏聊天页:chat.askcub.com/{siteKey}。它不需要任何网站上有代码,所以可以放进邮件签名、包装上的二维码或社交主页。在站内气泡里,访客也可以选择在新窗口打开,在那里继续同一个会话。

同一页还有一个测试页,用你的站点 Key 模拟真实访客——不碰线上站就能培训坐席。先把 localhost 加进主机名。

按页面控制客服

控制台开关对整站生效。脚本标签上的 data-chat 属性可以在单个页面上覆盖它:

index.html
<!-- 这个页面永远不加载客服(比如结账页) -->
<script defer src="https://static.pathclue.com/client.js" data-site="YOUR_SITE_KEY" data-chat="false"></script>

<!-- 立即加载客服组件,不等第一次页面浏览 -->
<script defer src="https://static.pathclue.com/client.js" data-site="YOUR_SITE_KEY"></script>
<script async src="https://chat.askcub.com/widget.js"></script>

直接引入的 widget.js 仍然尊重控制台开关——在线客服关着的话,不会出现气泡。

没有气泡时

现象处理
没有气泡,widget.js 从未加载确认开关已保存、页面已刷新。检查标签有没有 data-chat="false"。确认统计本身在发送数据。
widget.js 加载了,没有气泡大概率开了手机端隐藏气泡,而你的窗口窄于 640 px。
widget.js 加载了,始终没有气泡页面的域名没登记。客服服务会按「客服未开启」回应,不报错。到 SDK 代码页把域名加上。
点开就是留言表单没人在线也没有 AI 接待,或本月会话额度用完(只影响新访客)。见没人在线时。
严格的 CSP放行 widget.js 的主机、聊天网关连接,以及窗口内的 frame 页面。

更多排查见客服气泡为什么不显示。

这篇回答解决你的问题了吗?

我们会根据反馈修改和补充这篇内容。

看清数据,找到增长。

每一次点击,都有数据依据。装好一行代码,1 分钟看到第一批数据。

无需信用卡 · 统计与客服都有免费版 · 统计无 Cookie