intelligencesupport

公开页面与网站嵌入

每个上线的服务台都有一个公开页面。把它放上你的网站,做成聊天气泡、窗口或链接,再给气泡定个样子。

适用对象
编辑者、管理员与网页开发者
应用位置
/s/[slug]/customer-service/desk/[id]#website
更新日期

观看视频

把服务台放上你的网站

每个上线的服务台都有一个公开页面,谁都打得开,不用账号。同一个服务台也能落到你自己的网站上:角落里的一个聊天按钮,页面里的一扇窗口,或者一个链接。下面逐个说清楚。

公开页面

每个服务台的公开页面,地址是 https://intelligence.bearingbridge.com/s/ 加上它的 URL 标识(slug)。这段短名在服务台设置里定。参见 创建并设置服务台。

页面只在服务台上线期间作答。关掉的服务台,或者不存在的 slug,都落到一张“未找到”的页面上:“此助手不存在或当前已关闭。”

要打开它,在服务台页面上点 打开公开页面,或者在服务台列表的卡片上点 公开页面。两个按钮都只在服务台上线时出现。

页面会告诉搜索引擎不要收录自己,因此不该出现在搜索结果里。

访客看到什么

页眉是你的品牌标志(没有标志就用名字的首字母)和显示名称,底下一行写着 “帮助助手 · 依据我们的官方文档作答”。你若写过欢迎语,它排在最前面。

访客在标着 “提个问题…” 的框里打字,按 发送 或回车发出。Shift+Enter 换行,一个问题最长 1,000 个字符。答案按手机屏幕排版,短段落加要点列表,每条下面有一行 “来源:”,点名它用过的文档和章节。页脚一行写明答案出自你的文档、可能不全,并由 Intelligence by BearingBridge 提供支持,这句话链接到 bearingbridge.com 对应语言的首页。

发送 按钮和页眉里的首字母采用服务台的颜色:先用气泡的颜色(见 给气泡做造型);气泡颜色太浅或太深、撑不起按钮时,比如围着标志的一圈白色,就改用品牌色。两者都没有,就保持应用自带的青色。

一个上线服务台的公开页面,有显示名称、欢迎语,还有访客打字提问的方框
一个上线服务台的公开页面,有显示名称、欢迎语,还有访客打字提问的方框

页面自身的文字有英文、法文、中文三种,以贵组织提供的语言为限。放在您的网站上时,气泡按所在网页的语言打开面板:法文网站显示法文面板,不管访客的浏览器用什么语言。单独打开时,页面跟随访客浏览器的语言,否则显示英文。您写的欢迎语、答案和来源标题保持服务台写出的原样:每条答案都用访客提问的语言写成。

网站上的气泡和窗口显示的就是这个页面,所以这一节讲的对它们同样成立。

服务台答不上来的时候,访客看到的是你在服务台设置里打开的那几条退路。提供发送邮件 开着、并且服务台填了联系人邮箱,发送邮件 才出现。点它会打开访客的邮件应用,问题已经填好;没有邮件应用的设备,你的地址也写在旁边。

提供联系表单 开着,填写表单 才出现。点它打开一张短表单:姓名(可不填)、邮箱、留言,问题已经预填进去。发出之后,访客读到的是:“谢谢!您的联系方式已转交,将有专人与您联系。” 这些资料落到哪里,见 会话与费用。

助手记得住这段会话最近的几个来回,所以访客可以接着追问。重新加载页面就是新的一段会话。

访客会撞上的限制

公开页面谁都打得开,所以它设了几道限制,护着你的额度。撞上一道,访客收到一句简短的提示。表里注明的那几种情形,只要你开着联系方式,它就跟在提示下面出现。

情形访客读到什么
同一个访客一分钟内发了超过 10 条消息“消息发送过于频繁,请稍候再试。”
一段会话累计到 40 条消息(问和答合计)“本次会话已达上限。” 后面跟着你的联系方式
服务台用完了当日预算“助手今日已达使用上限。” 后面跟着你的联系方式
你的组织额度见底“助手暂时无法使用。” 后面跟着你的联系方式。绝不提钱
页面开着超过 2 小时“会话已过期,请刷新页面。”
页面开着的时候服务台被关掉“该助手目前已关闭。”
助手正忙“助手当前咨询量较大,请一分钟后重试。”
其他任何故障“出现异常,请稍后重试。”

联系表单对同一个访客每小时最多收 5 次提交。

打开页面、点开聊天按钮,都不花钱。只有访客问出一个问题,才动用额度。

把服务台放上你的网站

页面本身就是这样。把它搬到自己的站点上,主要是复制粘贴的活。

在服务台页面上打开 服务台 标签页,切到 添加到您的网站。有三条路可走。每一条都配好现成的代码、一个 复制代码 按钮和简短步骤,旁边一幅小小的浏览器示意图,画出它落在页面的什么位置。

这些代码在任何站点上都能用:WordPress、Shopify、Wix、Webflow、Squarespace,手写的也行。不管你从哪个地址打开应用,它们一律指向正式地址。它们也跟着已保存的 slug 走:改了 slug,代码要等设置保存之后才变。

复制代码 会短暂变成“已复制”。浏览器拦住剪贴板时,代码改为选中状态,按钮写着“按 Ctrl+C 复制”。

