渠道

嵌入网页聊天挂件

在你自己的网站上放置一个公开的 AI 聊天挂件——创建网页渠道、嵌入一段脚本,并选择会话、登录和只读行为。

把任意智能体变成你自己网站的聊天挂件——支持助手、销售机器人或交互式演示。网页渠道为你提供一个公开聊天页面和一行嵌入代码片段;访客就在他们已经所在的页面上与你的智能体对话,除非你愿意,否则无需登录。

与 Buda 智能体的网页聊天会话

创建网页渠道

添加渠道

打开 Settings → Channels,点击 Add Channel,选择 Web。挑选应当作答的目标智能体,为其设置标签,然后保存。

打开它的配置

选中新建的网页渠道以打开其配置面板。面板会提供公开聊天链接、嵌入代码片段,以及下文介绍的访客开关。

嵌入挂件

每个网页渠道有两种上线方式:

  • 公开聊天链接 —— 一个托管页面,地址为 https://your-buda-domain/c/<channelId>。复制并直接分享,或从某个按钮链接过去。
  • 嵌入代码片段 —— 把这段脚本放进你网站的 HTML,挂件就会自动加载:
<script>
  (function() {
    var s = document.createElement('script');
    s.src = 'https://your-buda-domain/embed.js';
    s.dataset.channelId = '<channelId>';
    document.head.appendChild(s);
  })();
</script>

配置面板会自动用你真实的域名和渠道 ID 填好这两者——请使用复制按钮,而不要手动输入。

网页渠道只有在**激活(active)**时才会为访客服务。如果聊天页面显示「not found」,请在 Settings → Channels 中检查渠道状态。

访客行为

配置面板中的三个开关控制访客如何体验挂件。它们会即时生效。

持久会话 vs 新会话

  • 持久 —— 回访的访客会回到同一段对话,因此上下文在多次访问之间延续。最适合持续性支持或个人助手。
  • 每次访问新建 —— 每次访问都会开启一个全新的聊天会话,不带任何先前历史。最适合一次性问答、演示或自助终端等不希望一个人的对话串到下一个人的场景。

需要登录 vs 匿名

  • 匿名(默认) —— 任何拿到链接的人无需登录即可聊天。
  • 需要登录 —— 访客必须先登录。他们的姓名会出现在会话上,当你想把对话归属到真实用户时很有用。

只读模式

开启只读可让访客查看已有对话,但无法发送消息——适合分享一段已完成的对话,或在不开放新输入的情况下展示智能体的输出。

相关内容

  • 渠道总览 —— 渠道如何把消息路由给智能体
  • 聊天会话 —— 持久模式和新会话模式如何映射到会话

On this page