公开页面与网站嵌入
每个上线的服务台都有一个公开页面。把它放上你的网站,做成聊天气泡、窗口或链接,再给气泡定个样子。
观看视频
每个上线的服务台都有一个公开页面,谁都打得开,不用账号。同一个服务台也能落到你自己的网站上:角落里的一个聊天按钮,页面里的一扇窗口,或者一个链接。下面逐个说清楚。
公开页面
每个服务台的公开页面,地址是 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,面板收起。手机上面板铺满大半个屏幕,按钮留在它下方。多数站点从这里起步就好。
- 点 复制代码,它只有一行。
- 把它贴在站点模板的最末尾、body 结束标签之前,贴一次就够,这样每个页面都有它。建站工具一般有专门的地方放这个,常叫自定义代码、代码注入或页脚脚本。
- 发布站点,随便打开一个页面。按钮就在右下角。

同一行上还能再添几样东西:
| 往那一行里加 | 效果 |
|---|---|
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。方形图片效果最好。传过一张之后,更换图片 和 移除图片 才出现。
- 图片铺满整个按钮:用标志或图片时,这个开关让画面铺满整个圆形,而不是缩在里面。
点 保存设计。你的站点一分钟之内换上新样子,不必重贴代码。上传的图片要等你保存设计才真正生效。移除图片,聊天图标就回来了。
嵌在页面里的窗口
把聊天做成一扇窗口,嵌在站点的某一个页面里,比如帮助页或联系页。
- 点 复制代码。
- 把它贴到聊天该出现的地方。用建站工具的话,在那个位置加一个 HTML、嵌入或自定义代码区块,把代码贴进去。
- 要配合你的版式,就改代码里的宽度(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 里放行这张图片的地址:在您的网站上右键点按钮里的图片,就能复制它。服务台页面在代码下方的说明里写着这个地址。