如何将 Asyntai AI 聊天机器人添加到任何网站

适用于 HTML、自定义站点和静态生成器的通用指南

获取嵌入代码

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

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

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

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

步骤 2:添加到您的 HTML 文件

添加聊天机器人最简单的方式是将嵌入代码直接粘贴到 HTML 文件中:

  1. 在文本编辑器中打开您的 HTML 文件
  2. 找到</body>闭合标签
  3. 将您的Asyntai嵌入代码粘贴到</body>标签之前
  4. 保存文件
<!DOCTYPE html>
<html>
<head>
  <title>My Website</title>
</head>
<body>
  <!-- Your website content -->

  <!-- Asyntai Chatbot - Add before closing body tag -->
  <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</body>
</html>

提示:</body> 闭合标签之前添加脚本可确保它在页面内容之后加载,这对性能最优,不会减慢页面速度。

对于多页面网站

如果您的网站有多个 HTML 页面,您有以下几种选择:

选项 A:添加到每个页面

将嵌入代码添加到每个您希望聊天机器人出现的 HTML 文件中。

选项 B:使用通用页脚包含

如果您使用服务器端包含(SSI)、PHP 包含或类似技术:

  1. 创建一个 footer.html(或 footer.php)文件
  2. 将 Asyntai 嵌入代码添加到此文件中
  3. 在所有页面中包含此页脚文件:
    <!-- For PHP -->
    <?php include 'footer.php'; ?>

    <!-- For SSI -->
    <!--#include virtual="/footer.html" -->

选项 C:JavaScript 动态加载

创建一个在所有页面上加载聊天机器人的 JavaScript 文件:

  1. 创建一个名为 asyntai-loader.js 的文件:
    (function() {
      var script = document.createElement('script');
      script.async = true;
      script.src = 'https://asyntai.com/static/js/chat-widget.js';
      script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
      document.body.appendChild(script);
    })();
  2. YOUR_WIDGET_ID 替换为您的实际小部件 ID
  3. 在所有页面中包含此脚本:
    <script src="/js/asyntai-loader.js"></script>

对于静态站点生成器

如果您使用静态站点生成器,请将嵌入代码添加到基础布局或模板中:

Jekyll

添加到 _includes/footer.html_layouts/default.html

Hugo

添加到 layouts/partials/footer.htmllayouts/_default/baseof.html

Gatsby

Add to gatsby-browser.js or use gatsby-ssr.js

Next.js

添加到 pages/_document.js 或使用 next/script 组件

Nuxt.js

添加到 nuxt.config.jshead.script

Eleventy (11ty)

添加到 _includes/ 中的基础布局

Astro

src/layouts/Layout.astro</body> 之前添加

VuePress

添加到 .vuepress/config.jshead

对于 React / Vue / Angular 应用

对于单页应用(SPA),您可以将脚本添加到 index.html 或动态加载:

React(index.html 方法)

<!-- In public/index.html, before </body> -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

React(useEffect 方法)

// In your App.js or a component
useEffect(() => {
  const script = document.createElement('script');
  script.src = 'https://asyntai.com/static/js/chat-widget.js';
  script.async = true;
  script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
  document.body.appendChild(script);
  return () => document.body.removeChild(script);
}, []);

Vue(在 main.js 或 App.vue 中)

// In mounted() or onMounted()
const script = document.createElement('script');
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.async = true;
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);

Angular(在 index.html 中)

<!-- In src/index.html, before </body> -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

步骤3:验证安装

添加代码后,在新的浏览器标签页或无痕窗口中打开您的网站。您应该能在右下角看到聊天小部件按钮。点击它确保它能正常打开和运行。

看不到小部件? 检查脚本是否正确放置在 </body> 标签之前。确保浏览器控制台中没有 JavaScript 错误(按 F12 打开开发者工具)。尝试清除浏览器缓存或在无痕窗口中查看。

重要提示: 聊天机器人要求您的网站通过 HTTP 或 HTTPS 提供服务(不能直接以文件方式打开)。如果您在本地测试,请使用本地开发服务器。