Kullanım Rehberi

1. Giriş ve hesap

Ana sitede Giriş Yap veya Başlayın ile kimlik doğrulama başlar. Akış Scalekit üzerinden yürür; e-posta ve profil verileri güvenli şekilde işlenir. Oturum bilgisi user_session çerezinde tutulur — çerezleri silmek veya gizli pencere kullanmak oturumu sonlandırır.

Her işlem bir organizasyon (kuruluş) bağlamındadır: bilgi kaynakları, sohbet botu kimliği, ekip üyeleri ve widget aynı organizasyona bağlıdır. Ayarlar üzerinden ekip ve kuruluş yönetimine erişilir.

Çıkış için paneldeki oturumu kapatma akışını kullanın (paylaşımlı cihazlarda özellikle önemlidir).

Önerilen sıradaki adım: Gösterge Paneli → ardından Bilgi Bankası.

2. Gösterge Paneli

Rota: /dashboard. Bu sayfa operasyonel özet ve kurulum kontrolüdür.

Üst KPI kartları: Bugünkü konuşmalar, toplam konuşma, İnsan devir bekleyen (müşteri insan operatöre düşmüş, yanıt bekliyor), İnceleme bekleyen (öğrenme kuyruğunda işlem gerektiren kayıtlar). Kartlar tıklanabilir ve ilgili modüle gider (ör. konuşmalar veya öğrenme).

Kurulum ilerlemesi: Dört kutucuk — web taraması, bilgi eklendi mi, bölüm yapılandırıldı mı, widget üzerinden en az bir konuşma oluştu mu — tamamlanmayanlar vurgulanır ve doğrudan ilgili sayfaya link verir.

Haftalık grafik: Son 7 gün konuşma hacmi. Başlıktaki bağlantı Analitik sayfasına gider. Ayrıca bu ekranda widget kodunu hızlıca panoya kopyalayabilirsiniz (origin tarayıcı adresinize göre üretilir; canlıda gerçek alan adınızı kullanın).

3. Bilgi Bankası

Rota: /dashboard/knowledge. Yapay zekanın "okuduğu" tüm kurumsal bilgi burada toplanır.

Hızlı eylemler (üst kartlar):

• Web sitesi ekle:Alan veya sayfa URL'lerini taratarak içerik çekilir; güncellemeler için tekrar çalıştırılabilir.
• CSV yükle: Ürün listesi, SSS tablosu vb. toplu içe aktarım.
• Metin / SSS ekle: Manuel paragraflar; kısa başlıklar ve net cümleler RAG kalitesini artırır.

Tabloda kaynak listesi, durum ve detay sayfasına geçiş vardır. İçerik ekledikten sonra hatalı veya boş kayıt kalmadığını doğrulayın. Çelişen iki kaynak yerine tek doğru kaynak tutmaya çalışın.

Sonraki: Bölümler veya Sohbet Botu.

4. Bölümler

Rota: /dashboard/sections. Bilgiyi konu, ton veya departman bazında bölersiniz; her bölümde izinli/yasaklı konu başlıkları ve bağlı kaynaklar tanımlanabilir. Sohbet botu ekranında hangi bölümün aktif olduğu ile kullanıcıya uygun ton seçilebilir.

Satış modülünde ürünleri belli bir bölüme bağlamak mümkündür (bölüm listesi satış sayfasında seçenek olarak gelir). Bölümler, müşteri sorularını yanlış bağlamda yanıtlamayı azaltır.

5. Satış modülü

Rota: /dashboard/sales. Widget içinde ürün kartları, fiyat, öne çıkan özellikler ve satın alma / demo / plan bağlantıları bu modülle yönetilir.

Satış modunu açma: Üstteki anahtar ile satış özellikleri etkinleştirilir. Kapalıyken ürün verileri saklanabilir ancak ziyaretçiye ürün gösterilmez.

