Widget Ayarları

Yönetim Paneli → Widget Ayarları, widget'ın görünümünü değil davranışını ve görüşmelerin nasıl yürüdüğünü belirler: hız sınırı, sohbet öncesi bilgi formu, canlı ziyaretçi listesi, görüşmelerin otomatik kapanması, sessiz kalan müşteriye sorma ve hatırlatma, otomatik yanıt, memnuniyet anketi, spam süzgeci, insana devir ve yanıt süresi hedefi, engellenen ziyaretçiler, proaktif mesajlar ve temsilciler için hazır yanıtlar.

Hız sınırı

Bir IP adresinin dakikada gönderebileceği en fazla mesaj sayısı. Kötüye kullanımı ve beklenmedik kredi tüketimini sınırlar. Kaydırıcıyla 0 ile 60 arasında seçilir; 0 sınır yok demektir (Sınırsız).

Ön bilgi formu

Açıkken widget, sohbet başlamadan önce ziyaretçiden iletişim bilgisi ister. İstenecek alanları seçersiniz: İsim · E-posta · Telefon. En az bir alan seçili olmalıdır.

Seçenek düğmeleri ve ürün kartları

Ön bilgi formunun altındaki iki anahtar, yapay zekânın cevabının altında neyin görüneceğini belirler. İkisi de açık gelir. Kapatmak yalnız düğmeyi ya da kartı kaldırır; yapay zekânın yazdığı metin aynı kalır.

Anahtar	Ne yapar
Seçenek düğmeleri	Yapay zekâ müşteriden birkaç seçenekten birini seçmesini istediğinde (beden, renk, model ya da “siparişinizi mi takip edelim, iade mi?”), seçenekler cevabın altında düğme olarak da çıkar. Müşteri dokununca o seçenek onun mesajı olarak gider. Web widget'ında düğme, WhatsApp'ta yanıt düğmesi (3 seçeneğe kadar) ya da liste, Instagram'da hızlı yanıt olur. Seçenekler cevap metninde de yazılı kalır; düğmenin görünmediği yerde (Instagram'ın masaüstü sürümü gibi) müşteri yazarak cevap verebilir. Düğmeler yalnız son mesajda durur. Sipariş numarası ya da e-posta gibi serbest cevaplı sorularda düğme çıkmaz.
Ürün kartları	E-ticaret widget'ında yapay zekâ mağazanızdan bir ürünü anlattığında cevabın altında kart çıkar: görsel, ad, fiyat (ziyaretçinin dilinde, mağazanızın para birimiyle), stok durumu ve Ürünü gör. Tek seçenekli ürünlerde Sepete ekle de vardır. Widget Shopify mağazanızın kendi sayfasındaysa ürün sayfadan ayrılmadan sepete eklenir; başka bir sitedeyse mağazanızın sepeti o ürünle yeni sekmede açılır. WooCommerce'te ürün sepete eklenip ürün sayfası açılır. Çok seçenekli üründe beden ya da renk ürün sayfasında seçilir. Kart yalnız mağaza aramasında gerçekten bulunan ve cevapta adı geçen ürüne çıkar. Gösterim, tıklama ve sepete ekleme sayıları Raporlar'da.

Kartın stok etiketi asistanın stok diline uyar: Stokta yalnız mağaza adedi takip ediyorsa ve adet varsa, Tükendi ürün satın alınamıyorsa yazar. Adedi takip edilmeyen üründe etiket yoktur.

Canlı ziyaretçi listesi

Ürün kartları anahtarının altındaki Canlı ziyaretçi listesi açıkken widget, sitenizdeki ziyaretçilerin hangi sayfada olduğunu 30 saniyede bir bildirir; listeyi Sohbetler'in üstündeki Sitede düğmesinden görürsünüz. Varsayılan kapalıdır.

• Tutulan: sayfa adresi (sorgu bölümü olmadan), sayfa başlığı, gelinen sitenin adı, cihaz türü (telefon / masaüstü), widget'ın dili ve ziyaretçinin ilk kez mi geldiği.
• Tutulmayan: IP adresi ve konum. Bilgi en çok 90 saniye saklanır ve veritabanına yazılmaz; otomatik tarayıcılar sinyal göndermez.
• Kapalıyken widget hiçbir sinyal göndermez ve Sohbetler'de düğme görünmez.

