如何将 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 文件中:
- 在文本编辑器中打开您的 HTML 文件
- 找到
</body>闭合标签 - 将您的Asyntai嵌入代码粘贴到
</body>标签之前 - 保存文件
<!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 包含或类似技术:
- 创建一个 footer.html(或 footer.php)文件
- 将 Asyntai 嵌入代码添加到此文件中
- 在所有页面中包含此页脚文件:
<!-- For PHP -->
<?php include 'footer.php'; ?>
<!-- For SSI -->
<!--#include virtual="/footer.html" -->
选项 C:JavaScript 动态加载
创建一个在所有页面上加载聊天机器人的 JavaScript 文件:
- 创建一个名为 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);
})(); - 将
YOUR_WIDGET_ID替换为您的实际小部件 ID - 在所有页面中包含此脚本:
<script src="/js/asyntai-loader.js"></script>
对于静态站点生成器
如果您使用静态站点生成器,请将嵌入代码添加到基础布局或模板中:
添加到 _includes/footer.html 或 _layouts/default.html
添加到 layouts/partials/footer.html 或 layouts/_default/baseof.html
Add to gatsby-browser.js or use gatsby-ssr.js
添加到 pages/_document.js 或使用 next/script 组件
添加到 nuxt.config.js 的 head.script 下
添加到 _includes/ 中的基础布局
在 src/layouts/Layout.astro 的 </body> 之前添加
添加到 .vuepress/config.js 的 head 下
对于 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 提供服务(不能直接以文件方式打开)。如果您在本地测试,请使用本地开发服务器。
Weebly