Cara Menambahkan Chatbot AI Asyntai ke Kentico

Panduan langkah demi langkah untuk situs web CMS Kentico

Platform:

Langkah 1: Dapatkan Kode Embed Anda

Pertama, buka Dasbor Asyntai dan gulir ke bawah ke bagian "Kode Embed". Salin kode embed unik Anda yang akan terlihat seperti ini:

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

Catatan: Kode di atas hanya contoh. Anda harus menyalin kode embed unik Anda sendiri dari Dasbor karena berisi ID widget personal Anda.

Langkah 2: Tambahkan Kode ke Template Master Page (Disarankan)

Untuk menambahkan chatbot ke semua halaman situs web Kentico Anda sekaligus, gunakan metode Template Master Page:

Masuk ke Kentico Admin Anda dan navigasi ke aplikasi Page templates
Temukan dan buka template Master page Anda (template yang digunakan di semua halaman)
Klik pada tab Header di editor template
Di bagian header, tempelkan kode embed Asyntai Anda
Sebagai alternatif, tambahkan kode ke layout template sebelum tag penutup </head>
Klik Save untuk menerapkan perubahan
Bersihkan cache situs Anda dan verifikasi perubahan di situs live

Tip: Menggunakan Template Master Page memastikan chatbot muncul di setiap halaman yang mewarisi dari template ini. Ini adalah metode paling efisien untuk deployment seluruh situs di Kentico.

Metode Alternatif 1: Header Template Halaman

Jika Anda ingin menambahkan chatbot hanya ke template halaman tertentu:

Buka aplikasi Page templates di Kentico Admin
Pilih template halaman tertentu yang ingin Anda edit
Klik pada tab Header
Tambahkan kode embed 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 template ini sekarang akan menyertakan chatbot

Catatan: Metode ini berguna ketika Anda ingin menambahkan chatbot ke bagian tertentu dari situs Anda yang berbagi template halaman yang sama, bukan ke seluruh situs.

Metode Alternatif 2: Web Part HEAD HTML

Untuk kontrol yang lebih terperinci pada halaman tertentu atau untuk JavaScript yang dapat diwarisi di seluruh subhalaman:

Buka halaman yang ingin Anda edit di editor Halaman Kentico
Tambahkan web part baru ke halaman (sebaiknya di halaman induk untuk pewarisan)
Cari dan pilih web part HEAD HTML
Di konfigurasi web part, tempelkan kode embed Asyntai Anda
Konfigurasikan web part agar dapat diwarisi jika Anda ingin halaman anak memiliki chatbot
Klik OK untuk menyimpan web part
Simpan dan publikasikan halaman

Tip: Web part HEAD HTML sempurna untuk menambahkan kode ke halaman induk yang akan secara otomatis menyebar ke semua halaman anak, menciptakan instalasi seluruh bagian.

Metode Alternatif 3: File JavaScript Kustom (Lanjutan)

Untuk pengembang yang lebih suka mengelola skrip sebagai file:

Di proyek Kentico Anda, navigasi ke direktori ~/CMSScripts/Custom/
Buat file JavaScript baru (misalnya, asyntai-widget.js)
Tambahkan kode untuk memuat widget Asyntai Anda secara dinamis:

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

Referensikan file ini di header Template Master Page Anda:

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

Penting: Metode lanjutan ini memerlukan akses sistem file dan pengetahuan tentang struktur direktori Kentico. Pastikan Anda memiliki izin yang tepat dan selalu uji di lingkungan staging terlebih dahulu.

Langkah 3: Verifikasi Instalasi

Setelah menyimpan perubahan dan membersihkan cache, buka situs web Anda di tab browser baru atau jendela penyamaran. Anda akan melihat tombol widget obrolan di pojok kanan bawah. Klik untuk memastikan widget terbuka dan berfungsi dengan benar.

Tidak melihat widget? Pastikan Anda telah menyimpan semua perubahan dan membersihkan cache Kentico (Settings > System > Clear cache). Coba lihat situs Anda di jendela penyamaran. Periksa konsol browser (F12) untuk kesalahan JavaScript yang mungkin mencegah widget dimuat.