如何将 Asyntai AI 聊天机器人添加到 Drupal

Drupal 网站的分步指南

平台：

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

首先，前往您的Asyntai 控制面板，向下滚动到"嵌入代码"部分。复制您专属的嵌入代码，它看起来如下：

<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：使用 Header and Footer Scripts 模块（推荐）

添加聊天机器人最简单的方法是使用"Header and Footer Scripts"模块：

登录您的 Drupal 管理面板
前往扩展并点击"安装新模块"
Search for "Header and Footer Scripts" or download it from Drupal.org
安装并启用该模块
转到配置 → 开发 → Header and Footer Scripts
点击"页脚"选项卡
将您的 Asyntai 嵌入代码粘贴到页脚脚本文本区域
点击"保存配置"

提示： 将代码添加到页脚部分可确保它在页面内容之后加载，这是聊天小部件的推荐做法。

替代方案：编辑主题模板

您可以将代码直接添加到主题的模板文件中：

导航到主题文件夹：themes/your_theme/
打开 html.html.twig 文件（如果不存在则创建一个）
找到</body>闭合标签
将您的Asyntai嵌入代码粘贴在</body>标签之前
保存文件
清除 Drupal 缓存：配置 → 性能 → 清除所有缓存

重要提示： 更新主题时，对主题文件的更改可能会被覆盖。建议使用子主题或 Header and Footer Scripts 模块以获得更持久的解决方案。

替代方案：使用库（适用于开发者）

对于偏好使用 Drupal 资源库系统的开发者：

创建或编辑主题的 *.libraries.yml 文件
添加新的库条目：
asyntai-chatbot: js: https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } }
在主题的 *.info.yml 文件中附加库：
libraries: - your_theme/asyntai-chatbot
清除 Drupal 缓存

步骤3：验证安装

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