设置 Chatbot 组件样式
整个过程约需 5 分钟。你可以从浮动栏更新实时组件并保存更改。
本指南将帮助你更改 Chatbot 组件的图片、颜色、文本和自动打开行为。
前往: Communication Hub → Chatbot → Widget Style
快速参考
| 任务 | 点击位置 | 结果 |
|---|---|---|
| 预览组件 | Getting Started / Conversation | 查看客人使用各布局时的体验 |
| 编辑启动图标 | Images & Branding | 更改客人点击的浮动按钮 |
| 编辑机器人头像 | Images & Branding | 更改聊天中的图片 |
| 调整自动打开行为 | Launcher (Chat Button) | 控制组件在桌面端和移动端何时打开 |
| 编辑页眉和消息颜色 | Header、Bubbles、Input | 使其符合你的品牌风格 |
| 编辑欢迎文本和政策链接 | Welcome Screen | 控制客人看到的首个页面 |
| 保存或放弃更改 | 页面底部的浮动栏 | 应用或还原当前编辑内容 |
套餐权限
- 组件样式功能需要付费套餐。
- Widget Style 需要
chatbot_setup:manage权限。 - 没有此权限时,AVA 会隐藏该页面并阻止直接链接访问。
- 免费套餐账号会看到升级提示,无法保存样式。
如需升级,请前往 Settings → Billing & Subscription。
更新组件样式
-
使用预览模式按钮:
- Getting Started
- Conversation
✓ 预览会更新,以匹配所选模式。
-
打开 Images & Branding,更新视觉素材。
-
使用 Launcher Icon 设置浮动按钮图片。
-
使用 Bot Avatar 设置聊天内的图片。
✓ 这些图片分别用于组件的不同部分。
-
打开 Launcher (Chat Button),调整自动打开行为。
-
为 Desktop 和 Mobile 选择设置。
-
如果选择 Enable with delay,请选择延迟秒数。
✓ 组件会针对每种设备类型使用所选的打开行为。
-
打开 Header、Bubbles、Input 和 Welcome Screen,更新文本与颜色。
-
在 Welcome Screen 中打开 Terms & policies 部分。
-
按需开启 Privacy Policy 或 Terms Of Service。
-
输入 URL,或上传
.pdf或.md文件。
✓ 上传的文件会自动填充政策 URL。
- 在浮动栏中点击 Save chatbot style settings。
✓ 只有在你进行更改后,该按钮才会出现。
检查访问权限
你需要 chatbot_setup:manage 才能查看或编辑 Widget Style。
如果页面或链接缺失,请让管理员更新你的角色。
排查访问问题
你会看到: 缺少 Widget Style,或直接链接无法打开。
解决方法:
-
请管理员打开 Superadmin → Permissions → Roles。
-
确认你的角色包含
chatbot_setup:manage。 -
角色更改后退出账号,再重新登录。
-
打开 Communication Hub → Chatbot → Widget Style。
✓ 角色获得访问权限后,页面和侧边栏链接就会显示。
了解图片用途
在正确的位置使用正确的图片。
| 图片 | 显示位置 | 影响内容 |
|---|---|---|
| Launcher Icon | 聊天外的浮动按钮 | 客人点击以打开聊天的按钮 |
| Bot Avatar | 页眉、机器人消息和欢迎页面 | 客人在对话中看到的头像 |
如果你保存过旧版组件样式,首次保存时该图片会自动移至 Bot Avatar。
管理政策
-
打开 Welcome Screen。
-
打开 Terms & policies 部分。
-
保持 Vouch Policy 启用。
-
需要时开启 Privacy Policy 或 Terms Of Service。
-
添加标签和 URL,或上传
.pdf或.md文件。 -
点击 Save chatbot style settings。
✓ 预览会在欢迎页面显示已启用的链接。
保留或还原更改
页面底部有一个浮动操作栏。
- 点击 Save chatbot style settings 保留你的编辑内容。
- 点击 Discard changes 返回上次保存的版本。
只有更改字段后,才会看到浮动栏。
使用建议
- 保持文本对比度较高,以便阅读。
- 保存前检查两种预览模式。
- 政策名称应简短,以便链接适合移动端屏幕。
- 使用与你的网站和客人邮件一致的颜色。
- 此页面无法编辑附件按钮样式。
故障排查
预览不更新
你会看到: 编辑后预览保持不变。
解决方法:
- 在 Getting Started 和 Conversation 之间切换
- 刷新页面
- 再次尝试更改
保存失败或回退
你会看到: 保存后样式没有保留。
解决方法:
- 再次点击 Save chatbot style settings
- 等待成功消息
- 确认你的套餐允许使用组件样式功能
显示了错误的图片
你会看到: 浮动按钮发生变化,但聊天头像没有变化。
解决方法:
- 打开 Images & Branding
- 编辑 Launcher Icon,更改浮动按钮
- 编辑 Bot Avatar,更改聊天内图片
- 保存更改
上传返回忙碌提示
你会看到: 图片或政策上传因忙碌提示而失败。
解决方法:
- 等待 10 秒
- 再次尝试上传
- 如果有多名员工同时上传,请错开上传时间
- 如果问题持续发生,请联系支持团队
政策上传失败
你会看到: 政策字段下方显示上传错误。
解决方法:
- 仅使用
.pdf或.md文件 - 确保文件足够小,可以完成上传
- 如果上传提示忙碌,请等待 10 秒后重试
- 重试上传,然后点击 Save chatbot style settings
政策链接未显示
你会看到: 预览中缺少 Privacy Policy 或 Terms Of Service。
解决方法:
- 打开 Welcome Screen
- 打开政策开关
- 添加有效 URL
- 再次保存设置
放弃更改后页面未还原
你会看到: 点击 Discard changes 后页面仍显示未保存的编辑内容。
解决方法:
- 等待控件刷新
- 再次尝试 Discard changes
- 如有需要,刷新页面
仍未解决?
如果出现以下情况,请联系 success@vouch-technologies.com:
- ❌ 多次尝试后样式仍无法保存
- ❌ 保存后预览没有刷新
- ❌ 问题持续超过 30 分钟
建议附上:
- Widget Style 页面截图
- 你尝试进行的样式更改
- 问题开始的时间