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

Kentico CMS 网站的分步指南

平台：

步骤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：将代码添加到主页面模板（推荐）

要一次性将聊天机器人添加到 Kentico 网站的所有页面，请使用主页面模板方法：

登录 Kentico 管理后台并导航到 Page templates 应用
找到并打开您的主页面模板（所有页面使用的模板）
在模板编辑器中点击 Header 标签
在 header 部分，粘贴您的 Asyntai 嵌入代码
或者，在模板布局的 </head> 闭合标签之前添加代码
点击 Save 应用更改
清除站点缓存并在线上站点验证更改

提示： 使用主页面模板可确保聊天机器人出现在继承此模板的每个页面上。这是 Kentico 中全站部署最高效的方法。

替代方法 1：页面模板 Header

如果您只想将聊天机器人添加到特定的页面模板：

在 Kentico 管理后台中转到 Page templates 应用
选择您要编辑的特定页面模板
点击 Header 标签
使用 script 标签添加您的 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>

点击 Save
使用此模板的所有页面现在都将包含聊天机器人

注意： 当您想将聊天机器人添加到共享同一页面模板的站点特定部分，而不是整个站点时，此方法非常有用。

替代方法 2：HEAD HTML Web Part

用于在特定页面上进行更精细的控制，或在子页面之间继承 JavaScript：

在 Kentico 页面编辑器中打开您要编辑的页面
向页面添加新的 web part（最好在父页面中以实现继承）
搜索并选择 HEAD HTML web part
在 web part 配置中，粘贴您的 Asyntai 嵌入代码
如果希望子页面也有聊天机器人，请将 web part 配置为可继承
点击 OK 保存 web part
保存并发布页面

提示： HEAD HTML web part 非常适合将代码添加到父页面，它会自动传播到所有子页面，实现按部分安装。

替代方法 3：自定义 JavaScript 文件（高级）

适合喜欢以文件形式管理脚本的开发人员：

在您的 Kentico 项目中，导航到 ~/CMSScripts/Custom/ 目录
创建一个新的 JavaScript 文件（例如，asyntai-widget.js）
添加代码以动态加载您的 Asyntai 小部件：

(function() {
    var script = document.createElement('script');
    script.src = 'https://asyntai.com/static/js/chat-widget.js';
    script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
    script.async = true;
    document.head.appendChild(script);
})();

在母版页模板的头部引用此文件：

<script src="~/CMSScripts/Custom/asyntai-widget.js"></script>

重要提示： 此高级方法需要文件系统访问权限以及对 Kentico 目录结构的了解。请确保您拥有适当的权限，并始终先在测试环境中进行测试。

步骤3：验证安装

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

看不到小部件？ 请确保已保存所有更改并清除了 Kentico 的缓存（设置 > 系统 > 清除缓存）。尝试在无痕窗口中查看您的网站。检查浏览器控制台（F12）是否有任何可能阻止小部件加载的 JavaScript 错误。