Dashboard'a Dön

Belgeler

Asyntai'yi nasıl kullanacağınızı öğrenin

Asyntai AI Chatbot Umbraco'ya Nasıl Eklenir

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

Yerleştirme Kodunu Al

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: Master Şablonu Düzenleme (Önerilen)

Chatbot'u tüm sayfalara eklemenin en kolay yolu Master şablonunuzu düzenlemektir:

  1. Umbraco Backoffice'inize giriş yapın
  2. Sol kenar çubuğunda Ayarlar bölümüne gidin
  3. Templates bölümünü genişletin
  4. Master şablonunuza (veya sitenizin kullandığı ana düzen şablonuna) tıklayın
  5. Kapanış </body> etiketini bulun
  6. Asyntai yerleştirme kodunuzu </body> etiketinin hemen öncesine yapıştırın
  7. "Kaydet"'e tıklayın

İpucu: Komut dosyasını kapanış </body> etiketinin öncesine eklemek, sayfa içeriğinden sonra yüklenmesini sağlar; bu, sohbet widget'ları için önerilir ve sayfa yüklemenizi yavaşlatmaz.

Alternatif: Site Settings Belge Türü Kullanma

Daha fazla esneklik için, alt bilgi betiklerini yönetmek üzere özel bir alan ekleyebilirsiniz:

  1. Settings → Document Types bölümüne gidin
  2. Site Settings belge türünüzü düzenleyin (yoksa yeni bir tane oluşturun)
  3. Textarea veri türüyle "Footer Scripts" adında yeni bir özellik ekleyin
  4. Belge Türünü kaydedin
  5. Go to Content and edit your Site Settings node
  6. Asyntai gömme kodunuzu Footer Scripts alanına yapıştırın
  7. Master şablonunuzda, </body> etiketinden önce bu kodu ekleyin:
    @Html.Raw(Model.Value("footerScripts"))
  8. Hem içeriği hem de şablonu kaydedin

Not: Betik etiketlerini HTML kodlaması olmadan düzgün şekilde render etmek için @Html.Raw() kullanmak önemlidir.

Alternatif: Scripts Klasörü Kullanma

Umbraco Backoffice'te bir JavaScript dosyası da oluşturabilirsiniz:

  1. Settings → Scripts bölümüne gidin
  2. Scripts üzerine sağ tıklayın ve "Create" seçeneğini seçin
  3. asyntai-chatbot.js adında yeni bir dosya oluşturun
  4. Aşağıdaki kodu ekleyin:
    (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);
    })();
  5. Replace YOUR_WIDGET_ID with your actual widget ID
  6. Dosyayı kaydedin
  7. Bu betiği Master şablonunuzda </body> etiketinden önce ekleyin:
    <script src="/scripts/asyntai-chatbot.js"></script>

Alternatif: RenderSection ile Sayfaya Özel Ekleme

Chatbot'u yalnızca belirli sayfalarda istiyorsanız:

  1. Master şablonunuzda, </body> etiketinden önce ekleyin:
    @RenderSection("footerScripts", required: false)
  2. Chatbot'u istediğiniz belirli sayfa şablonuna ekleyin:
    @section footerScripts {
      <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
    }

Adım 3: Kurulumu Doğrulayın

Değişikliklerinizi kaydettikten sonra, web sitenizi yeni bir tarayıcı sekmesinde veya gizli pencerede ziyaret edin. 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öremiyorsunuz mu? Değişiklik yaptıktan sonra şablonu kaydettiğinizden emin olun. Tarayıcı önbelleğinizi temizlemeyi veya gizli pencerede görüntülemeyi deneyin. Umbraco Cloud kullanıyorsanız değişiklikler otomatik olarak dağıtılmalıdır. Kendi sunucunuzda barındırılan Umbraco için uygulamayı yeniden başlatmanız veya önbelleği temizlemeniz gerekebilir.