扣子提供一键嵌入的网页SDK方案,复制发布后获取的bot_id及嵌入代码,粘贴至博客HTML的</body>前即可实现访客免登录、免跳转与AI对话。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让访客在你的个人博客页面上直接和AI助手对话,不用跳转、不用登录、不额外安装插件——扣子(Coze)提供了一键嵌入的网页SDK方案,只需复制一段代码,粘贴进博客HTML即可生效。
确认智能体已发布并获取唯一ID
登录扣子平台 → 进入「Bot管理」→ 找到你要部署的智能体 → 点击右上角「发布」按钮 → 在弹出窗口中勾选「网页」渠道 → 点击「发布」。
发布成功后,页面会跳转至「发布设置」页,此时页面URL形如 https://www.coze.cn/console/bot/[bot_id]/publish/web,其中 【[bot_id]】 就是你要用的智能体唯一标识符,务必完整复制,漏一位会导致SDK加载失败。
若未看到该URL,说明尚未完成发布,需返回重新操作;切勿使用「测试链接」或「分享链接」里的ID,它们不是Web SDK所需的bot_id。
获取并配置网页嵌入代码
在「发布设置」页向下滚动,找到「嵌入代码」区域,点击「复制代码」按钮,得到一段以 <script src="https://lf-cdn.coze.cn/obj/unpkg/flow-platform/chat-app-sdk/... 开头的JS代码。
这段代码默认包含基础配置:悬浮球位置、宽高、图标路径等。如需自定义,可手动修改其中的 botId、width、themeColor、avatar 等字段——例如把 width: "360px" 改成 width: "100%" 可适配移动端窄屏。
注意:【不要删除或改动 script 标签内的 src 地址】,该地址指向CDN上的最新版Chat SDK,手动替换版本号可能导致功能异常或鉴权失效。
将代码插入博客HTML
第一步:打开你的博客源码(如Hexo的layout/_partial/footer.ejs、WordPress主题的footer.php、或静态HTML的</body>前);
第二步:将复制好的整段嵌入代码,粘贴到 </body> 标签上方;
第三步:保存文件,重新构建或刷新博客页面;
第四步:打开博客网页,右下角应出现悬浮球图标,点击即可展开聊天窗口——此时无需任何用户登录,访客直接开始对话。
如果悬浮球未出现,请检查浏览器控制台是否有 Failed to load resource 报错,大概率是 bot_id 错误或网络被拦截;若出现白屏对话框,说明知识库未启用或未上传文档,需返回扣子后台补全知识库并重新发布。


















