快速开始
选择组织、添加知识、安装挂件并处理第一段对话
本指南将带你从一个新组织开始，发布可用的 Bubblo 挂件，并在收件箱中看到第一段对话。
开始前准备
你需要：
- 能够访问 Bubblo 控制台。
- 一份可供组织 AI 使用的内容，例如帮助页面、PDF 或简短 FAQ。
- 网站 HTML 的修改权限，用于添加挂件脚本。
1. 登录并选择组织
打开控制台，使用 Google、GitHub 或邮箱魔法链接登录。在侧栏中选择现有组织，也可以从组织切换菜单选择创建组织。
组织拥有自己的知识库、Actions、成员、用量、收件箱会话和唯一 Widget 渠道。Bubblo 的无状态 AI 运行核心会在每轮对话中加载这些组织级资源，不需要另外创建 AI 资源。如果你加入了多个组织，请确认当前组织应该拥有这个网站的资源。
2. 添加知识来源
打开 能力 → 知识库，选择添加来源，然后选择一种方式：
- 上传文件：支持 PDF、DOCX、Markdown（
.md或.markdown）和 TXT，文件最大 20 MB。 - 手填内容：直接输入标题和正文。
- 抓取网页：输入可公开访问的页面 URL。带页面路径的 URL 会作为单个来源立即抓取；输入网站根地址时，系统会通过站点地图和站内链接发现页面，创建最多 200 个可安全访问的 URL 条目，供你逐个检查和抓取。
新来源首先是草稿，完成索引前不会被组织 AI 使用。
3. 检查并索引内容
在知识来源列表中选择一项，并检查解析出的正文。
- 对于站点发现创建的网页来源，先选择抓取获取正文。
- 如果标题或正文需要修正，选择查看/编辑。
- 选择索引。
- 等待状态从索引中变为已索引。
如果编辑或重新抓取已经索引的来源，它会回到待索引状态。再次选择索引，更新后的内容才会重新提供给组织 AI。
4. 自定义挂件
打开 集成 → Widget，经过顶部的精简安装区后找到外观表单。
- 上传客服头像，再选择预设颜色和左侧或右侧位置。
- 编辑客服名称、欢迎语、推荐问题和输入框提示。
- 英文是默认语言；如果需要，可以添加中文或西班牙文。每种已启用语言都有自己的文案。
- 在 Pro 套餐中，可以关闭“Powered by Bubblo”品牌标识。
- 检查实时预览，再点击表单底部的保存更改。
头像在上传完成时立即单独保存。实时预览会跟随其他外观内容变化，但只有点击保存更改后，网站上的其他设置才会更新。
5. 安装挂件
打开 集成 → Widget，复制页面顶部生成的安装代码。它的格式如下：
<script src="https://cdn.bubblo.ai/widget.js" cid="YOUR_CHANNEL_ID"></script>把脚本粘贴到网站 <body> 结束标签附近，发布页面，并确保脚本只加载一次。如果手动编写代码，请用页面显示的 Widget CID 替换 YOUR_CHANNEL_ID。这个公开的 cid 标识当前组织唯一的 Widget 渠道，它不是 API 凭证。
脚本加载后，网站还可以主动控制挂件：
window.Bubblo.open()
window.Bubblo.close()
window.Bubblo.identify({ userId: "u_123", email: "ada@acme.com", name: "Ada" })identify 是可选的。它会把你提供的访客上下文附加到后续消息中。这些浏览器提供的值未经验证，不能用作身份认证。
6. 测试一段对话
在浏览器中打开已经发布的页面。
- 打开 Bubblo 挂件。
- 发送一个能从已索引来源中找到答案的问题。
- 确认挂件收到了回复。
- 返回控制台，在同一组织中打开收件箱。
对话应该实时出现在收件箱中。如果回复没有使用最新内容，请回到 能力 → 知识库，确认该来源在同一组织中显示为已索引。
7. 在收件箱中处理对话
在收件箱中选择这段对话。你可以：
- 按会话标题或访客代号搜索。
- 筛选全部、待人工或已解决对话。待人工同时包含已开启人工接管的对话，以及 AI 故障后需要人工介入的对话。
- 打开人工接管并以人工客服身份回复。
- 将对话标记为已解决，之后也可以重新打开。
- 在有数据时查看访客所在页面、来源页、浏览器、操作系统、语言和活动时间。
- 对话解决后，查看异步生成的会话总结。
至此，你已经完成了 Bubblo 的完整闭环：索引知识、安装挂件、产生 AI 对话，并完成人工接管。
接下来可以做什么
- 添加更多聚焦的知识来源，并在修改后重新索引。
- 为每种已启用的挂件语言配置文案。
- 从 组织 → 成员与权限邀请团队成员。
- 了解 AI 供应商与回复路由，或配置 AI 无法继续时的接管通知。
- 查看订阅与用量；Pro 组织还可以查看对话洞察。