如何将 Asyntai AI 聊天机器人添加到 Adobe Commerce (Magento)

Magento 网站的分步指南

获取嵌入代码

步骤1:获取您的嵌入代码

首先,前往您的 Asyntai 仪表板并向下滚动到"嵌入代码"部分。复制您的专属嵌入代码,格式如下:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

注意: 以上代码仅为示例。您必须从仪表板复制您自己的专属嵌入代码,因为其中包含您的个人小部件 ID。

步骤 2:使用 Page Builder(推荐)

添加聊天机器人最简单的方法是使用 Page Builder 的 HTML 代码块:

  1. 登录您的 Magento 管理面板
  2. 转到 内容 → 页面
  3. 编辑您的首页(或任何您想添加聊天机器人的页面)
  4. 在页面构建器中,将"HTML 代码"元素拖放到页面上
  5. 粘贴您的Asyntai嵌入代码
  6. 点击"保存"
  7. 刷新缓存:系统 → 缓存管理 → 刷新 Magento 缓存

重要提示: 使用 Page Builder 仅将代码添加到单个页面。如需全站安装,请使用下面的 Layout XML 方法。

备选方案:使用 Layout XML(所有页面)

要将聊天机器人添加到所有页面,请在您的主题中创建一个布局文件:

  1. 导航到您的主题文件夹:app/design/frontend/[Vendor]/[theme]/
  2. 如果文件夹结构不存在则创建它:Magento_Theme/layout/
  3. 创建或编辑文件 default_head_blocks.xml
  4. 添加以下代码:
    <?xml version="1.0"?>
    <page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <head>
    <script src="https://asyntai.com/static/js/chat-widget.js" src_type="url" async="true" data-asyntai-id="YOUR_WIDGET_ID"/>
    </head>
    </page>
  5. YOUR_WIDGET_ID 替换为您的实际小部件 ID
  6. 运行:bin/magento cache:flush
  7. 运行:bin/magento setup:static-content:deploy -f(如果处于生产模式)

备选方案:使用 CMS 块

您也可以创建一个 CMS 块并将其包含在页脚中:

  1. 转到 内容 → 块
  2. 点击"添加新区块"
  3. 设置标题,例如"Asyntai Chatbot
  4. 将标识符设置为 asyntai_chatbot
  5. 在内容编辑器中,切换到 HTML 模式并粘贴您的嵌入代码
  6. 点击"保存区块"
  7. 使用以下方式将块添加到页脚模板中: {{block id="asyntai_chatbot"}}
  8. 刷新缓存

步骤3:验证安装

保存更改并刷新缓存后,在新的浏览器标签页或无痕窗口中访问您的商店。您应该会在右下角看到聊天小部件按钮。点击它以确保它能正常打开和运行。

看不到小部件? 请确保刷新所有缓存:系统 → 缓存管理 → 刷新 Magento 缓存。也请尝试清除浏览器缓存或在无痕窗口中查看。如果处于生产模式,请运行 bin/magento setup:static-content:deploy -f