Yardım Merkezi
Web sitesine chatbot ekleme

Web sitenize chatbot ekleme

Son güncelleme:

ChatLab'i web sitenize eklemek, ziyaretçilerinizin doğrudan siteniz üzerinden yapay zeka chatbot'unuzla etkileşime girmesini sağlar. Bu kılavuz, yerleştirme kodunu nasıl alacağınızı ve web sitenize nasıl ekleyeceğinizi açıklar.

Başlamadan önce

Chatbot'unuzu müşterilerle paylaşmadan önce oluşturun ve eğitin. Kurulum için web sitesini düzenleme ve yayınlama iznine de ihtiyacınız vardır. Bkz. İlk chatbot'unuzu oluşturma.

Test & Deploy sekmesini açma

Ana kontrol panelinden chatbot'unuzu seçin ve ardından Test & Deploy (Test Et ve Yayına Al) sekmesine tıklayın. Ayrıca chatbot'un Overview (Genel Bakış) ekranındaki yeşil Test chatbot butonuna da tıklayabilirsiniz. Bu sekme iki bölümden oluşur:

  • Test (sol) - chatbot'unuzun web sitenizi taklit eden bir alanda canlı olarak çalışmasını sağlar; böylece ziyaretçiler görmeden önce onu deneyebilirsiniz. Widget modunda sohbet penceresi, tıpkı ziyaretçilerin göreceği gibi, gerçek boyutunda sağ alt köşede ve hemen altında sohbet simgesiyle yer alır. Alanın sağ üst köşesindeki Widget / Frame anahtarı, iframe kodunun sağladığı her zaman açık sohbet görünümü olan Frame moduna geçiş yapar.
  • Deploy (sağ) - web sitesi platformunu veya mesajlaşma kanalını seçip ilgili talimatları takip ettiğiniz yerdir. Altındaki Share a test link (Test bağlantısı paylaş) seçeneği, başkalarına gönderebileceğiniz bağlantılar sunar (bkz. Chatbot'unuza giden bir bağlantı gönderme).

Test & Deploy sekmesi vurgulanmış

Chatbot'un arkasında web siteniz

Chatbot'unuz tek bir web sitesi üzerinden eğitildiğinde, chatbot'un kendi sayfalarınızda nasıl göründüğünü anlayabilmeniz için sohbet penceresinin arkasında o web sitesinin bir ekran görüntüsü gösterilir. Ekran görüntüsü sekmeyi ilk açtığınızda bir defa alınır (hazır olana kadar alanda genel bir sayfa taslağı görünür ve chatbot zaten çalışır durumdadır) ve saklanır; yalnızca adresi değiştirdiğinizde yenisi alınır. Birden fazla web sitesiyle veya yalnızca dosyalar ve metinlerle eğitilen chatbot'lar ise bunun yerine nötr bir sayfa taslağı gösterir.

Arka planı yönetmek için alanın üst kısmındaki web sitesi adresine tıklayın:

  • Save (Kaydet) ile birlikte Website address (Web sitesi adresi) - örneğin bir ürün sayfası gibi farklı bir sayfa gösterin. Try again (Tekrar dene), başarısız olan bir ekran görüntüsü alma işlemini yineler.
  • Hide background (Arka planı gizle) / Show background (Arka planı göster) - ekran görüntüsünü silmeden kapatıp açın.
  • Remove background (Arka planı kaldır) - ekran görüntüsünü silin. Yeniden bir adres girene kadar alanda nötr taslak gösterilir.

Arka plan yalnızca yönetim panelindeki bir önizlemedir. Web sitenizde hiçbir şeyi değiştirmez.

Platformunuzu seçme

Where do you want to add the chatbot? (Chatbot'u nereye eklemek istiyorsunuz?) başlığı altındaki Deploy (Yayına al) bölümü, desteklenen hedefleri üç grupta listeler: Kontrol ettiğiniz sayfalara chatbot yerleştirmek için Website (Web sitesi), genişletmek için başlığa tıklayabileceğiniz Online store platforms (Çevrim içi mağaza platformları) ve mevcut bir konuşma hesabına bağlamak için Messaging channels (Mesajlaşma kanalları). Chatbot'un görünmesini istediğiniz konuma uygun girişe tıklayarak özel talimatları görebilirsiniz.

Deploy bölümünde vurgulanmış platform listesi

Desteklenen platformlar:

  • HTML Code - HTML kodunu düzenleyebildiğiniz her web sitesiyle çalışır
  • WordPress - resmi ChatLab eklentisi veya manuel kod ekleme yoluyla
  • Wix - Settings > Custom Code (Ayarlar > Özel Kod) yoluyla
  • Webflow - siteniz veya çalışma alanınız için özel kod erişimi etkinleştirilmiş olarak Site settings > Custom code (Site ayarları > Özel kod) yoluyla
  • PrestaShop - ChatLab PrestaShop modülü veya manuel kod ekleme yoluyla
  • Shopify - Shopify App Store'daki ChatLab uygulaması (temanızda bir app embed) veya theme.liquid dosyasındaki manuel kod yoluyla
  • WooCommerce - WordPress eklentisi veya manuel kod ekleme yoluyla
  • Shoper - Shoper App Store'daki ChatLab uygulaması veya manuel kod ekleme yoluyla
  • Abicart - Store design > Themes > Site header (Mağaza tasarımı > Temalar > Site üst bilgisi) yoluyla
  • Ecwid - Website > Overview > Custom JavaScript code (Web sitesi > Genel Bakış > Özel JavaScript kodu) yoluyla
  • CS-Cart - ChatLab eklentisi veya Design > Layouts > Custom HTML code (Tasarım > Düzenler > Özel HTML kodu) içindeki manuel kod yoluyla
  • BigCommerce - mağaza bağlandığında otomatik olarak veya Storefront > Script Manager (Vitrin > Komut Dosyası Yöneticisi) yoluyla eklenir

Mesajlaşma kanalları:

Mesajlaşma kanalları aşağıdaki embed kodunu kullanmaz. Halihazırda sahip olduğunuz bir hesaba bağlanırlar, bu nedenle bir web sitesine hiçbir kod yapıştırılmaz.

Her platform, söz konusu entegrasyona özel adım adım talimatlar gösterir. Özel yardım makaleleri bulunan platformlar için altta bir View full instructions (Tüm talimatları görüntüle) bağlantısı görünür.

HTML Code ile ekleme

HTML Code seçeneği, kaynak koduna erişiminiz olan her web sitesinde çalışır. İki yerleştirme seçeneği göreceksiniz: Widget ve Iframe.

Widget modu

Widget sekmesi, web sitenize bir sohbet simgesi ekleyen kodu gösterir. Ziyaretçiler simgeye tıkladığında bir sohbet penceresi açılır.

Widget sekmesi vurgulanmış

  1. Widget sekmesine tıklayın
  2. Kodu kopyalamak için Copy to clipboard (Panoya kopyala) butonuna tıklayın
  3. Web sitenizin <head> bölümünü bulun
  4. Kodu <head> bölümündeki son öğe olarak yapıştırın
  5. Chatbot simgesinin göründüğünü doğrulamak için tarayıcınızı yenileyin

Iframe modu

Iframe sekmesi, chatbot'u doğrudan sayfa içeriğinize gömen kodu gösterir. Chatbot her zaman görünür durumdadır ve diğer sayfa öğeleriyle çevrelenebilir.

Iframe sekmesi vurgulanmış

  1. Iframe sekmesine tıklayın
  2. Kodu kopyalamak için Copy to clipboard butonuna tıklayın
  3. Kodu, web sitenizin HTML'inde chatbot'un görünmesini istediğiniz herhangi bir yere yapıştırın
  4. Sayfa düzeninize uyacak şekilde width ve height niteliklerini ayarlayın

Hangisini seçeceğinizden emin değil misiniz? Ayrıntılı bir karşılaştırma için Widget ve Iframe arasındaki fark nedir? makalesini okuyun.

Eklenti veya uygulama ile ekleme: WordPress, WooCommerce, PrestaShop, Shopify, Shoper ve CS-Cart

ChatLab bu altı platform için kendi eklentisini, modülünü veya uygulamasını sunar. Chatbot'unuza bağladığınızda chatbot sitenize otomatik olarak eklenir, yani herhangi bir kod kopyalamanıza gerek kalmaz. Çevrim içi mağazalarda mağazayı da bağlar; böylece chatbot ürünlerinizi arayabilir ve sipariş durumunu kontrol edebilir. Kodu manuel olarak yapıştırmak da bir alternatif olarak mümkündür, ancak bu yalnızca sohbet penceresini (widget) görüntüler.

Bu platformlardan birini seçtiğinizde iki sekme görünür: Plugin Installation (Eklenti Kurulumu - önerilen) ve Manual Installation (Manuel Kurulum).

Get the plugin on WordPress.org butonu vurgulanmış WordPress platformu

Plugin Installation sekmesiyle Çevrim içi mağaza platformları altında seçilmiş Shopify

Eklenti Kurulumu (Plugin Installation - önerilen)

  1. Plugin Installation sekmesinin üst kısmındaki butona tıklayın: WordPress ve WooCommerce için Get the plugin on WordPress.org, PrestaShop için Download the ChatLab module (.zip), Shopify için Get the app in the Shopify App Store, Shoper için Get the app in the Shoper App Store veya CS-Cart için Download the ChatLab add-on (.tgz). PrestaShop butonu bir mağaza sayfası açmaz; modülü bilgisayarınıza tek bir ZIP dosyası (chatlab.zip) olarak indirir, bir sonraki adımda bunu mağazanıza yüklersiniz.
  2. Web sitenizin yönetici panelinde ChatLab eklentisini, modülünü veya uygulamasını kurun. PrestaShop için PrestaShop yönetim panelinizde Modules > Module Manager > Upload a module (Modüller > Modül Yöneticisi > Modül yükle) bölümünü açın ve indirilen ZIP dosyasını seçin. PrestaShop rehberinin tamamı PrestaShop'a chatbot nasıl eklenir sayfasındadır. CS-Cart için Add-ons > Downloaded add-ons bölümünü açın, dişli menüsünden Manual installation seçeneğini belirleyin ve indirilen dosyayı yükleyin.
  3. Orada ChatLab'i açın, ChatLab hesabınızla giriş yapın ve istendiğinde bu chatbot'u seçin. PrestaShop için kurulu modülde Configure ve ardından Connect my store seçeneğine tıklayın. CS-Cart için Marketing > ChatLab AI Chatbot bölümünü açın ve Continue seçeneğine tıklayın. WooCommerce mağazası için mağaza verilerinin de bağlanması amacıyla WooCommerce integration seçeneğini işaretli bırakın.
  4. Bağlantı otomatik olarak tamamlanır ve chatbot web sitenizde görünür. Shopify'da ayrıca Online Store > Themes > Customize > App embeds (Online Mağaza > Temalar > Özelleştir > Uygulama yerleştirmeleri) bölümünü açın, ChatLab AI Chat seçeneğini aktif hale getirin ve kaydedin. Sitenizi açıp bir test mesajı gönderin.

Her platform için tüm adımları ve ekran görüntülerini içeren özel bir rehber bulunmaktadır:

Shoper

Deploy (Yayına al) bölümündeki platform listesinden Shoper'ı seçin. Shoper App Store'daki ücretsiz ChatLab uygulamasını açmak için Plugin Installation sekmesinde Get the app in the Shoper App Store butonuna tıklayın.

Get the app in the Shoper App Store butonu vurgulanmış Shoper platformu

  1. Shoper App Store'dan ücretsiz ChatLab uygulamasını yükleyin. Uygulamayı Shoper yönetici panelinizde Add-ons and integrations > Applications altında da bulabilirsiniz.
  2. Shoper yöneticinizde ChatLab uygulamasını açın. ChatLab paneli yeni bir pencerede açılır.
  3. Şifrenizi belirleyin veya ChatLab hesabınızla giriş yapın ve istendiğinde mağazayı bu chatbot'a bağlayın.
  4. Mağazanız otomatik olarak bağlanır ve chatbot vitrininizde görünür.

Uygulama olmadan yalnızca sohbet widget'ını eklemek için Manual Installation sekmesine geçin, kodu kopyalayın, ardından Shoper yöneticinizde Add-ons and integrations > Custom integrations bölümüne gidin, kodu Page header alanına yapıştırın ve kaydedin. Chatbot'un göründüğünü doğrulamak için mağazanızı yenileyin. Adımların tamamı için Shoper ile Entegrasyon sayfasına bakın.

Manuel Kurulum (Manual Installation)

Manual Installation sekmesine geçin, kodu kopyalayın ve platformunuz için gösterilen adımları izleyerek sitenizin başlığına (header) yapıştırın. WordPress ve WooCommerce için bu işlem Insert Headers and Footers gibi bir kod ekleme eklentisiyle yapılır. Değişikliklerinizi yayımlayın ve sohbeti test edin. Chatbot'u yalnızca bir kez kurun; eklenti/uygulama yöntemini ya da manuel kodu kullanın, ikisini birden değil.

Diğer platformlar üzerinden ekleme

Wix, Webflow ve Abicart için yüklenecek bir eklenti yoktur: kodu sitenize kendiniz yapıştırırsınız. Ecwid için Ecwid App Market'teki ChatLab uygulaması mağazayı chatbot'unuza bağlar; sohbet widget'ı vitrininizde görünmezse kodu Custom JavaScript code (Özel JavaScript kodu) alanına veya mağazanızın gömülü olduğu web sitesine yapıştırın. BigCommerce için mağaza içerik erişimiyle bağlandığında ChatLab widget'ı sizin yerinize ekler; aksi takdirde kodu Script Manager içine yapıştırırsınız. Şunları görmek için Deploy (Yayına al) bölümünden platformu seçin:

  1. Widget ve Iframe seçeneklerine sahip embed kodu
  2. Platforma özel, adım adım yapıştırma talimatları
  3. Eksiksiz platform rehberine yönlendiren View full instructions (Tüm talimatları görüntüle) bağlantısı

Bu platformlar için eksiksiz rehberler:

GDPR uyumluluğu

Chatbot'unuzun yalnızca çerez onayı verildikten sonra yüklenmesine ihtiyacınız varsa CookieBot, Usercentrics ve Google Tag Manager'ı kapsayan entegrasyon kılavuzları için GDPR uyumluluğu için ChatLab kurulumu sayfasına bakın.

İçerik Güvenliği Politikası (CSP)

Web siteniz İçerik Güvenliği Politikası (CSP - Content Security Policy) başlıkları kullanıyorsa, chatbot'un çalışabilmesi için ChatLab alan adlarına izin vermeniz gerekir. Gerekli direktifler, Widget veya Iframe modunu kullanmanıza bağlı olarak değişir.

Widget modu

Widget, sayfanıza sohbet arayüzünü oluşturan bir komut dosyası yükler. Web sitenizin geri kalanı için geçerli olan politikayı değiştirmeyin; aşağıdaki ChatLab kaynaklarını mevcut CSP direktiflerinizle birleştirin:

script-src https://script.chatlab.com;
style-src https://script.chatlab.com https://fonts.googleapis.com 'unsafe-inline';
connect-src https://api.chatlab.com wss://api.chatlab.com;
font-src https://fonts.gstatic.com;

Varsayılan olarak widget, bazı stilleri satır içi (inline) olarak ekler. Politikanızın ayrıca satır içi yapılandırma komut dosyasını, örneğin bir CSP nonce veya hash değeri ile yetkilendirmesi gerekir. Botunuz ve ürün kartları tarafından kullanılan görsel kaynaklarına img-src içinde izin verin; ses ve etkinleştirilen diğer özellikler ek kaynaklar gerektirebilir. Bir ajans alan adı kullanıyorsanız, oluşturulan kod parçacığınızdaki alan adlarını kullanın.

CSP Safe Mode - unsafe-inline kullanımından kaçınma

Web sitenizin güvenlik politikası 'unsafe-inline' kullanımına style-src içinde izin vermiyorsa, CSP Safe Mode özelliğini etkinleştirebilirsiniz. Bu özellik, widget'ın kapsayıcı stil sayfasını harici bir CSS dosyasından yükler. Satır içi yapılandırma komut dosyanızı yetkilendirmez ya da her özel stilin ve etkinleştirilen özelliğin politikanıza uyacağını garanti etmez.

Etkinleştirmek için ChatLab betik etiketinden önce window.aichatbotCspSafe = true; ifadesini ekleyin:

<script>
  window.aichatbotApiKey = "YOUR_API_KEY";
  window.aichatbotCspSafe = true;
</script>
<script src="https://script.chatlab.com/aichatbot.js" defer></script>

CSP Safe Mode etkinleştirildiğinde, 'unsafe-inline' olmadan bir stil sayfası politikasını test edin. Başlangıç noktası şöyledir:

script-src https://script.chatlab.com;
style-src https://script.chatlab.com https://fonts.googleapis.com;
connect-src https://api.chatlab.com wss://api.chatlab.com;
font-src https://fonts.gstatic.com;

Iframe modu

Ana sayfa, kopyalanan iframe URL'sindeki kaynağa izin vermelidir. Standart ChatLab barındırma için mevcut politikaya şunu ekleyin:

frame-src https://api.chatlab.com;

İlgili makaleler