本指南将带您完成将 FlowHunt 连接到 Shopify 商店、添加预设的 Shopify 聊天机器人流程、发布并将其嵌入您的店面。
前提条件
- 拥有可访问管理后台的 Shopify 商店
- 拥有可访问工作区的 FlowHunt 账号:https://app.flowhunt.io/
- 重要提示:FlowHunt 账号请使用与 Shopify 管理员账号相同的邮箱。
1) 将 Shopify 与 FlowHunt 集成(通过 Shopify 应用商店)
- 打开 Shopify 应用商店,搜索“FlowHunt”。
- 点击安装,如有提示请选择正确的商店。
- 审查所需权限,并点击“安装应用”/“授权”。
安装完成后,您会被重定向到 Shopify 和/或 FlowHunt。连接将通过应用商店的安装流程完成。

2) 在 Shopify 商店安装 FlowHunt 应用
- 在 Shopify 授权界面,检查所需权限。
- 点击“安装应用”完成安装。
3) 确认 Shopify 集成已启用
成功安装后,返回 FlowHunt → 集成。您应能看到 Shopify 显示为已连接/已启用。
如未启用,请再次点击“连接”并按照授权流程操作。

4) 从 Flow Library 添加 Shopify 聊天机器人
- 在 FlowHunt 中进入 Flow Library。
- 搜索“Shopify 聊天机器人”。
- 打开模板并点击“添加到工作区”。
这样会将一个可用的 Shopify 聊天机器人流程添加到您的工作区。

5) 按品牌个性化定制聊天机器人
打开刚添加的流程并调整:
- 系统提示与语气:设定品牌语调及边界。
- 知识源:连接产品目录、FAQ、政策或其他文档。
- 工具与操作:如有需要并计划支持,可启用订单查询、状态查询或 CRM 更新等功能。
- UI/品牌:后续可在 Chatbots 部分配置组件名称、欢迎语及可见标签。
完成后,点击“保存”更改。

6) 发布流程
点击流程上的“发布”,即可让该流程可被网站/店面上的聊天机器人使用。

7) 创建新的集成代码(聊天机器人)
- 在 FlowHunt 进入 Chatbots。
- 点击“新建集成代码”。
- 选择上一步发布的流程。
- 配置组件选项(主题、位置、打开方式、语言、域名白名单等)。
- 保存。FlowHunt 将生成一段脚本代码(您的集成代码)。
请妥善保存该代码 —— 下一步需粘贴到您的 Shopify 主题中。

8) 将聊天机器人嵌入您的 Shopify 店面
您有两种方式添加集成代码。请选择最适合您的方式。
方案 A — 添加到 theme.liquid(全站)
此方法会在商店所有页面显示聊天机器人。请按如下详细步骤操作:
步骤 1: 进入 Shopify 管理后台,选择在线商店 > 主题

步骤 2: 在当前主题旁点击自定义 步骤 3: 左上角点击三个点(⋯),选择编辑代码

步骤 4: 在 Layout 文件夹找到theme.liquid 文件(/layout/theme.liquid)

步骤 5: 将集成代码粘贴在 </body> 关闭标签之前
步骤 6: 按 Ctrl + S(或 Mac 上的 Cmd + S)保存更改
保存后,访问您的店面并刷新页面。聊天机器人应会出现在所有页面。

重要说明:
- 粘贴至
</body>前可确保所有页面加载组件 - 保持 FlowHunt 代码原样且不做修改
- 聊天机器人将在商店所有页面显示
方案 B — 通过自定义 Liquid 区块添加(指定页面)
此方法仅在指定页面或模板显示聊天机器人。适合仅在产品页、特定落地页等场景。
步骤 1: 进入在线商店 > 主题,在当前主题旁点击自定义

步骤 2: 导航到需要添加聊天机器人的模板(如产品页、集合页或某一指定页面)

步骤 3: 点击添加区块或添加版块(视主题而定) 步骤 4: 在可选项中找到并选择自定义 Liquid 步骤 5: 将 FlowHunt 集成代码粘贴到自定义 Liquid 内容区

步骤 6: 点击保存,再点击预览,即可在该模板测试聊天机器人

重要说明:
- 此方法可精确控制聊天机器人出现的位置
- 需在每个需要显示聊天机器人的模板重复此步骤
- 可在特定页面测试后再全站推广
- 聊天机器人仅在已配置的模板上显示
验证与测试
- 在无痕/隐私窗口打开店面,以避免缓存干扰
- 提问常见问题(如物流、退货、库存)验证流程效果
- 在 FlowHunt 查看会话日志(如需可开启详细模式),检查使用了哪些文档或工具
故障排查
- 聊天机器人未显示:确保集成代码已包含在页面、主题已发布,且域名已在 Chatbots 设置中允许
- 组件重复:移除重复代码,仅保留一个集成代码
- 回答缺失:核查流程的知识源与文档检索设置,并重新发布
- Shopify 权限错误:在 FlowHunt → 集成下重新连接 Shopify,如有提示请重新安装
