Cara Menambah Chatbot AI Asyntai ke Kentico

Panduan langkah demi langkah untuk laman web CMS Kentico

Platform:

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 Kod ke Templat Halaman Induk (Disyorkan)

Untuk menambah chatbot ke semua halaman laman web Kentico anda sekaligus, gunakan kaedah Templat Halaman Induk:

Log masuk ke Pentadbir Kentico anda dan navigasi ke aplikasi Page templates
Cari dan buka Templat halaman induk anda (templat yang digunakan merentasi semua halaman)
Klik pada tab Header dalam editor templat
Dalam bahagian header, tampal kod benam Asyntai anda
Sebagai alternatif, tambah kod ke susun atur templat sebelum tag penutup </head>
Klik Save untuk menerapkan perubahan
Kosongkan cache laman anda dan sahkan perubahan pada laman langsung

Petua: Menggunakan Templat Halaman Induk memastikan chatbot muncul pada setiap halaman yang mewarisi dari templat ini. Ini ialah kaedah paling cekap untuk pelaksanaan seluruh laman dalam Kentico.

Kaedah Alternatif 1: Header Templat Halaman

Jika anda mahu menambah chatbot ke templat halaman tertentu sahaja:

Pergi ke aplikasi Page templates dalam Pentadbir Kentico
Pilih templat halaman tertentu yang anda mahu edit
Klik pada tab Header
Tambah kod benam Asyntai anda menggunakan tag skrip:

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

Klik Save
Semua halaman yang menggunakan templat ini kini akan menyertakan chatbot

Nota: Kaedah ini berguna apabila anda mahu menambah chatbot ke bahagian tertentu laman anda yang berkongsi templat halaman yang sama, dan bukannya seluruh laman.

Kaedah Alternatif 2: Web Part HEAD HTML

Untuk kawalan yang lebih terperinci pada halaman tertentu atau untuk JavaScript yang boleh diwarisi merentasi subhalaman:

Buka halaman yang anda mahu edit dalam editor Halaman Kentico
Tambah web part baharu ke halaman (sebaiknya dalam halaman induk untuk pewarisan)
Cari dan pilih web part HEAD HTML
Dalam konfigurasi web part, tampal kod benam Asyntai anda
Konfigurasikan web part untuk boleh diwarisi jika anda mahu halaman anak mempunyai chatbot
Klik OK untuk menyimpan web part
Simpan dan terbitkan halaman

Petua: Web part HEAD HTML sesuai untuk menambah kod ke halaman induk yang akan disebarkan secara automatik ke semua halaman anak, mewujudkan pemasangan seluruh bahagian.

Kaedah Alternatif 3: Fail JavaScript Tersuai (Lanjutan)

Untuk pembangun yang lebih suka mengurus skrip sebagai fail:

Dalam projek Kentico anda, navigasi ke direktori ~/CMSScripts/Custom/
Buat fail JavaScript baharu (contohnya, asyntai-widget.js)
Tambah kod untuk memuatkan widget Asyntai anda secara dinamik:

(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);
})();

Rujuk fail ini dalam header Templat Halaman Induk anda:

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

Penting: Kaedah lanjutan ini memerlukan akses sistem fail dan pengetahuan tentang struktur direktori Kentico. Pastikan anda mempunyai kebenaran yang betul dan sentiasa uji dalam persekitaran pementasan terlebih dahulu.

Langkah 3: Sahkan Pemasangan

Selepas menyimpan perubahan anda dan mengosongkan cache, 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 anda telah menyimpan semua perubahan dan mengosongkan cache Kentico (Settings > System > Clear cache). Cuba lihat laman anda dalam tetingkap inkognito. Semak konsol pelayar (F12) untuk sebarang ralat JavaScript yang mungkin menghalang widget daripada dimuatkan.