跳到主要内容

网页聊天组件

Web Chat 渠道会在您的网站上放置一个聊天窗口。访客点击页面角落的聊天按钮即可给您发消息。他们的会话会像其他任何渠道一样进入 MonoChat 收件箱,由您的团队、流程和 AI 智能体回复。

连接渠道​

  1. 前往 设置 › 聊天 › 渠道,点击 连接。
  2. 选择 Web Chat。
  3. 填写下面的设置并保存。每个字段都会说明其用途,表单右侧会显示窗口预览,并随您的编辑实时变化。预览可以在收起的聊天按钮、展开的窗口和示例会话之间切换。
  4. 复制渠道显示的代码片段,并添加到您的网站(参见安装代码片段)。

您可以连接多个 Web Chat 渠道,例如每个网站一个。

设置​

设置作用
渠道名称该渠道在 MonoChat 中的名称。小组件标题 为空时,窗口会将它显示为标题。
小组件标题聊天窗口的标题。
副标题标题下方的一行,例如您通常多快回复。清空该字段即可隐藏这一行。
徽标显示在标题旁边的图片:PNG、JPEG、GIF、SVG 或 WebP 文件。
颜色聊天按钮、窗口顶部和访客消息的颜色。其上的文字会变为黑色或白色,以保持清晰可读。
位置页面的右下角或左下角。
附件允许访客发送不超过 10 MB 的图片、视频、音频和文档。
表情按钮在消息框旁显示一个提供常用表情的按钮。默认开启。
隐藏聊天按钮隐藏聊天按钮,您可以通过 JavaScript API 用自己的按钮打开窗口。
移动端视图窗口在手机上的打开方式:全屏,或 紧凑,即覆盖页面下方四分之三的面板。
允许的域名窗口可以出现的网站:一个确切的主机(www.example.com)或所有子域名(*.example.com),可带端口(localhost:3000)。留空时任何网站都可以显示。

语言​

窗口的按钮和标签跟随访客浏览器的语言;MonoChat 没有该语言时显示为英文。

小组件标题、副标题、表单简介 和 同意文本 针对工作区的每种语言各有一个版本,语言在 设置 › CRM › 语言 中设置(请参阅语言设置)。点击字段即可编写各个版本。窗口显示访客浏览器语言的版本;该语言没有版本时,显示默认语言的版本。

若要无论浏览器语言如何都以同一种语言显示窗口,请通过 JavaScript API 调用 MonoChat('setLocale', 'tr-TR')。

聊天前表单​

关闭表单时,访客可以直接开始写消息。如需询问电子邮件地址或电话号码,请使用流程(参见流程与组件)。

开启表单时,窗口会在第一条消息之前询问以下信息:

字段选项
姓名关闭、可选或必填
电子邮件关闭、可选或必填
电话关闭、可选或必填

您还可以编写显示在字段上方的文字,并添加一个同意复选框,配上您自己的文字和隐私政策链接。开启复选框后,访客必须勾选才能开始聊天。姓名、电子邮件地址和电话号码会保存到客户资料中。

安装代码片段​

连接渠道后,以及编辑渠道时在预览下方,渠道会显示一个已填好组件地址和渠道密钥的代码片段。将它粘贴到每个需要显示聊天的页面的 </body> 结束标签之前:

<script>
window.MonoChat = window.MonoChat || function () { (MonoChat.q = MonoChat.q || []).push(arguments) }
</script>
<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>"></script>

窗口在页面之后加载,因此不会拖慢页面。

从旧版 WebChat 迁移

如果您的网站仍有旧 WebChat 渠道的代码片段,请将其删除,并在原处粘贴新 Web Chat 渠道的代码片段。

整页模式​

要为聊天单独提供一个页面(例如支持页面),请在代码片段的第二个标签中添加 &mode=fullpage:

<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>&mode=fullpage"></script>

此时窗口会铺满整个页面并保持打开,不显示窗口顶部和聊天按钮,close 和 toggle 不起作用。窗口随页面一起加载,而不是在页面之后加载,并且 移动端视图 设置不适用。

