组件只负责气泡和会话窗,不提供统计用的 track、pageview 或 login。
安装
统计已经在页面上时,只保留这一行,不要再引入客服脚本:
html
<script async src="https://YOUR_ORIGIN/w.js" data-site="YOUR_SITE_KEY"></script>w.js 会在需要时加载同目录的 w-chat.js。同一标签上 data-chat="true" 为强制加载,data-chat="false" 为强制关闭。不写该属性时,由第一次浏览响应里的客服开关决定。
只有客服、没有统计时,改用这一行:
html
<script defer src="https://YOUR_ORIGIN/w-chat.js" data-site="YOUR_SITE_KEY"></script>初始化
脚本找到带 data-site 的标签,或已经存在的 webcount.siteKey,拉取客服配置后画出气泡。站点标识为空时什么都不做。同一页重复加载会被忽略,后贴的标签改不了已经画出的气泡。
页面浏览
组件不发送页面浏览。浏览仍由 w.js 采集。
事件
组件没有 track。业务事件继续用 webcount.track。
身份
组件没有 login。访客是谁,仍在统计脚本上调用 webcount.login,见 JavaScript(w.js)。
限制
| 项目 | 要求 | 说明 |
|---|---|---|
| 来源 | 同域 | w-chat.js 与 w.js 使用同一个源 |
| 标签数量 | 一段 | 统计脚本已在时不要再加客服脚本 |
| 站点标识 | 必填 | 没有 data-site 时组件直接返回 |
错误
气泡不出现时,先确认站点标识写在统计脚本上,data-chat 没有设成 false,客服配置处于启用状态。开启了「移动端隐藏气泡」时,手机上不显示。组件不提供查询在线状态的函数,也不把连接过程暴露成可调用接口。按 在线客服快速入门 打开气泡并发送一条消息,到工作台确认能收到。