Cara Menambah Chatbot AI Asyntai ke Mana-mana Laman Web

Panduan universal untuk HTML, laman tersuai, dan penjana statik

Dapatkan Kod Benam

Langkah 1: Dapatkan Kod Benam Anda

Pertama, pergi ke Papan Pemuka Asyntai anda dan tatal ke bawah ke bahagian "Kod Benam". Salin kod benam unik anda yang akan kelihatan seperti ini:

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

Nota: Kod di atas hanyalah contoh. Anda mesti menyalin kod benam unik anda sendiri dari Papan Pemuka anda kerana ia mengandungi ID widget peribadi anda.

Langkah 2: Tambah ke Fail HTML Anda

Cara paling mudah untuk menambah chatbot ialah menampal kod benam terus ke dalam fail HTML anda:

  1. Buka fail HTML anda dalam editor teks
  2. Cari tag penutup </body>
  3. Tampal kod benam Asyntai anda sejurus sebelum tag </body>
  4. Simpan fail
<!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>

Petua: Menambah skrip sebelum tag penutup </body> memastikan ia dimuatkan selepas kandungan halaman anda, yang optimum untuk prestasi dan tidak akan melambatkan halaman anda.

Untuk Laman Web Berbilang Halaman

If your website has multiple HTML pages, you have several options:

Pilihan A: Tambah ke Setiap Halaman

Tambah kod benam ke setiap fail HTML di mana anda mahu chatbot muncul.

Pilihan B: Gunakan Sertaan Footer Biasa

If you're using server-side includes (SSI), PHP includes, or similar:

  1. Buat fail footer.html (atau footer.php)
  2. Tambah kod benam Asyntai ke fail ini
  3. Sertakan fail footer ini dalam semua halaman anda:
    <!-- For PHP -->
    <?php include 'footer.php'; ?>

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

Pilihan C: Pemuatan Dinamik JavaScript

Buat satu fail JavaScript yang memuatkan chatbot pada semua halaman:

  1. Buat fail yang dipanggil 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. Gantikan YOUR_WIDGET_ID dengan ID widget sebenar anda
  3. Sertakan skrip ini dalam semua halaman anda:
    <script src="/js/asyntai-loader.js"></script>

Untuk Penjana Laman Statik

Jika anda menggunakan penjana laman statik, tambah kod benam ke susun atur asas atau templat anda:

Jekyll

Tambah ke _includes/footer.html atau _layouts/default.html

Hugo

Tambah ke layouts/partials/footer.html atau layouts/_default/baseof.html

Gatsby

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

Next.js

Tambah ke pages/_document.js atau gunakan komponen next/script

Nuxt.js

Tambah ke nuxt.config.js di bawah head.script

Eleventy (11ty)

Tambah ke susun atur asas anda dalam _includes/

Astro

Tambah ke src/layouts/Layout.astro sebelum </body>

VuePress

Tambah ke .vuepress/config.js di bawah head

Untuk Aplikasi React / Vue / Angular

Untuk aplikasi halaman tunggal (SPA), anda boleh menambah skrip ke index.html anda atau memuatkannya secara dinamik:

React (kaedah 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 (kaedah 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 (dalam main.js atau 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 (dalam 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>

Langkah 3: Sahkan Pemasangan

Selepas menambah kod, buka laman web anda dalam tab pelayar baharu atau tetingkap inkognito. Anda sepatutnya melihat butang widget sembang di sudut kanan bawah. Klik untuk memastikan ia terbuka dan berfungsi dengan betul.

Tidak nampak widget? Pastikan skrip diletakkan dengan betul sebelum tag </body>. Pastikan tiada ralat JavaScript dalam konsol pelayar anda (tekan F12 untuk membuka alat pembangun). Cuba kosongkan cache pelayar anda atau lihat dalam tetingkap inkognito.

Penting: Chatbot memerlukan laman web anda dihidangkan melalui HTTP atau HTTPS (tidak dibuka terus sebagai fail). Jika anda menguji secara tempatan, gunakan pelayan pembangunan tempatan.