"Sitemize chatbot eklemek istiyoruz ama elimizde geliştirici yok" cümlesi, aslında artık gerçek bir engel değil. Modern bir chatbot kurulumu, bir eklenti yüklemekten veya bir sosyal medya pikseli eklemekten daha karmaşık olmak zorunda değil. Bu yazıda tek satır kodla kurulumun adımlarını, en yaygın platformlara özel notları ve kurulumda en sık yapılan hataları anlatıyoruz.
Kurulum akışı adım adım
Sohbotu'nda kurulum üç adıma indirgenmiştir ve toplamda genelde beş dakikayı geçmez.
- 1) Site adresinizi girin: panelde bot oluştururken yalnızca web sitenizin adresini yazmanız yeterlidir.
- 2) Asistan sayfalarınızı tarar: arka planda sistem sitenizin herkese açık sayfalarını ve varsa yüklediğiniz dokümanları okuyup bilgi tabanını otomatik oluşturur — siz metin kopyalayıp yapıştırmazsınız.
- 3) Tek satır kodu şablonunuza yapıştırın: panel size tek bir <script> satırı verir; bu satırı sitenizin şablonuna (genelde </body> etiketinden hemen önce) bir kere eklersiniz. Bu adım WordPress, Wix, Shopify veya tamamen özel yazılmış bir siteyseniz de aynıdır — chatbot, sitenizin altyapısından bağımsız çalışır.
Platforma özel kısa notlar
Kodun kendisi her yerde aynı olsa da, o kodu "nereye" yapıştıracağınız platforma göre küçük farklar gösterir.
- WordPress: Çoğu temada Görünüm > Tema Dosya Düzenleyici üzerinden footer.php dosyasına ekleme yapılabilir, ama tema güncellemelerinde bu değişiklik silinebilir. Daha güvenli yol, "Insert Headers and Footers" gibi basit bir eklenti kullanıp kodu oradaki footer alanına yapıştırmaktır — böylece tema güncellense de kod kalıcı olur.
- Wix: Site panelinde Ayarlar > Özel Kod (Custom Code) bölümünden kodu ekleyip "tüm sayfalarda" ve "body sonu" seçeneğiyle yayınlayabilirsiniz; Wix'in kendi yayınlama adımını (Publish) unutmayın, aksi halde değişiklik canlıya yansımaz.
- Shopify: Tema düzenleyicisinde theme.liquid dosyasını açıp kodu </body> etiketinden hemen önce yapıştırmanız yeterlidir; tema güncellemesi öncesi mevcut theme.liquid'i yedeklemeniz iyi bir alışkanlıktır.
- Özel yazılım / kendi altyapınız: Kod, sunucu tarafı diliniz ne olursa olsun (Node, PHP, Python, .NET) sadece HTML çıktısına eklenen istemci taraflı bir script'tir; genelde ortak layout/şablon dosyanıza tek satır eklemeniz yeterlidir.
Kodu yapıştırdıktan sonra ne oluyor?
Tek satır kodu ekledikten sonra ziyaretçiler sitenizin bir köşesinde küçük bir sohbet balonu görür; tıkladıklarında karşılarına, sitenizin ve yüklediğiniz dokümanların içeriğinden beslenen bir sohbet penceresi açılır. Bu noktadan sonra kurulum tamamlanmış olur ama iş bitmiş sayılmaz: ilk günlerde asistanın hangi soruları doğru yanıtlayıp hangilerinde zorlandığını panelinizdeki Yanıtsız Sorular listesinden takip etmeniz, asistanı gerçek ziyaretçi davranışına göre olgunlaştırmanın en hızlı yoludur. Ayrıca panelden karşılama mesajını, önerilen soru çiplerini ve görünüm rengini markanıza uyacak şekilde özelleştirebilirsiniz; bunların hiçbiri kod bilgisi gerektirmez.
Neden bu kadar basit tutuldu?
Chatbot kurulumunun tarihsel olarak zor görünmesinin nedeni, genelde chatbotun kendisinden çok, onu "besleyen" bilgi tabanının elle hazırlanması gerekmesiydi — SSS metinleri yazmak, senaryo akışları tasarlamak, entegrasyon kodu yazmak haftalar sürebiliyordu. Sohbotu bu yükü, sitenizin zaten var olan içeriğini otomatik tarayarak ortadan kaldırır: elle veri girmek yerine, zaten yazılmış ürün sayfalarınız, SSS'leriniz ve dokümanlarınız doğrudan kaynak olarak kullanılır. Kurulumun tek satır koda indirgenmiş olması bir pazarlama sadeleştirmesi değil, bu otomatik tarama mimarisinin doğal bir sonucudur.
Kod erişimi olmayan platformlar ne yapmalı?
Bazı site oluşturucular (özellikle çok kısıtlı, şablon tabanlı bazı sistemler) özel kod ekleme alanı sunmayabilir. Bu durumda ilk kontrol edeceğiniz yer, platformun kendi "entegrasyonlar" veya "uygulamalar" mağazasıdır — birçok modern site oluşturucu, üçüncü taraf script'leri güvenli biçimde ekleyebileceğiniz bir "özel kod" veya "chat widget" alanı sunar, sadece adı platforma göre değişir (Wix'te "Custom Code", bazı sistemlerde "Tracking Codes" veya "Embed"). Hiçbir şekilde kod ekleme alanı bulamıyorsanız, panelinizden bota özel bir bağlantı (demo linki) alıp bunu sitenizde bir buton veya menü öğesi olarak paylaşmak, tam gömülü widget kadar sorunsuz olmasa da geçici bir çözüm olarak işe yarar.
Sık yapılan hatalar
- Kodu ekleyip yayınlamayı unutmak: özellikle Wix ve bazı site oluşturucularda, düzenleyicide değişiklik yapmak yetmez; ayrıca "Publish/Yayınla" adımını tamamlamanız gerekir.
- Önbellek (cache) nedeniyle eski hâli görmek: WordPress'te bir önbellekleme eklentisi varsa, kodu ekledikten sonra sayfa önbelleğini temizlemeden değişikliği göremeyebilirsiniz.
- Kodu yalnızca ana sayfaya eklemek: chatbotun tüm sitede görünmesini istiyorsanız kodun her sayfada yüklenen ortak şablona (header/footer) eklendiğinden emin olun, tek bir sayfa şablonuna değil.
- Kurulumdan hemen sonra test etmeden bırakmak: kodu ekledikten sonra siteyi gizli sekmede açıp en az bir soru sorarak asistanın gerçekten göründüğünü ve bilgi tabanınızdan doğru yanıt verdiğini doğrulamak, sonradan fark edilecek bir sorunu baştan önler.
- Yanlış ortama (staging) eklemek: değişikliği test/staging sitesine yapıp canlı siteye taşımayı unutmak, kurulumun "tamamlandı sanılıp" aslında hiç yayında olmaması gibi yaygın bir hataya yol açar.
Kodu eklemek sitemi yavaşlatır mı, güvenlik riski oluşturur mu?
Bu, kurulum öncesi en sık sorulan sorulardan biridir. Eklenen tek satır, sayfanın ana yükünü bloklamayacak şekilde asenkron olarak çalışacak biçimde tasarlanır: sohbet arayüzü kendi küçük dosyasını ayrı olarak yükler ve sitenizin geri kalan içeriğinin görüntülenmesini geciktirmez. Güvenlik açısından da bu script yalnızca kendi sohbet penceresini render eder ve sitenizin diğer öğelerine (formlarınız, ödeme sayfanız, veritabanınız) erişimi yoktur — tamamen izole, tek amaçlı bir bileşen olarak çalışır. Yine de büyük, performansa duyarlı bir e-ticaret sitesindeyseniz, kurulumdan sonra sayfa yükleme hızınızı bir kez ölçüp beklediğiniz gibi olduğunu teyit etmeniz iyi bir alışkanlıktır.
Kurulumu test ederken nelere bakmalısınız?
Kodu ekledikten sonra tek bir "chatbot görünüyor" kontrolü yeterli değildir; birkaç noktayı ayrıca doğrulamanızı öneririz. Önce sayfayı hem masaüstünde hem mobil ekranda açıp sohbet balonunun sayfa içeriğini (özellikle sepet, menü gibi sabit konumlu öğeleri) kapatmadığını kontrol edin. Ardından sitenizde gerçekten yer alan bir bilgiyi (örneğin bir hizmet fiyatı veya çalışma saati) chatbota sorup doğru yanıt aldığınızı teyit edin; yanlış veya eksik bir yanıt alırsanız bu, taramanın o sayfaya henüz ulaşmadığı ya da içeriğin daha net yazılması gerektiği anlamına gelebilir. Son olarak, kendi sitenizde olmayan bir bilgiyi kasıtlı olarak sorup asistanın uydurma bir cevap yerine dürüst bir "bilmiyorum" yanıtı verdiğini görmek, kurulumun doğru çalıştığının en güvenilir işaretlerinden biridir.
Özetle kurulumun teknik kısmı, panelin arkasına gizlenmiş durumda: siz yalnızca site adresini girip taramayı bekliyor, ardından tek satır kodu şablonunuza bir kere yapıştırıyorsunuz. Geri kalanı — sayfaların taranması, bilgi tabanının oluşturulması, sohbet arayüzünün render edilmesi — otomatik işliyor. Platformunuz ne olursa olsun aynı beş dakikalık akış geçerli.