Görüşme ayarları

Canlı ziyaretçi anahtarının altındaki altı kart görüşmelerin nasıl yürüdüğünü belirler. Spam süzgeci, kendiliğinden çeviri ve düşük puan uyarısı açık gelir; diğerleri siz açana kadar kapalıdır, çeviri dili de siz seçene kadar her temsilcinin panel dilidir.

Kart	Ne yapar
Hareketsiz görüşmeyi otomatik kapat	Seçtiğiniz süre (12 saat ile 7 gün arası) boyunca yeni mesaj gelmeyen açık görüşmeleri kapatır. Temsilcinin devraldığı ve eskalasyona giden görüşmelere dokunmaz; müşteri yeniden yazarsa görüşme kendiliğinden açılır. Otomatik kapanan görüşmeler raporda ayrı sayılır ve çözüm oranına girmez. Aynı kartın içindeki Sessiz kalan müşteriye sor: son söz sizdeyken müşteri seçtiğiniz süre (15 dakika ile 4 saat arası) boyunca yazmazsa sohbete bir kez “Başka bir konuda yardımcı olabileceğim bir şey var mı?” yazılır. Widget, WhatsApp, Instagram ve Telegram'da çalışır; WhatsApp ve Instagram'da yalnız 24 saatlik mesaj penceresi açıkken. Devredilmiş görüşmelerde sorulmaz. Soru müşterinin dilinde (Türkçe ya da İngilizce) gider ve sohbette Otomatik soru olarak görünür; müşteri yeniden yazarsa bir sonraki sessizlikte yine bir kez sorulur.
Gelen mesaj çevirisi	Sohbetler'de müşteri mesajındaki Çevir'in hangi dile çevireceği. Varsayılan Temsilcinin panel dili; 39 dilden birini seçerseniz bütün ekip için o dil kullanılır. Temsilci tek bir mesaj için çeviri kutusundan başka bir dil seçebilir; bu ayar değişmez. Kartın altındaki Farklı dildeki mesajları kendiliğinden çevir açıksa (varsayılan) ekibin dilinden farklı dildeki müşteri mesajlarının çevirisi kendiliğinden görünür; ekibin dilindeki mesajlar çevrilmez ve her mesaj bir kez çevrilip saklanır. Ayrıntı: Mesaj çevirisi.
Müşteriye hatırlatma	Son sözü siz söylediyseniz ve müşteri seçtiğiniz süre boyunca dönmediyse ona bir kez hatırlatma e-postası gider. Yalnız e-posta bırakmış müşterilere; devredilmiş görüşmelerde gönderilmez. Süre, otomatik kapatma süresinden kısa olmalıdır; yoksa görüşme hatırlatma gitmeden kapanır.
Otomatik yanıt	Belirlediğiniz kelimeler geçince yapay zekâ hiç çalışmadan sizin yazdığınız hazır cevap gider: kredi harcanmaz, cevap anında gider. Her kural Şu kelimeler geçerse ve Şu cevabı gönder alanlarından oluşur. Aynı kural bir görüşmede yalnız bir kez çalışır; devraldığınız görüşmede otomatik yanıt hiç çalışmaz.
Memnuniyet anketi	Görüşme kapandıktan bir saat sonra müşteriye kısa bir değerlendirme bağlantısı gönderilir; puan raporlarda görünür. Anket e-posta, WhatsApp, Instagram ve Telegram görüşmelerine gider; sohbet balonundaki görüşmelere gitmez, çünkü orada yıldızlar zaten çıkar. Kartın içindeki Düşük puanda haber ver (varsayılan açık): müşteri 1 ya da 2 puan verince görüşmeye atanmış kişiye (ekibe atandıysa ekibin üyelerine, ikisi de yoksa destek adresine) e-posta gider: puan, yorum ve görüşmeyi yapay zekânın mı ekibin mi yanıtladığı; her alıcıya kendi dilinde. Sohbet balonundaki yıldızlar için de geçerlidir. Raporlar puanı yapay zekâ ve ekip diye ayırır: Müşteri memnuniyeti.
Spam süzgeci	Reklam, kumar, backlink ve dolandırıcılık mesajlarını gelen kutunuza girmeden eler. Altındaki ayarlar: Şüpheli mesajda yapay zekâya sor, Spam sayılmayacak kelimeler, Kendi engel terimleriniz ve Yerleşik listeyi göster. Spam sayılmayacak kelimeler'e yazdığınız kelime yüzünden mesaj şüpheli sayılmaz ve engellenmez (ör. piyango bayisiyseniz “piyango”); mesajdaki diğer kelimeler ve bağlantı yığını gibi işaretler denetlenmeye devam eder. Terimler kelime bütün olarak aranır; daha önce size yazmış bir ziyaretçi hiç engellenmez. Engellenen her mesaj Denetim Kaydı'na yazılır.