Google Tag Manager​

  1. 在您的容器中添加一个 Custom HTML 代码,并原样粘贴代码片段。
  2. 选择 All Pages 触发器,或只在需要显示聊天的页面上触发的触发器。
  3. 点击 Submit,再点击 Publish。

如果页面自己的脚本会调用 MonoChat,它们可能先于该代码运行。请把代码片段的第一个 <script> 也保留在页面上,这样这些调用会等待窗口就绪。

建站工具和网店平台​

如果您无法编辑网站代码,请将代码片段原样粘贴到平台为所有页面提供的代码栏中,放在页面末尾或页脚:

平台代码片段放在哪里
WordPress安装 WPCode 插件,并把代码片段粘贴到它的 Footer 栏。在 WordPress.com 上能否添加代码取决于您的套餐。
ShopifyOnline Store › Edit code:打开 theme.liquid,把代码片段粘贴到 </body> 之前。
WixSettings › Custom Code › Add Custom Code:选择所有页面和 Body – end。网站必须已发布并已连接域名。
SquarespaceCode Injection 的 Footer 栏,适用于 Core、Plus 和 Advanced 套餐。
WebflowSite settings › Custom code › Footer code,然后发布网站。
ikasSales Channel › Extensions › Scripts › Add Script:把代码片段粘贴为脚本内容,保存,并确认脚本已开启。

JavaScript API​

代码片段会在您的页面上定义一个 MonoChat 函数。从您自己的脚本、链接和按钮中调用它,即可控制窗口。在窗口加载完成前发起的调用会等待其就绪,因此您可以紧接在代码片段之后调用。

命令​

调用作用
MonoChat('open')打开窗口。
MonoChat('close')关闭窗口。
MonoChat('toggle')窗口关闭时打开,打开时关闭。
MonoChat('hideLauncher')隐藏聊天按钮。窗口仍可通过 open 和 toggle 打开。
MonoChat('showLauncher')重新显示聊天按钮。
MonoChat('setUser', { name, email, phone })传入您已掌握的访客信息。请参阅已登录的访客。
MonoChat('setLocale', 'tr-TR')无论浏览器使用何种语言,都以此语言显示窗口。请参阅语言。
MonoChat('on', event, callback)每次 event 发生时调用 callback。请参阅事件。

事件​

事件触发时机callback 接收的内容
ready窗口已加载。无
open窗口通过聊天按钮或调用打开。无
close窗口关闭。无
unread未读回复数发生变化:窗口关闭时收到回复,或访客打开窗口。未读回复数

请在代码片段之后立即注册回调,以免错过 ready。

已登录的访客​

当访客已登录您的网站时,请用 setUser 传入其信息。所有字段均为可选,窗口只读取 name、email 和 phone。

  • 聊天前表单会用这些信息预先填写。当表单要问的内容都已齐全时会被跳过,除非开启了同意复选框:访客始终需要自己勾选。
  • 这些信息会保存到 MonoChat 中的客户资料,让您的团队知道是谁在发消息。
  • 如果电子邮件地址或电话号码无效,则所有信息都不会保存。

示例​

通过您自己的按钮打开窗口,并隐藏聊天按钮:

<button onclick="MonoChat('open')">在线咨询</button>
<script>
MonoChat('hideLauncher')
</script>

传入已登录的用户,并以页面的语言显示窗口:

<script>
MonoChat('setUser', { name: 'Jane Doe', email: 'jane@example.com', phone: '+1 555 010 0000' })
MonoChat('setLocale', document.documentElement.lang)
</script>

在您自己的按钮上显示未读回复数:

<button onclick="MonoChat('open')">客服支持 <span id="chat-unread"></span></button>
<script>
MonoChat('hideLauncher')
MonoChat('on', 'unread', function (count) {
document.getElementById('chat-unread').textContent = count || ''
})
</script>

当访客打开窗口时,向您的分析工具发送一个事件:

<script>
MonoChat('on', 'open', function () {
gtag('event', 'chat_opened')
})
</script>

会话​

每位访客在 MonoChat 中都是一个客户,其会话保存在访客的浏览器中:使用同一浏览器回访的访客可以看到最近 200 条消息,有效期为最后一条消息后的 90 天。换用其他浏览器或设备会开始新的会话。您团队的回复和正在输入状态会实时显示在窗口中。

