网页聊天挂件

网页聊天挂件

网页聊天挂件是一个聊天气泡,只需一个 <script> 标签就能放到任意网页上。访客与你的 AI 对话;当有人接手时,他/她的回复会实时出现在同一个气泡里。

把它添加到你的网站

把代码片段粘贴在你的 </body> 结束标签之前:

<script src="https://blz.actionbridge.io/support/widget.js" data-key="wk_your_key_here"></script>

挂件在自己的框架中加载,因此不会与你网站的样式或脚本冲突。

选项

属性 作用
data-key 必填。你 desk 的挂件密钥,来自 Settings(设置)。
data-position right(默认)或 left——气泡停在哪个角落。
data-offset 距离角落的像素数(默认 20)。
data-lang 固定挂件的语言,例如 ja。不设置的话,每位访客看到的都是自己浏览器的语言。

如果你的页面在同一个角落显示 reCAPTCHA 标记,挂件会自动上移到它上方,两者不会重叠。

挂件说什么语言

不做任何设置时,挂件跟随每位访客自己浏览器的语言。一位日语访客访问英文网站,看到的就是日语气泡;无需配置,同一页面的不同访客可以看到不同的语言。

如果想固定成一种语言——比如网站只面向一个市场,无论谁在阅读——请加上 data-lang:

<script src="https://blz.actionbridge.io/support/widget.js" data-key="wk_your_key_here" data-lang="ja"></script>

已翻译成 11 种语言:英语、日语、韩语、中文(简体和繁体)、西班牙语、法语、德语、葡萄牙语、阿拉伯语和俄语。阿拉伯语采用从右到左的布局;中文跟随访客使用的字体——台湾、香港和澳门显示繁体,其他地区显示简体。其他任何语言都会回退到英语,而不是显示一个翻译了一半的气泡,所以 data-lang="it" 给你的是英语。

托管的网页表单同理:在它的地址后加上 ?lang=ja 即可固定语言,不加则跟随访客。

品牌颜色

在你选择之前,聊天使用我们的青色。选好你自己的颜色后,它会用于聊天的标题栏、按钮和你客户自己发出的消息,用于聊天打开时启动器上的关闭(✕)按钮,也用于你托管的网页表单。

  1. 打开你 desk 的 Settings(设置)。在 Web chat(网页聊天)部分,找到 Brand colour(品牌颜色),它就在 Chat bubble icon(聊天气泡图标)下方。
  2. 选择一种颜色,然后点击 Save colour(保存颜色)。
  3. 改主意了?Reset to default(恢复默认)会把我们的青色换回来。

你的颜色会在大约 5 分钟内生效到你的网站,无需重新粘贴任何东西。和图标一样,只有 desk 管理员和所有者才能更改它。

使用你自己的气泡图标

默认情况下,你网站上的启动器是我们的青色气泡,里面是一个对话气球图标(💬)。你可以把它换成你自己的 PNG,让挂件看起来像是属于你的网站。你上传的图片会成为整个按钮:它填满整个 56 像素的启动器,我们不再在它背后绘制青色圆形。

  1. 打开你 desk 的 Settings(设置)。进入 Web chat(网页聊天)部分,找到 Chat bubble icon(聊天气泡图标)。
  2. 点击 Upload PNG(上传 PNG)并选择你的文件。按钮旁的预览气泡会准确显示启动器的样子。
  3. 改主意了?Reset to default(恢复默认)会把我们的对话气球图标换回来。
图片 要求
格式 PNG
建议尺寸 正方形,至少 112×112 像素
显示尺寸 填满整个启动器,56×56 像素
形状 由图片本身决定——强烈建议使用透明背景
文件大小 最大 256 KB

启动器以 56×56 像素绘制,因此 112×112(或更大)的原图能让你的标识在高分辨率屏幕上保持清晰。我们会为你添加一层淡淡的阴影,并且贴合你图形的轮廓,所以不必把阴影烘焙进 PNG 里。

启动器图标是一张图片,所以你的品牌颜色不会给它重新着色——你上传的图标就是访客看到的样子。因为我们不再在你的图片背后绘制圆形,所以只要用透明 PNG,访客看到的颜色就是你自己图形的颜色。

访客看到的是什么

  1. 他们打开气泡,留下姓名、邮箱和第一条消息。
  2. AI 依据你的知识作答,附带来源,就在聊天中——无需等待你团队里的任何人。
  3. 人可以接手——几秒之内,他/她的回复就会出现在同一场聊天里。

他们留下的邮箱是下一次识别他们的依据——请参阅你的客户库。

网页聊天是五个入口之一——请参阅客户如何联系你,以及一场聊天开始后工单是怎样运作的。

发布于 2026-09-22
最后更新于 2026-09-30
版本 3