安装指南 / Shopify
在 Shopify 上安装 Embent
在你的主题代码里加一段脚本,不用安装任何 App。只要能打开主题编辑器,几分钟就能完成。
开始之前
- 拥有商城主题代码的编辑权限(只有在主题被购买/添加到你的商城之后才能编辑它的代码)。
- 聊天插件不会出现在 Shopify 的结账页、感谢页或订单状态页——对于未使用 Shopify Plus 的商城,Shopify 会在这些页面屏蔽自定义脚本。
步骤
1
复制你的嵌入代码
在你的 Embent 控制台里,打开机器人的概览页面并复制嵌入代码。它看起来是这样的:
<script src="https://api.embent.com/widget.js" data-bot="YOUR_BOT_ID" async></script>2
打开你的主题代码
在 Shopify 后台,进入 Online Store → Themes。在当前主题上点击 ⋯ 菜单,选择 Edit code。Shopify 建议先复制一份主题,因为与之后主题更新不兼容的代码改动会被自动移除。
3
把代码粘贴到 theme.liquid 的 </body> 之前
在 Layout 文件夹中打开 theme.liquid,滚动到文件底部的结束 </body> 标签,把代码粘贴在它上方。点击 Save。
确认是否成功
在新的浏览器标签页中重新加载你的商城首页(不是结账页):聊天气泡会出现在角落。问它一个关于你自己页面的问题,它应该会带着引用来源作答。
如果不生效
试过了但聊天插件没显示?这些方法能解决几乎所有情况。
我添加了嵌入代码,但聊天插件没有出现——没有聊天气泡,没有启动按钮,网站上什么都没有四项检查能解决几乎所有"插件不显示"的情况。第一,打开你的正式网站,查看页面源代码(右键 → 查看网页源代码),搜索"embent"——如果脚本不在其中,说明代码没有保存到已发布的页面上。第二,确认代码片段里的 data-bot ID 和你控制台"设置"里显示的一致。第三,清除网站的页面缓存和任何 CDN 缓存——缓存页面会继续显示没有插件的旧版本。第四,检查机器人是否在控制台中被暂停:暂停的机器人会刻意对访客不显示任何内容。
聊天气泡没有出现,并且我使用了加速优化 App(Booster、Hyperspeed 或类似工具)"延迟 JavaScript 直到有交互"的加速 App 可能会改写或推迟 Embent 的脚本。这个聊天插件本身能应对这种情况,但如果仍然不出现,把"embent"加入该 App 的排除列表——这类 App 都有这个功能——然后重新加载商城首页。
常见问题
结账时会显示聊天插件吗?不会。对于未使用 Shopify Plus 的商城,Shopify 会限制结账页面上的自定义代码,所以聊天插件只会出现在商城页面,不会出现在结账、订单状态或感谢页面。
主题更新会移除这段代码吗?有可能——主题更新时,Shopify 会移除与更新不兼容的代码改动。自定义前先复制一份主题,并在每次主题更新后重新检查这段代码。
需要开发人员或 App 吗?不需要。粘贴一段脚本就够了——不用安装 App,除了找到结束 body 标签之外也不需要任何 Liquid 知识。
现在就把 Embent 接入你的网站。AI agent 宁愿说"我不知道",也不会编造答案。免费套餐,无需信用卡—大多数网站两分钟内就能开始回答访客问题。
角落里的聊天气泡就是 Embent 本身,正运行在这个页面上——问它任何关于我们的问题。