Kentico'ya Asyntai AI Chatbot Nasıl Eklenir

Kentico CMS web siteleri için adım adım kılavuz

Platform:

Adım 1: Yerleştirme Kodunuzu Alın

Önce Asyntai Dashboard'unuza gidin ve "Yerleştirme Kodu" bölümüne inin. Şuna benzeyen benzersiz yerleştirme kodunuzu kopyalayın:

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

Not: Yukarıdaki kod yalnızca bir örnektir. Kişisel widget kimliğinizi içerdiğinden, kendi benzersiz yerleştirme kodunuzu Dashboard'unuzdan kopyalamanız gerekir.

Adım 2: Ana Sayfa Şablonuna Kod Ekleme (Önerilen)

Chatbot'u Kentico web sitenizin tüm sayfalarına aynı anda eklemek için Ana Sayfa Şablonu yöntemini kullanın:

Kentico Admin'e giriş yapın ve Page templates uygulamasına gidin
Master page template'inizi (tüm sayfalarda kullanılan şablon) bulun ve açın
Şablon düzenleyicisinde Header sekmesine tıklayın
Header bölümüne Asyntai gömme kodunuzu yapıştırın
Alternatif olarak, kodu şablonun düzenine kapanış </head> etiketinden önce ekleyin
Değişiklikleri uygulamak için Save düğmesine tıklayın
Sitenizin önbelleğini temizleyin ve değişiklikleri canlı sitede doğrulayın

İpucu: Ana Sayfa Şablonunu kullanmak, chatbot'un bu şablondan miras alan her sayfada görünmesini sağlar. Bu, Kentico'da site genelinde dağıtım için en verimli yöntemdir.

Alternatif Yöntem 1: Sayfa Şablonu Header'ı

Chatbot'u yalnızca belirli sayfa şablonlarına eklemek istiyorsanız:

Kentico Yönetici'de Page templates uygulamasına gidin
Düzenlemek istediğiniz belirli sayfa şablonunu seçin
Header sekmesine tıklayın
Asyntai gömme kodunuzu bir script etiketi kullanarak ekleyin:

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

Save düğmesine tıklayın
Bu şablonu kullanan tüm sayfalar artık chatbot'u içerecektir

Not: Bu yöntem, chatbot'u tüm site yerine aynı sayfa şablonunu paylaşan belirli bölümlere eklemek istediğinizde faydalıdır.

Alternatif Yöntem 2: HEAD HTML Web Part

Belirli sayfalarda daha ayrıntılı kontrol veya alt sayfalar arasında kalıtılabilir JavaScript için:

Düzenlemek istediğiniz sayfayı Kentico Page editor'de açın
Sayfaya yeni bir web part ekleyin (kalıtım için tercihen bir üst sayfaya)
HEAD HTML web part'ını arayın ve seçin
Web part yapılandırmasına Asyntai gömme kodunuzu yapıştırın
Alt sayfaların chatbot'a sahip olmasını istiyorsanız web part'ı kalıtılabilir olarak yapılandırın
Web part'ı kaydetmek için OK düğmesine tıklayın
Sayfayı kaydedin ve yayınlayın

İpucu: HEAD HTML web part, tüm alt sayfalara otomatik olarak yayılacak şekilde bir üst sayfaya kod eklemek için mükemmeldir ve bölüm genelinde bir kurulum oluşturur.

Alternatif Yöntem 3: Özel JavaScript Dosyaları (İleri Düzey)

Scriptleri dosya olarak yönetmeyi tercih eden geliştiriciler için:

Kentico projenizde ~/CMSScripts/Custom/ dizinine gidin
asyntai-widget.js adında yeni bir JavaScript dosyası oluşturun
Asyntai widget'ınızı dinamik olarak yüklemek için kod ekleyin:

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

Bu dosyayı Ana Sayfa Şablonunuzun header'ında referans verin:

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

Önemli: Bu ileri düzey yöntem, dosya sistemi erişimi ve Kentico'nun dizin yapısı bilgisi gerektirir. Uygun izinlere sahip olduğunuzdan emin olun ve her zaman önce hazırlık ortamında test edin.

Adım 3: Kurulumu Doğrulayın

Değişikliklerinizi kaydedip önbelleği temizledikten sonra, web sitenizi yeni bir tarayıcı sekmesinde veya gizli pencerede açın. Sağ alt köşede sohbet widget düğmesini görmelisiniz. Doğru şekilde açıldığından ve çalıştığından emin olmak için üzerine tıklayın.

Widget'ı göremiyor musunuz? Tüm değişiklikleri kaydettiğinizden ve Kentico önbelleğini temizlediğinizden emin olun (Settings > System > Clear cache). Sitenizi gizli pencerede görüntülemeyi deneyin. Widget'ın yüklenmesini engelleyebilecek JavaScript hataları için tarayıcı konsolunu (F12) kontrol edin.