操作指南

选择聊天组件的显示位置

让聊天组件和帮助中心远离会碍事的页面,并在真正有帮助的时候出现:面向已登录客户、在活动期间,或在有人阅读了一段时间之后。

在哪里设置

打开渠道,选择你的网站渠道,打开在线聊天标签页,滚动到聊天组件的显示位置。所有者和管理员可以修改。完成后选择保存更改。访客在下次加载页面时会应用新规则。

允许列表和屏蔽列表

在“页面”下选择三种模式之一:

  • 在所有页面显示:默认设置。不使用页面列表。
  • 仅在这些页面显示:允许列表。聊天组件只在匹配规则的页面上显示。
  • 在这些页面隐藏:屏蔽列表。聊天组件在除匹配规则的页面外的所有地方显示。

每个页面添加一条规则。以 / 开头的规则会匹配你任何域名上的路径,包含域名则只针对某一个网站。* 可匹配任意内容。匹配时忽略大小写和查询字符串,除非你的规则中包含 ?。

规则匹配
/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 会忽略显示规则,由应用决定何时打开聊天。
  • 在聊天组件被隐藏的页面上,实时访客仍会列出正在浏览的人。

相关文档