安装指南 / HTML 与自建网站
在任意 HTML 网站上安装 Embent
一段脚本,没有构建步骤,不依赖任何框架。只要你能编辑 HTML,一分钟内就能搞定。
开始之前
- 能够编辑你网站所使用的 HTML 文件或模板。
步骤
1
复制你的嵌入代码
在你的 Embent 控制台里,打开机器人的概览页面并复制嵌入代码。它看起来是这样的:
<script src="https://api.embent.com/widget.js" data-bot="YOUR_BOT_ID" async></script>2
粘贴到结束的 </body> 标签之前
打开渲染每个页面的文件或模板——在大多数静态网站上通常是共享的布局或页脚 include——把代码粘贴在结束的 </body> 标签之前。
3
发布你的改动
像往常一样上传或部署这个修改过的文件。
确认是否成功
重新加载你的网站:聊天气泡会出现在角落。问它一个关于你自己页面的问题,它应该会带着引用来源作答。
如果不生效
试过了但聊天插件没显示?这些方法能解决几乎所有情况。
我添加了嵌入代码,但聊天插件没有出现——没有聊天气泡,没有启动按钮,网站上什么都没有四项检查能解决几乎所有"插件不显示"的情况。第一,打开你的正式网站,查看页面源代码(右键 → 查看网页源代码),搜索"embent"——如果脚本不在其中,说明代码没有保存到已发布的页面上。第二,确认代码片段里的 data-bot ID 和你控制台"设置"里显示的一致。第三,清除网站的页面缓存和任何 CDN 缓存——缓存页面会继续显示没有插件的旧版本。第四,检查机器人是否在控制台中被暂停:暂停的机器人会刻意对访客不显示任何内容。
聊天气泡出现了,但回复一直没有到达,或者插件缺失,而且我的网站设置了 Content-Security-Policy把 https://api.embent.com 同时加入 script-src(加载插件脚本)和 connect-src(聊天回复流会连回同一个源)。少了 script-src 会让插件完全不显示;少了 connect-src 会让气泡出现但回答永远不会流入。
我使用了带 Rocket Loader 的 Cloudflare,插件时有时无或缺失Rocket Loader 会通过自己的加载器延迟脚本。这个聊天插件本身能应对这种情况,但如果它仍然无法出现,给 Embent 的脚本标签加上 data-cfasync="false"——这是 Rocket Loader 官方的退出方式——脚本就会正常加载。
常见问题
支持 React、Vue、Next.js 或其他框架吗?支持。只需在根 HTML 模板——index.html 或你的根布局——里粘贴一次代码。这个聊天插件运行在 Shadow DOM 中,不会干扰你的框架;不需要额外的包装组件。
会拖慢我的网站吗?不会。脚本异步加载,聊天插件压缩后不到 50KB,也没有自带任何框架,所以永远不会阻塞页面渲染。
需要在每个页面都添加吗?只需要加到共享的模板里。跳过共享布局的页面需要单独添加这段代码。
现在就把 Embent 接入你的网站。AI agent 宁愿说"我不知道",也不会编造答案。免费套餐,无需信用卡—大多数网站两分钟内就能开始回答访客问题。
角落里的聊天气泡就是 Embent 本身,正运行在这个页面上——问它任何关于我们的问题。