操作指南
选择聊天组件的显示位置
让聊天组件和帮助中心远离会碍事的页面,并在真正有帮助的时候出现:面向已登录客户、在活动期间,或在有人阅读了一段时间之后。
在哪里设置
打开渠道,选择你的网站渠道,打开在线聊天标签页,滚动到聊天组件的显示位置。所有者和管理员可以修改。完成后选择保存更改。访客在下次加载页面时会应用新规则。
允许列表和屏蔽列表
在“页面”下选择三种模式之一:
- 在所有页面显示:默认设置。不使用页面列表。
- 仅在这些页面显示:允许列表。聊天组件只在匹配规则的页面上显示。
- 在这些页面隐藏:屏蔽列表。聊天组件在除匹配规则的页面外的所有地方显示。
每个页面添加一条规则。以 / 开头的规则会匹配你任何域名上的路径,包含域名则只针对某一个网站。* 可匹配任意内容。匹配时忽略大小写和查询字符串,除非你的规则中包含 ?。
| 规则 | 匹配 |
|---|---|
/pricing | 仅 /pricing(忽略末尾的斜杠) |
/blog/* | /blog/ 下的所有页面,但不包括 /blog 本身 |
/blog* | /blog 及其下的所有页面 |
*checkout* | 任何包含 checkout 的路径 |
shop.example.com/* | 该域名上的所有页面(忽略 www.) |
/pricing?plan=* | 仅当 /pricing 带有 plan 参数时 |
根据触发条件显示聊天组件
在仅在以下情况显示下,最多可添加 20 个条件。有多个条件时,选择满足所有条件或满足任一条件。只有在允许的页面上并且条件满足时,聊天组件才会显示。日期和时间使用工作区设置中的工作区时区。
| 条件 | 检查内容 | 示例 |
|---|---|---|
| 页面 URL | 当前页面的完整地址。“匹配规则”使用与页面列表相同的通配符。 | 包含 /pricing |
| URL 参数 | 单个查询参数,例如活动或优惠券。用“已设置”检查它是否存在。 | utm_campaign 等于 summer-sale |
| 来源页面(referrer) | 访客来自的页面。 | 包含 google. |
| 访客邮箱 | 你的网站通过 identify 发送的邮箱,或访客自己输入的邮箱。用“已设置”实现“仅限已登录访客”。 | 结尾是 @acme.com |
| 访客属性 | 你的网站通过 identify 或 setAttributes 发送的任何属性:用户 ID、群组、套餐或自定义字段。文本、数字和真/假值都按精确值比较。 | group 为 vip、beta 之一 |
| 日期 | 今天的日期,从某天起和/或至某天止(含首尾两天)。 | 从 2026-11-24 至 2026-11-30 |
| 星期和时间 | 一周中的某几天和一个时间段。结束时间早于开始时间的时间段会跨过午夜。 | 周一至周五,09:00 至 17:00 |
| 设备 | 手机,或平板和电脑。 | 手机 |
| 浏览器语言 | 访客的浏览器语言。de 涵盖 de-CH 和 de-AT。 | 等于 de |
| 页面停留时间 | 访客打开当前页面后经过的秒数。达到该时间后聊天组件会立即出现。 | 至少 15 秒 |
每当访客在单页应用中切换到另一个页面、你的网站发送新的属性时,以及设置了日期或时间表条件时的每一分钟,规则都会重新检查。如果聊天处于打开状态时规则将其隐藏,聊天会关闭。对话会被保留,等聊天组件重新出现时继续。
发送规则需要检查的值
访客邮箱和访客属性条件读取的是你的网站传给聊天组件的值。使用已验证身份(userJwt)的已登录访客,如果邮箱条件需要,也应传入 email。
HTML
<script>
// Send the values your display rules check
sonny('identify', {
email: 'anna@acme.com',
attributes: { userId: 'u_123', group: 'vip', seats: 12 }
});
// Later, when something changes
sonny('setAttributes', { group: 'beta' });
</script>用代码覆盖规则
你自己的代码始终优先。sonny('show') 和 sonny('hide') 会在页面重新加载前忽略这些规则。
HTML
<script>
sonny('hide'); // hide the widget, whatever the rules say
sonny('show'); // show it again, whatever the rules say
sonny('open'); // opens the chat, and shows the widget if rules hid it
</script>须知
- 显示规则只是隐藏聊天组件,并不限制访问:任何人仍然可以加载它。
- 规则作用于整个聊天组件,包括其“帮助”标签页。你的公开帮助中心网站不受影响。
- iOS 和 Android SDK 会忽略显示规则,由应用决定何时打开聊天。
- 在聊天组件被隐藏的页面上,实时访客仍会列出正在浏览的人。