İnsana devir, ekipler ve bildirimler

Spam süzgecinin altında widget'ın insana devir ayarları durur; her birinin ayrıntısı İnsana devir sayfasında:

• Çalışma saatleri ve yanıt süresi — haftalık program, saat dilimi, beklenen yanıt süresi, tatiller ve özel günler.
• Yanıt süresi hedefi — müşteri bir temsilciden yanıt beklerken seçtiğiniz süre (5 dakika ile 24 saat arası) geçerse Sohbetler'de görüşmenin üstünde “hedef aşıldı” yazar; Raporlar'da devirlerin ne kadarının hedefte yanıtlandığı görünür. Çalışma saatleri açıksa süre yalnız mesai içinde işler. Ayrıntı: İnsana devir › Yanıt süresi hedefi.
• Ekipler ve yönlendirme — ekipler ve üyeleri, hiçbir kural tutmazsa devredilen görüşmenin nereye gideceği ve bekleme uyarısı. İnsana devir kuralları bu ekranda değil, RAG Widget ve E-Ticaret Widget ekranlarındadır.
• Devir bildirimleri — Destek e-postası: atanmamış devirler, bekleme uyarıları ve temsilci yanıtlarındaki "Yanıtla" adresi buraya gider. Boş bırakırsanız hesap sahibinin adresi kullanılır.
• WhatsApp ve SMS bildirimleri — atanmayan devirlerin hangi kanallardan (e-posta, WhatsApp, SMS) haber verileceği ve yedek telefon. SMS sağlayıcısı ve WhatsApp hattı Mesajlaşma ekranının Ekibe bildirim sekmesinde kurulur; buradaki kart yalnız durumlarını gösterir.

Engellenen ziyaretçiler

Sohbetler'de engellediğiniz ziyaretçiler burada listelenir: engelin türü (oturum, e-posta, IP), maskeli değer, tarih ve kimin engellediği. Engeli kaldır ile kaldırırsınız; işlem Denetim Kaydı'na düşer. Engelin nasıl konduğu ve neyi kapsadığı: Sohbetler › Ziyaretçiyi engelle.

Proaktif mesajlar

Ziyaretçi bir sayfada beklerken sohbet düğmesinin yanında kapatılabilir bir balon çıkar. Sohbet penceresi kendiliğinden açılmaz. Görüşme, ziyaretçi cevap verene kadar başlamaz; cevap verirse balon metni konuşmanın ilk mesajı olarak temsilcinin önüne düşer.

Kural ekle ile en fazla 5 kural tanımlarsınız. Balonun metni Mesaj (Türkçe) ve Mesaj (İngilizce) alanlarına yazılır. Ne zaman çıksın? bölümünde Sayfalar, Sayfada geçen süre (saniye), Kaydırma (%) ve Çıkış niyeti (yalnız masaüstünde) koşulları vardır; altında Kime, Sıklık, Mesai ve isteğe bağlı Hızlı yanıtlar seçilir. Bu kural çalışsın kapalıyken kural kaydedilir ama ziyaretçiye gösterilmez. Değişiklikleri Kaydet ile kaydedersiniz.

