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

Concrete CMS（原 Concrete5）网站的分步指南

平台：

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

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

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

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

将聊天机器人添加到 Concrete CMS 网站所有页面的最佳方式是编辑主题的页脚文件：

提示： 在 </body> 闭合标签之前添加代码可确保聊天机器人在页面内容加载后再加载，从而提供更好的页面加载性能。此方法会自动将聊天机器人添加到使用此主题的每个页面。

如果您不想编辑主题文件，可以使用 Concrete CMS 内置的 HTML 块：

注意： HTML 块方法非常适合将聊天机器人添加到特定页面。如需全站安装，您需要在每个页面添加 HTML 块，或使用上述主题页脚方法。块的视觉位置不会影响聊天机器人的显示位置——它仍将显示在右下角。

您也可以将代码添加到主题的头部文件以实现全站安装：

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

提示： 请确保在 header.php 文件中使用 <?php View::element('header_required'); ?> 包含所需的头部元素，以便 Concrete CMS 正常运行。

对于需要更多控制权的开发者，可以创建自定义页面模板：

重要提示： 在进行更改之前，请务必备份主题文件。如果可能，请先在测试站点上测试修改。对主题文件的错误编辑可能会破坏网站的布局或功能。

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

看不到小部件？ 确保已清除 Concrete CMS 缓存（仪表板 → 系统和设置 → 清除缓存）。尝试在无痕窗口中查看您的网站。检查是否已保存并上传所有文件更改。打开浏览器控制台（F12）检查是否有 JavaScript 错误。