提示: 服务台还关着的时候就可以把代码贴上去。服务台一上线,你的站点上立刻开始作答。

悬浮气泡

每个页面右下角一个圆形聊天按钮。点一下,服务台在它上方的面板里打开,电脑屏幕上是 380 乘 640 像素;再点一下,或者按 Escape,面板收起。手机上面板铺满大半个屏幕,按钮留在它下方。多数站点从这里起步就好。

  1. 点 复制代码,它只有一行。
  2. 把它贴在站点模板的最末尾、body 结束标签之前,贴一次就够,这样每个页面都有它。建站工具一般有专门的地方放这个,常叫自定义代码、代码注入或页脚脚本。
  3. 发布站点,随便打开一个页面。按钮就在右下角。
把悬浮气泡放上网站的那一行代码,旁边是复制代码按钮
把悬浮气泡放上网站的那一行代码,旁边是复制代码按钮

同一行上还能再添几样东西:

往那一行里加效果
data-position="left"按钮改到左下角
data-label="..."读屏软件和悬停提示用的文字。默认是 “咨询我们”
data-lang="fr"面板和按钮提示文字的语言:en、fr 或 zh。默认是您网页声明的语言
data-color="#rrggbb"一个颜色,只在按钮载不出已保存的造型时才用上

你自己的链接和按钮也能唤出聊天,写上 onclick="BearingBridgeDesk.open()" 即可。BearingBridgeDesk.close() 和 BearingBridgeDesk.toggle() 同样有效。

按钮脚本不写任何 cookie,只有访客点击时才打开服务台页面。同一行贴两遍,出现的还是一个按钮。服务台关着,按钮根本不出现。

给气泡做造型

代码上方的造型卡片管按钮长什么样,预览跟着你的选择走。改造型并保存需要编辑者或更高权限,其余的人看到的卡片是灰的。

聊天按钮的造型卡片,有配色块、图标选项和按钮预览
聊天按钮的造型卡片,有配色块、图标选项和按钮预览
  • 颜色:挑一个色块,用取色器挑任意颜色,或者直接输入色值。起点是品牌色。图标会自己转深或转白,哪个看得清用哪个。面板里的按钮也会用上这个颜色,除非它太浅或太深,撑不起按钮。
  • 图标:聊天图标、品牌 Logo 或 您的图片。品牌还没有标志时,品牌 Logo 是灰的;到品牌页上传一个即可。参见 品牌。
  • 您的图片:点 选择图片 上传一份 PNG、JPEG 或 WebP 文件,最大 2 MB。方形图片效果最好。传过一张之后,更换图片 和 移除图片 才出现。
  • 图片铺满整个按钮:用标志或图片时,这个开关让画面铺满整个圆形,而不是缩在里面。

点 保存设计。你的站点一分钟之内换上新样子,不必重贴代码。上传的图片要等你保存设计才真正生效。移除图片,聊天图标就回来了。

嵌在页面里的窗口

把聊天做成一扇窗口,嵌在站点的某一个页面里,比如帮助页或联系页。

  1. 点 复制代码。
  2. 把它贴到聊天该出现的地方。用建站工具的话,在那个位置加一个 HTML、嵌入或自定义代码区块,把代码贴进去。
  3. 要配合你的版式,就改代码里的宽度(max-width)和高度。初始值是最宽 560 像素、高 640 像素。

和气泡不一样,窗口不会在服务台关掉时自己藏起来:你的页面会在框里显示“未找到”的提示。要么把代码撤掉,要么把服务台重新打开。

服务台自己的页面,从一个链接打开:站点上的一个按钮或菜单项、邮件签名、二维码,或者一条消息。

  • 复制地址 复制的是那个朴素的公开地址。把它贴进建站工具里的按钮或菜单链接。
  • 复制代码 复制的是一段写好的 HTML 链接,文字是 “Ask our help assistant”。这几个字随你改。

值得注意

  • 从你网站来的每一段会话,都和公开页面上的一样,落进服务台的 对话 标签页。
  • 改 slug 会改掉每一段代码和那个公开地址。保存之后要把代码重贴一遍。指向旧地址的链接就此失效,还挂着旧气泡代码的站点则不再显示按钮。
  • 答案由你组织的额度买单,每日预算给你站点的访客每天能花的钱封了顶。参见 会话与费用。
  • 服务台跑在应用自己的地址上。没有办法把它挂到你自己的域名下。

额度怎么运转,额度与费用 里讲得明白。

排查

问题查什么
聊天按钮不出现服务台上线了吗,设置保存了吗?那一行是不是贴在每个页面 body 结束标签之前,站点发布了吗?贴上之后 slug 改过没有?
窗口显示“未找到”服务台被关掉了,或者它的 slug 变了。
面板或窗口一片空白你站点的 Content-Security-Policy 可能拦住了它。见下。

给你的网页开发者

你的站点若发送 Content-Security-Policy 响应头,请在 frame-src 里放行 https://intelligence.bearingbridge.com,气泡还需要在 script-src 和 connect-src 里同样放行。按钮上显示标志或图片时,还要在 img-src 里放行这张图片的地址:在您的网站上右键点按钮里的图片,就能复制它。服务台页面在代码下方的说明里写着这个地址。