Sepet koşulu kuralı ziyaretçinin sepetine bağlar: Sepete bakma (varsayılan), Sepette ürün varken, Sepet tutarı en az… (mağazanızın para biriminde) ya da Sepette şu ürün varken… (ürün adında geçen bir kelime). Sepet ziyaretçinin tarayıcısında, mağazanın kendi sepetinden okunur ve SemAgent'a gönderilmez; balon çıkmadan hemen önce yeniden kontrol edilir, böylece sayfa yenilenmeden sepete eklenen ürün de sayılır. Shopify ve WooCommerce mağazalarında çalışır; sepeti okunamayan sitede sepet koşullu kural hiç çıkmaz.

Sepeti terk edenler için hazır kural tek tıkla Sepeti terk etmek üzere adlı bir kural ekler: sepette ürün varken ziyaretçi sayfadan ayrılmaya yönelince ya da 40 saniye sonra çıkar; metni iki dilde hazırdır. Metni ve koşulları değiştirip kaydedin.

Hazır yanıtlar

Buraya eklediğiniz metinler, Sohbetler ekranında görüşmeyi devralan temsilcinin yanıt kutusunun üstünde çıkar. Temsilci birini seçince metin kutuya yazılır; göndermeden önce düzenleyebilir. Müşteriye asistan değil, temsilci yazmış gibi gider.

Temsilci yanıt kutusuna / yazarak da arayıp seçebilir (ör. /iade). Ayrıntı: Yazma araçları.

Her hazır yanıtın bir başlığı (temsilcinin listede gördüğü kısa ad), bir içeriği (sohbete gidecek metin) ve bir kategorisi vardır. Hazır kategoriler Genel, Kargo, İade, Sipariş ve Ödeme'dir; Kategori seçicisinde + Yeni kategori'yi seçerek kendi kategorinizi eklersiniz. Kategoriler yalnız listeyi düzenler; müşteri onları görmez.

Listede her yanıtın kendi Etkin/Pasif anahtarı vardır: pasif yanıt listede durur ama temsilciye gösterilmez. Yeni yanıt ile yanıt eklersiniz; liste boşken Örnek yanıtları ekle beş örnek ekler.

Listenin altındaki Önerilen hazır yanıtlar, temsilcilerin sohbetlerde yazdığı yanıtları gösterir; en çok yazılan en üstte. Hazır yanıt yap ile kaydedersiniz, Yoksay ile gizlersiniz. Hiçbiri siz kaydetmeden listeye girmez.

Liste ve öneriler bu ekranda yalnız Hazır yanıtlar anahtarı açıkken görünür; anahtar, Engellenen ziyaretçiler bölümünün hemen üstündedir. Anahtarı kapatmak kayıtlı yanıtları silmez.

Giriş yapmış müşteriyi tanımak

Müşteriniz sitenizde ya da mağazanızda giriş yapmışken sohbete yazarsa, onu sipariş numarası sormadan tanıyabilirsiniz. Ayar, RAG Widget ve E-ticaret Widget sayfalarında gömme kodunun altındadır.

Kurulum

1. Anahtar oluştura basın. Kurulum penceresi açılır. Anahtar yalnız bir kez gösterilir ve koda kendiliğinden yerleşir.
2. Penceredeki Platform sekmelerinden sitenizi seçin: Shopify, WooCommerce ya da başka bir site.
3. Kodu sitenize, widget kodunun üstüne ekleyin. Shopify'da (kendi özel uygulamanızla bağlı mağazada) tema dosyası theme.liquid, WooCommerce'te footer.php ya da bir kod parçacığı eklentisi kullanılır. Kod, müşteri giriş yapmışken e-postasını bu anahtarla imzalar.
4. Widget e-postayı ve imzayı sohbetle birlikte gönderir. İmza doğrulanınca kişi o e-postanın müşterisi olur (güven: doğrulandı, kaynak: mağaza girişi).

Çalıştığını doğrulamak

Kodu ekledikten sonra pencerede Kurulumu test et'e basın:

1. Kodu sitenize ekleyip kaydedin.
2. Sitenizde bir müşteri hesabıyla giriş yapın (yönetici girişi değil).
3. Sohbet balonunu açıp bir mesaj yazın.