消息框旁的表情按钮提供常用表情。访客也可以用键盘输入任意表情。

访客发送的消息会像 WhatsApp 一样显示对勾:消息发出后显示一个灰色对勾,到达 MonoChat 后显示两个灰色对勾,团队中有人打开会话后显示两个蓝色对勾。在 MonoChat 中,访客的窗口收到您的回复时显示为已送达,访客打开窗口时显示为已读。

窗口关闭时,新回复会在聊天按钮上显示未读消息数,并播放一声简短的提示音。浏览器只有在访客点击过页面或在页面上输入过内容后才会播放提示音。

消息类型​

窗口显示消息的方式与 MonoChat 聊天界面相同:客服的名字显示在其回复上方,新的一天开始处有一行日期,每个气泡内显示时间,访客的消息上显示对勾。

除了文本、表情和文件,您的回复还可以使用下列类型。可以通过 发送消息 流程节点、短消息、应用和函数发送(请参阅消息类型)。

类型窗口中的显示方式
图片、视频、音频、贴纸显示在气泡内。
文档一张显示文件类型和名称的卡片,点击即可下载文件。
快速回复最后一条消息下方的按钮。点击后,按钮标题会作为访客的回复发送。
按钮一条消息,带有可选的页眉(文本、图片、视频或文档)、页脚,以及用于发送回复、打开网址或拨打电话号码的按钮。
CTA Url一条带有一个打开网址按钮的消息。
列表气泡内按分区分组的各行。点击某一行,该行会作为访客的回复发送。
轮播访客横向滚动浏览的卡片,每张卡片都有图片或视频、标题、副标题和按钮。
位置一个显示地点名称和地址的标记,点击后在 Google Maps 中打开该地点。
位置请求一个 发送位置 按钮。浏览器会请求访客授权,之后访客的位置会以位置消息的形式到达 MonoChat。
联系人每位联系人的姓名和公司,并附有拨打其电话号码和向其电子邮件地址写信的链接。

快速回复、回复按钮、列表行和位置请求只在最后一条消息上有效,因此访客无法回答旧的问题。

按钮图标​

打开网址的按钮可以显示图标:在 CTA Url 消息或 网页 URL 按钮的 图标 字段中选择。只有在为 Web Chat 构建消息时才会显示该字段:其他渠道不显示图标。可选图标有链接、网站、WhatsApp、Instagram、Messenger、Facebook、Telegram、TikTok、电话、电子邮件和位置;没有图标的按钮显示链接图标。

流程与组件​

欢迎消息、营业时间、非营业时间回复、询问电子邮件地址或电话号码以及主动消息都通过流程设置,而不是渠道设置。

已收到客户操作 事件会从窗口启动流程:

  • 聊天窗口首次打开:访客打开窗口,且没有进行中的会话。MonoChat 会开始会话,或重新打开其已关闭的会话,让流程可以在访客写消息之前先给访客发消息。会话进行中再次打开窗口不会再次触发该操作。
  • 聊天窗口已打开:访客每次打开窗口时,包括第一次。没有进行中会话的访客会获得一个会话,同上。
  • 聊天窗口已关闭:访客在进行中的会话期间关闭窗口。

开启聊天前表单时,访客填写完表单后,窗口才算打开。

仅浏览包含该组件的页面不会触发其中任何一个操作。尚未写消息的访客,只有在有流程监听该操作时才会成为 MonoChat 中的客户。

在整页模式下,窗口随页面一起打开,因此加载页面即算作打开窗口。 每个渠道每分钟最多计入 60 次窗口打开,超出的打开不会启动任何流程。

要问候访客,请启动一个将 已收到客户操作 设置为 聊天窗口首次打开 的流程,并添加一个包含欢迎消息的 发送消息 节点。用消息构建器构建该消息,可加入回复按钮、列表或带图标的链接。

Powered by MonoChat​

窗口会显示一行带有 MonoChat 标志的小字 Powered by。这不是渠道设置:只能针对整个 MonoChat 安装进行隐藏。