Ürün kartları: Her ürün için ad, fiyat metni, açıklama, özellik maddeleri, isteğe bağlı harici URL, kategori, stok notu, bölüm eşlemesi (Bölümler'den gelen liste) ve görsel (URL veya yükleme) alanları bulunur. Ürün sayısı üst sınırı yapılandırmaya bağlıdır; düzenleme için satır açılır panel (sheet) kullanılır.

Toplu içe aktarım: CSV veya metin yapıştırma ile çok ürün bir seferde eklenebilir; JSON editörü ile gelişmiş kullanıcılar doğrudan yapılandırılmış liste düzenleyebilir.

Genel bağlantılar:Planlar sayfası, demo talebi ve satın alma adresi gibi ortak URL'ler ayrı alanlarda tutulur; bot ve carousel bu linkleri kullanır.

A/B varyantı: Mesaj veya düzen testleri için varyant seçimi (a / b / split) sunulabilir; embed tarafında hangi deneyin gösterileceği bu ayardan beslenir.

Sohbet içinde ürün önerisi ve insan satış temsilcisine aktarma (handoff) akışları, bu konfigürasyon ve Bilgi Bankası ile birlikte çalışır. Embed sayfasında satış carousel davranışı bu verilere bağlıdır.

6. Sohbet Botu — ayarlanabilen tüm özellikler

Rota: /dashboard/chatbot. Sol tarafta canlı önizleme ve simülatör, sağda marka ayarları ve gömme kodu bulunur. Kaydetmediğiniz değişiklikler canlı widget'a yansımaz.

Karşılama: İlk mesaj metni (welcome); panelde düzenlenir ve kayıtlı metadata ile senkronize edilir.

Renkler ve tema: Birincil, ikincil, vurgu (aksan), arka plan, yüzey, metin renkleri. Tema modu: açık / koyu / otomatik (themeMode).

Tipografi: İsteğe bağlı font ailesi adı; Google Fonts veya benzeri için fontHeadSnippet alanına tam <link> / @importblokları (widget içinde head'e enjekte edilir). Font ağırlıkları isteğe bağlı dizi olarak saklanabilir.

Logo ve görseller: Açık tema logosu, koyu tema logosu, favicon; dosya yükleme veya URL. Logo konumu: sol / orta / sağ.

Köşe ve düzen: Önceden tanımlı köşe yuvarlaklığı (keskin / yuvarlak / hap) veya piksel cinsinden özel yarıçap; gölge seviyesi (none / sm / md / lg); iç boşluk (sıkı / rahat); kart stili (minimal / cam / neumorphism). İsteğe bağlı özel CSS (sanitize edilir, üst sınır karakter sayısı vardır).

Animasyon: Genel animasyon açık/kapalı, hız (yavaş / normal / hızlı). Geçiş stili alanı ileride genişletmek için rezerve edilebilir.

Marka metni: Bot başlığı / chat başlığı (botName); "Powered by" rozetinin gösterimi (showPoweredBy).

Önerilen sorular:En fazla on iki adet, her biri etiket + tam mesaj metni; widget'ta hızlı seçim olarak gösterilir.

Launcher (kapalı düğme): Lucide ikon seçimi, ikon rengi, ikon boyutu (px), düğme köşe yuvarlaklığı (px), animasyon ön ayarı (yok / bounce / pulse / ping / özel), özel animasyon CSS ifadesi. Özel launcher görseli URL ile de değiştirilebilir (ürün tasarımına göre).

Pencere konumu ve boyutu: Sağ alt / sol alt; panel genişliği sm / md / lg. Otomatik açılış, gecikme (ms), sayfa kaydırma yüzdesinde tetikleme, çıkış niyeti (fare üst kenar), dışarı tıklanınca kapatma — hepsi data-* olarak gömme koduna yansır.

Yapay zeka ile tema önerisi: Kısa açıklama metni girerek palet ve tipografi önerisi alın (ortamda tanımlı sağlayıcıya bağlı); öneriyi kaydetmeden önce inceleyin.

Gömme kodu: Sayfanın alt bölümünde; kopyala ile panoya alın, sitenize tek parça olarak ekleyin. Aynı kod mantığı Ayarlar → Widget bölümünde de tekrarlanır.

7. Widget’ı siteye ekleme

Widget, /widget.js dosyasını yükleyen ve data-id ile sohbet kimliğinizi ileten tek bir <script defer> satırıdır. Genel kural: sayfada yalnızca bir kez yükleyin; çoğu projede <body> kapanışından hemen önce eklemek en az sürtünmeyi yaratır. defer sayesinde HTML ayrıştırıldıktan sonra çalışır.

Aşağıdaki kartlardan kullandığınız yığını seçin; tıklayınca adım adım kurulum açılır.

Listede yoksa bile yaklaşım aynıdır: tek bir global şablonda, tüm sayfalarda ortak yükleme noktasına script ekleyin. Geliştirme sırasında yalnızca yerel ortamda widget davranışını denemek için ayrı bir test sayfası kullanılabilir; canlıya aynı data-id ile çıkın.

8. Script "data-*" özellikleri

Panelde seçtikleriniz otomatik olarak şu özniteliklere yansır:

9. Ayarlar

Rota: /dashboard/settings. Organizasyon adı, ekip davetleri, Widget Entegrasyonu kartı (sohbet kimliği hazırsa aynı gömme kodu), kuruluş silme ve hesapla ilgili seçenekler burada toplanır. Scalekit ile korunduğunuz metni panelde görebilirsiniz.

Widget kodunu hem buradan hem Sohbet Botu sayfasından kopyalayabilirsiniz; ikisi aynı kimliği kullanmalıdır.

10. Etkileşim Motoru

Rota: /dashboard/engagement. Ziyaretçiye sohbet dışında proaktif mesajlar, banner'lar, turlar ve anketler göstermek için kullanılır; kampanyalar koşullara ve hedeflemeye bağlanır.

Kampanya türleri (UI etiketleri): Banner, Popup, Modal, Toast, Tur (tour), Kontrol listesi (checklist), Anket, Çekmece (drawer), Tam ekran, İpucu (tooltip), Uyarı (alert). Her türün düzenleyicisi (component editor) farklı görsel bloklar sunar; şablon galerisinden başlayabilirsiniz.

Yaşam döngüsü: Taslak (draft) → zamanlanmış / yayında (active) → duraklatılmış (paused) → arşiv. Yayınla, duraklat, çoğalt ve sil gibi eylemler tablo üzerinden yapılır.

Tetikleyiciler (Trigger):Sayfa URL deseni, süre, kaydırma, tıklama, çıkış niyeti, segment vb. birleşimleri ile "ne zaman gösterilir" tanımlanır (TriggerBuilder).

Hedefleme (Targeting): Coğrafya, cihaz, dil veya özel kurallarla kimin göreceği daraltılır.

Tema stüdyosu: Renk ve tipografi setlerini kaydedip kampanyalara atayabilirsiniz. Şablon galerisi hazır başlangıç düzenleri sunar.

Sihirbaz (Campaign wizard): Yeni kampanyayı adım adım oluşturur; tür seçimi → içerik → tetikleyici → hedefleme → önizleme akışı.

Analitik: Kampanya bazında gösterim, tıklama, CTR gibi metrikler; raporlar ayrı görünümde sunulur.

Görsel önizleme ve davranış testi için geliştirme ortamında /engagement-preview sayfası kullanılabilir; üretimde gerçek kampanyalar widget ile aynı domain üzerinde yüklenir.

11. Konuşmalar

Rota: /dashboard/conversations. Tüm müşteri oturumları, mesaj geçmişi, durum ve arama burada. Durum örnekleri: bot yanıtlıyor, insan desteğine yükseltilmiş (escalated), tamamlandı, silindi. Operatör olarak mesaj gönderebilir, konuşmayı arayabilir veya durum güncelleyebilirsiniz.

Gösterge panelindeki "İnsan devir bekleyen" sayısı doğrudan bu kuyruğa işaret eder; hızlı müşteri yanıtı için bu listeyi sık kontrol edin.

12. Öğrenme merkezi

Rota: /dashboard/learning. Bu modül, yapay zekanın geri bildirim döngüsünü yönetir: kullanıcıların beğenmediği yanıtlar, düşük güven skorlu cevaplar ve tekrarlayan sorular burada toplanır; siz düzeltme veya altın veri (golden answer) ekleyerek modelin davranışını iyileştirirsiniz.

Kayıt durumları (örnekler): İnceleme bekliyor (open), olumlu kapatıldı (closed_positive), yoksayıldı (ignored), bilgi bankasına yönlendirildi (knowledge_flag), düzeltildi (fixed). Arayüzde Türkçe etiketlerle gösterilir.

Altın veri: Onaylanmış doğru yanıt; benzer soru geldiğinde öncelikli kullanılır. Sürüm numarası (golden_version) güncellemelerle artar.

Düşük güven:Modelin belirsiz kaldığı sorular; eşik (ör. < 0.5) altındaki yanıtlar listelenir. Bilgi bankasını genişletmek veya altın veri yazmak çözüm yollarıdır.

Tekrarlayan sorular: Normalize edilmiş soru metnine göre gruplanır; yüksek tekrar, bilgi boşluğuna işaret eder.

Öncelik sırası: Kritik / olumsuz / düşük güven gibi katmanlarla kayıtlar sıralanır; en riskli kayıtlar üstte.

Düzeltme akışı: Kaydı açıp doğru yanıtı yazabilir, bilgi bankasına ekleme kararı verebilir veya yoksayılabilir işaretleyebilirsiniz. Sayfadaki yerleşik Öğrenme Merkezi Rehberi diyaloğu da bu kavramları özetler.

Bilgi güncellemesi sonrası: API üzerinden invalidate ile ilgili öğrenme önbelleği temizlenebilir; büyük içerik değişikliklerinden sonra öğrenme listesinin güncellenmesini bekleyin.

Gösterge panelindeki "İnceleme bekleyen" KPI'sı bu kuyruğa bağlanır.

13. Analitik

Rota: /dashboard/analytics. Hunisi, kohort, ürün ve özet metrikler; widget üzerinden gönderilen olaylar sunucuda işlenir. Ortam değişkeninde tanımlı saklama süresi sonrası ham veriler temizlenebilir.

Gösterge panelindeki haftalık grafik hızlı trend gösterir; burada daha ayrıntılı segmentasyon ve raporlama bulunur.

14. Bildirimler

Rota: /dashboard/notifications. Sistem bildirimleri, okundu işaretleme ve gerçek zamanlı güncellemeler (yapılandırmaya bağlı) burada toplanır.

15. Sorun giderme

• Widget yok: Tarayıcıda ağ sekmesinde widget.js isteğinin 200 döndüğünü kontrol edin; reklam engelleyici veya CSP engelliyor olabilir.
• Yanlış bot: data-id paneldeki sohbet kimliği ile birebir aynı olmalıdır.
• HTTPS: Karışık içerik (HTTP script on HTTPS sayfa) bloklanır.
• Zayıf yanıtlar: Önce Bilgi Bankası, sonra Öğrenme kuyruğunu güncelleyin.

16. Önerilen kurulum sırası

1. Gösterge Paneli ile durumu görün.
2. Bilgi Bankası — web, CSV veya metin.
3. Bölümler (isteğe bağlı).
4. Sohbet Botu — görünüm ve karşılama.
5. Widget’ı sitenize ekleyin (bölüm 7 ve kartlar).
6. Satış ve Etkileşim ihtiyaca göre.
7. Konuşmalar ve Analitik ile izleyin; Öğrenme ile iyileştirin.

17. Politikalar ve iletişim

Veri işleme: Gizlilik Politikası. Kullanım koşulları: Kullanım Koşulları. İletişim: Bize Ulaşın. Ürün özeti: Özellikler, Entegrasyonlar.