Panel 3 dakika boyunca imzalı girişi bekler. İmza tutarsa “Çalıştı! Giriş yapmış müşteriniz tanındı.” yazar. Tutmazsa nedenini söyler:

• Hesapta anahtar yok: siteniz imzalı giriş gönderiyor ama anahtar oluşturulmamış ya da kaldırılmış. Anahtar oluşturup koddaki anahtarı güncelleyin.
• İmza uyuşmuyor: sitedeki kodda eski bir anahtar olabilir ya da e-posta küçük harfe çevrilmeden imzalanıyor olabilir. Kodu penceredeki güncel hâliyle değiştirin.
• 3 dakikada giriş görülmedi: kodun sayfaya eklendiğini ve müşteri hesabıyla giriş yaptığınızı kontrol edip yeniden deneyin.

Ayar satırı her zaman son durumu gösterir: Çalışıyor, İmza tutmadı ya da Henüz denenmedi. Yanında son doğrulanan girişin zamanı yazar.

Widget'ı koddan yönetmek

Sitenizin kendi kodu widget'ı yönetebilir: bir düğmeyle açmak, ürün sayfasında soruyu hazırlamak, giriş yapmış müşteriyi tanıtmak ya da gelen yanıtları dinlemek. Gömme kodunuzdan önce şu satırı ekleyin; widget yüklenmeden yapılan çağrılar bekler ve widget hazır olunca sırayla çalışır:

<script>window.SemAgent=window.SemAgent||function(){(SemAgent.q=SemAgent.q||[]).push(arguments)};</script>

Komut	Ne yapar
SemAgent("open") · "close" · "toggle"	Sohbet penceresini açar, kapatır ya da tersine çevirir.
SemAgent("isOpen")	Pencere açıksa true döner (widget hazır olduktan sonra).
SemAgent("prefill", "Bu ürün kaç günde gelir?")	Pencereyi açar ve metni yanıt kutusuna yazar; ziyaretçi düzenleyip kendisi gönderir.
SemAgent("send", "Siparişim nerede?")	Pencereyi açar ve mesajı ziyaretçi adına gönderir. Ön bilgi formu açıksa önce form çıkar, mesaj kutuda bekler.
SemAgent("identify", { email, hash })	Giriş yapmış müşteriyi tanıtır: yukarıdaki imzalı kimlikle aynı şey, window.SemAgentUser yazmanın karşılığı. İmzasız e-posta kabul edilmez; başka bir e-postayla tanıtırsanız önce oturum sıfırlanır.
SemAgent("logout")	Müşteri sitenizden çıkış yapınca çağırın: kimlik kalkar ve bu tarayıcıdaki widget oturumu sıfırlanır (görüşme, ön bilgi formu ve son görüşmeler listesi). Aynı bilgisayarda sonra giren kişi öncekinin görüşmesini görmez.
SemAgent("on", olay, fn) · SemAgent("off", olay, fn)	Bir olayı dinler ya da dinlemeyi bırakır.
SemAgent("ready", fn)	Widget hazır olunca (zaten hazırsa hemen) fn'i çağırır.

Widget hazır olduktan sonra aynı komutlar SemAgent.open() biçiminde de çağrılabilir. Olaylar:

• ready: widget hazır.
• open, close: pencere açıldı ya da kapandı.
• message:sent: ziyaretçi bir mesaj gönderdi; { text }.
• message:received: bu sayfada yeni bir yanıt geldi; { text, from }. from, yapay zekâ için "ai", temsilci için "agent". Sayfa açılırken yüklenen eski mesajlar için bu olay çıkmaz.
• product:click: ziyaretçi bir ürün kartının görseline ya da Ürünü gör'e tıkladı; { title, url }.
• cart:add: ziyaretçi bir ürün kartında Sepete ekle'ye bastı; { title, url }. Sepete eklemeyi kendi analitiğinize (ör. Google Analytics) bu olayla yazabilirsiniz.

SemAgent("on", "message:received", function (m) {
  if (m.from === "agent") console.log("Ekibimiz yazdı:", m.text);
});
document.querySelector("#yardim-dugmesi").onclick = function () { SemAgent("open"); };