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

Magento 网站的分步指南

平台：

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

First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

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

步骤 2：使用 Page Builder（推荐）

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

登录您的 Magento 管理面板
转到 内容 → 页面
编辑您的首页（或任何您想添加聊天机器人的页面）
在页面构建器中，将"HTML 代码"元素拖放到页面上
粘贴您的Asyntai嵌入代码
点击"保存"
刷新缓存：系统 → 缓存管理 → 刷新 Magento 缓存

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

备选方案：使用 Layout XML（所有页面）

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

导航到您的主题文件夹：app/design/frontend/[Vendor]/[theme]/
如果文件夹结构不存在则创建它：Magento_Theme/layout/
创建或编辑文件 default_head_blocks.xml
添加以下代码：
<?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>
将 YOUR_WIDGET_ID 替换为您的实际小部件 ID
运行：bin/magento cache:flush
运行：bin/magento setup:static-content:deploy -f（如果处于生产模式）

备选方案：使用 CMS 块

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

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

步骤3：验证安装

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