Sohbet Penceresi #

Web Sitesi Sohbet Penceresi Entegrasyon Kılavuzu #

Ziyaretçilerin doğrudan sitenizin arayüzü üzerinden iletişim kurmasını sağlayan kullanıcı dostu bir sohbet penceresini web sitenize ekleyin. Entegrasyon süreci oldukça basittir ve web sitenize yerleşik mesajlaşma özellikleri kazandıracaktır.

Sohbet Penceresi Oluşturma ve Yapılandırma #

Nasıl gidilir:

1. Sol kenar çubuğunun alt kısmına yakın Ayarlar’a tıklayın. (Telefonda, kenar çubuğunu açmak için önce üst köşedeki menü simgesine ☰ dokunun.)
2. Ayarlar sol panelinde, Kanallar altında Kanallar’a tıklayın.
3. Web sitesi sohbet penceresi kartını bulun.
4. Henüz bir pencereniz yoksa, bir görünen ad ve karşılama mesajı ile oluşturmak için Bağlan’a tıklayın.
5. Oluşturulduktan sonra, tam yapılandırma panelini açmak için istediğiniz zaman Yönet’e tıklayın.

Kaydettiğiniz değişiklikler canlı pencerenize otomatik olarak uygulanır; değişiklik yaptıktan sonra yükleme kodunu tekrar yapıştırmanıza gerek yoktur.

Ayarların hemen yanında bir Canlı önizleme bulunur: gerçek widget’ınızın üzerinde çalıştığı örnek bir web sayfası; renklerinizi, konumunuzu, logonuzu, başlatıcı simgenizi ve proaktif açılır pencerenizi ziyaretçilerin göreceği şekilde tam olarak gösterir. Siz düzenlemeleri yaptıkça bu önizleme de güncellenir, böylece bir renk veya tema değişikliğinin nasıl göründüğünü görmek için kaydetmeniz gerekmez. Hatta widget’ı açıp denemek için önizlemedeki sohbet düğmesine tıklayabilirsiniz.

Neleri Özelleştirebilirsiniz #

Yönet paneli dört bölüme ayrılmıştır.

Görünüm #

• Stil teması: Tüm widget’ı tek tıkla yeniden şekillendirin. Altı temanın her biri görünümü, renkleri, köşeleri ve yazı tipini bir arada ayarlar: Classic (orijinal katı görünüm — düz bir panel üzerinde renkli bir başlık çubuğu), Glass (arkasındaki sayfayı hafifçe bulanıklaştıran buzlu, yarı saydam bir panel; başlık ve mesaj kutusu bunun içinde yuvarlatılmış kartlar olarak yüzer), Midnight (koyu renklerde Glass), Bloom (yumuşak pembe, ekstra yuvarlatılmış), Ember (sıcak turuncu Glass) ve Mono (siyah-beyaz, keskin köşeler). Bir tema başlangıç noktasıdır; birini seçtikten sonra yine de herhangi bir rengi veya ayarı ayrı ayrı değiştirebilirsiniz. Yeni widget’lar Glass ile başlar; geçiş, widget’ın gömülü olduğu her yerde anında gerçekleşir ve sitenizde kod değişikliği gerektirmez.
• Köşeler ve Yazı Tipi: İki bağımsız stil ayarı. Köşeler, panelin, balonların ve düğmelerin ne kadar yuvarlatılacağını (Yuvarlak, Yumuşak veya Keskin) belirler ve Yazı Tipi, ziyaretçilerin gördüğü yazı tipini seçer (Varsayılan, Serif, Yuvarlak veya Mono) — yazı tipleri ziyaretçinin cihazında zaten mevcut olanlardan gelir, bu nedenle sitenize fazladan hiçbir şey yüklenmez.
• Görünen ad: Widget başlığında gösterilir.
• Logo: Sohbetin en üstünde görünen bir görsel yükleyin. Şirket logonuzu veya samimi bir profil fotoğrafınızı kullanın.
• Başlatıcı simgesi: Kayan sohbet düğmesinin üzerindeki simge. Yerleşik simgelerden birini seçin (sohbet balonu, kağıt uçak, soru işareti ve daha fazlası), yüklediğiniz logoyu yeniden kullanın veya kendi ayrı görselinizi yükleyin — ziyaretçileri karşılayan gerçek bir ekip üyesinin fotoğrafını kullanmak istiyorsanız kullanışlıdır.
• Renkler: Her biri widget’ın boyadığı kısmını adlandıran beş renk. Marka rengi, kayan düğme, başlık ve ziyaretçinin kendi mesajları içindir; Marka metni ise bunun üzerinde duran metin içindir. Bot balonu, botunuzun yanıtlarının ve yazma göstergesinin arka planıdır; Bot balonu metni ise bunların içindeki kelimeler ve hareketli yazma noktaları içindir. Sohbet penceresi, tüm mesajların arkasındaki paneldir. Marka renginizden belirgin şekilde farklı bir Bot balonu rengi seçin — eğer ikisi eşleşirse, konuşmanın her iki tarafı da aynı renkte görünür ve ziyaretçiler botunuzun yanıtlarını kendilerininkinden ayırt edemez. Marka renginizin yanında koyu metinli açık gri bir bot balonu güvenli bir kombinasyondur.
• Konum: Kayan sohbet düğmesini sayfanızdaki başka bir şeyle çakışıyorsa yatay ve dikey ofset (piksel cinsinden) ile sağ alt veya sol alt köşeye yerleştirin.
• Başlangıç soruları: Ziyaretçilerin yazmak yerine tek bir dokunuşla başlayabilmeleri için sohbette gösterilen hızlı yanıt önerileri (tıklanabilir çipler) — örneğin “Fiyatlarınız nedir?” veya “Destek sunuyor musunuz?” — en fazla 10 adet.
• Alt bilgi satırı: Mesaj kutusunun altında, örneğin “Powered by Your Agency” gibi kendi metniniz için isteğe bağlı küçük bir satır. Varsayılan olarak kapalıdır ve kapalıyken mesaj kutusunun altında hiçbir şey gösterilmez. Açın, metninizi yazın (40 karaktere kadar) ve isterseniz https:// ile başlayan bir bağlantı ekleyin; metne tıklayan ziyaretçiler o sayfayı yeni bir sekmede açar. Ajanslar bunu, müşterileri için oluşturdukları widget’lara kendi isimlerini koymak için kullanırlar.

Davranış #

• Karşılama mesajı: Ziyaretçilerin sohbeti açtıklarında gördükleri ilk mesaj (örneğin, “Size nasıl yardımcı olabilirim?”).
• Ses: Sohbete yeni bir mesaj geldiğinde ses çalın.
• Bildirim izni iste: Ziyaretçilerden tarayıcı bildirimlerine izin vermelerini isteyerek, sekmeleri değiştirseler bile yanıtlardan haberdar olmalarını sağlayın.
• Proaktif açılır pencere balonu: Sohbet butonunun yanında beliren ve insanları sohbete davet eden isteğe bağlı küçük bir balon. Mesajını, kabul et/reddet butonu metnini ve görünmeden önce kaç saniye bekleneceğini ayarlamak için açın. Ziyaretçi tıklamazsa balon 20 saniye sonra kendiliğinden kapanır. Bu, widget’ın sohbet butonunun yanında gösterdiği tek metindir: butonun yanında kalıcı bir etiket için ayar bulunmamaktadır.
• Yapay zeka yanıt hızı: Daha yavaş (daha insansı — yapay zeka yanıt vermeden önce kısa bir süre bekler) ile Maksimum hız (daha robotik — yanıtlar mümkün olduğunca hızlı gelir) arasında bir kaydırıcı. Dengeli seçeneği ortadadır. Bir yanıtın ilk mesajı, kaydırıcı tarafından ayarlanan gecikme süresiyle gelir ve kısa bir süre önce yazma göstergesi görünür.
• Yapay zeka çalışırken meşgul notu göster: Varsayılan olarak kapalıdır. Bir yanıt birkaç saniyeden uzun sürdüğünde, örneğin temsilciniz başka bir sistemde bir şey aradığı için, ziyaretçiler yazma noktalarının yanında kısa bir satır görür: 5 saniye sonra “Yanıtınız üzerinde çalışıyorum”, 15 saniye sonra “Bunu sizin için araştırıyorum”, daha uzun sürerse “Hala üzerinde çalışıyorum, neredeyse bitti” ve bekleme için bir özür. Hızlı yanıtlar yalnızca noktaları gösterir. Satır, widget dilini takip eder ve yalnızca yapay zekanız gerçekten bir yanıt üzerinde çalışırken görünür; yapay zeka o sohbet için kapalıyken veya bir kişi devraldığında asla görünmez.

Diller #

Widget kendi başına çok dillidir; açmanız gereken herhangi bir ayar yoktur.

• Ziyaretçinin dilini otomatik olarak seçer. İlk olarak sayfanızın HTML’de (<html lang="it">) belirttiği dile bakar, ardından ziyaretçinin tarayıcı diline geçer. Eğer ikisi de desteklediğimiz bir dil değilse, widget’ın kendi etiketleri açılış mesajınızı yazdığınız dilde görünür; açılış mesajınız, açılır balonunuz ve başlangıç sorularınız ise tam olarak yazdığınız şekilde görüntülenir.

• Karşılama mesajınızla çelişen sayfa dili dikkate alınmaz. Bazı site oluşturucular, sitenin dili ne olursa olsun her sayfaya lang="en" ekler. Sayfa bir dil belirtip siz açılış mesajınızı başka bir dilde yazdığınızda, widget sayfa değerini bir oluşturucu varsayılanı olarak kabul eder: bunun yerine ziyaretçinin tarayıcı dilini takip eder ve eğer bu da desteklediğimiz bir dil değilse, yazdığınız dili kullanır. Ziyaretçi sitenizde bir dil seçtiğinde lang değerini değiştiren bir sayfa her zaman takip edilir. Bunların hiçbirine bağlı kalmak istemiyorsanız, Davranış bölümünden dili sabitleyin.

• Veya kendiniz bir dil seçin. Davranış bölümündeki Widget dili alanı varsayılan olarak yukarıdaki algılama yöntemi olan Otomatik olarak ayarlanmıştır. Oradan bir dil seçerseniz, widget’ın kendi etiketleri (ziyaretçi formundaki Ad, E-posta ve Telefon alanları ve bunların örnek metinleri, gizlilik bildirimi, düğmeler) sayfa veya tarayıcı ne derse desin o dilde kalır. Bunu, site oluşturucunuz doğru dili belirtmediğinde veya her ziyaretçi için sabit bir dil istediğinizde kullanın.

• Desteklenen diller: İngilizce, Felemenkçe, Almanca, Fransızca, İspanyolca, İtalyanca, Portekizce, Romence, Lehçe, Arapça, Fince, Filipince, Slovence, Tayca, Bengalce, Japonca, Norveççe (Bokmål) ve Türkçe. Bu, widget’ın kendi düğmeleri ve etiketleri için geçerli olan listedir.

• Sağdan sola diller sağdan sola düzenlenir. Arapça, İbranice, Farsça ve Urduca konuşan ziyaretçiler için tüm sohbet penceresi yansıtılır: başlık, mesaj balonları, yazma noktaları, ziyaretçi formu ve mesaj kutusu sağdan başlar. Balon düğmesi seçtiğiniz köşede kalır. İbranice, Farsça ve Urduca konuşan ziyaretçiler etiketleri İngilizce (veya sabitlediğiniz dilde) görür, ancak düzen yine de dillerini takip eder. Farklı bir yönde yazılmış bir mesaj, örneğin Arapça bir sohbette İngilizce bir yanıt, yine de doğru sırada okunur.

• Mesajlarınız sizin için çevrilir. Her kaydettiğinizde, açılış mesajınız, proaktif açılır balonunuz ve başlangıç sorularınız yukarıdaki on sekiz dilin tamamına çevrilir. Bunları yalnızca bir kez, tercih ettiğiniz dilde yazarsınız: yazdığınız dil metnin kendisinden tanınır, o sürüm kelimesi kelimesine korunur ve diğer tüm diller bunun çevirisidir. Hesabınızın hangi dile ayarlı olduğu önemli değildir.

• Bir dil için kendi sürümünüzü yazın. Yönetim panelindeki Davranış bölümünün hemen altındaki Çeviriler bölümü, otomatik çeviriyi kendi ifadelerinizle değiştirmenize olanak tanır; örneğin otomatik çevirinin gayriresmi olduğu durumlarda resmi İspanyolca (“usted”) kullanabilirsiniz. Dil altında bir dil seçin, ardından şunlardan herhangi birini doldurun: Açılış mesajı, Açılır mesaj, açılır pencerenin Kabul et metni ve Reddet metni (açılır balon görünürken gösterilir) ve Başlangıç soruları. Her alan otomatik çeviriyi gri renkte gösterir; Otomatik çeviriden başla seçeneği, düzenleme yapabilmeniz için bunu kopyalar. Boş bıraktığınız her şey otomatik çeviriyi korur. Kendi yazdığınız diller ilk sırada listelenir, Kendi ifadeleriniz olarak işaretlenir ve (dil) ifadelerimi kaldır seçeneği o dil için otomatik çeviriye geri döner. Kendi ifadeleriniz, orijinal metni daha sonra düzenlediğinizde korunur; yalnızca otomatik çeviriler yeniden yapılır.

• Açılır pencere düğmeleri de çevrilir. Proaktif açılır balonun Kabul Et ve Reddet düğmeleri diğer mesajlarınızla birlikte çevrilir, böylece İspanyol bir ziyaretçi artık İngilizce düğmeler görmez.

• Her mesajı yalnızca tek bir dilde yazın. Aynı alana iki dil koyarsanız (örneğin bir İngilizce satır ve bir İtalyanca satır), her şey tek bir mesaj olarak ele alınır ve olduğu gibi çevrilir, bu nedenle İtalyan bir ziyaretçi aynı cümleyi iki kez görür. Bunu tercih ettiğiniz dilde, bir kez yazın.

• Yapay zeka ziyaretçinin dilinde yanıt verir. Birisi hangi dilde yazarsa yazsın, temsilciniz widget etiketlerinin hangi dilde göründüğüne bakılmaksızın aynı dilde yanıt verir. Her zaman sabit bir dilde yanıt vermesini tercih ederseniz, bunu temsilcinizin talimatlarında belirtin.

• Gömme kodunda sayfa başına dili ayarlayın. İngilizce bir sitede ve onun çevrilmiş bir kopyasında tek bir widget mı çalıştırıyorsunuz? Her sayfadaki widget’ın script etiketine data-lang ekleyin. data-lang="es", tarayıcı ne derse desin o sayfada widget’ı İspanyolca gösterir; data-lang="page" ise açılış mesajınız başka bir dilde yazılmış olsa bile widget’ın sayfanın kendi <html lang="..."> değerini izlemesini sağlar (böylece lang="es-MX" İspanyolca verir). Bu, otomatik algılamaya göre önceliği olan Widget dili alanına da üstün gelir. Örneğin:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" data-lang="page" defer></script>

Yönet panelindeki gömme kodunu olduğu gibi tutun ve yalnızca data-lang özniteliğini ekleyin. Satır içi sohbet paneli için data-lang etiketini <div data-chat-widget="…"> üzerine yerleştirin.

İpucu: Web siteniz <html> etiketinde bir lang özniteliği ayarlamıyorsa, bir tane ekleyin. Bu, özellikle yurt dışından gezinen ziyaretçiler için doğru dili seçmemiz adına elimizdeki en güçlü sinyaldir.

Müşteri Adayı Toplama ve Gizlilik #

• Ziyaretçi bilgilerini topla: Varsayılan olarak kapalıdır. Açık olduğunda, ziyaretçilerden konuşma başlamadan önce adları ve e-posta adresleri (ve isteğe bağlı olarak telefon numaraları) istenir, böylece sohbetin ortasında ayrılsalar bile potansiyel müşteriyi yakalamış olursunuz.
• Form başlığı ve Form alt başlığı: Formun üzerinde gösterilen başlığı ve kısa açıklamayı özelleştirin.
• Telefon numarası topla: Telefon numarası da istemek için açın; kapalı olduğunda yalnızca ad ve e-posta toplanır.
• Soyadı topla: Varsayılan olarak kapalıdır. Ad alanından hemen sonra zorunlu bir Soyadı alanı eklemek için açın. Bu, kişi üzerinde soyadı olarak kaydedilir, böylece yapay zekanız ve kendi sistemlerinizde aradığı her şey ilk mesajdan itibaren tam isme sahip olur. Siz bunu açmadan önce formu zaten doldurmuş olan ziyaretçilerden tekrar istenmez.
• Ziyaretçilere okunmamış yanıt e-postaları: E-posta adresi bırakan ve yanıtınızı 15 dakika sonra görmeyen bir ziyaretçiye, onu tekrar sohbete yönlendiren bir e-posta gönderilir. Ayarlar → Bildirimler → Sohbet widget’ı ziyaretçileri altından kapatın. Bkz. Sohbet widget’ı ziyaretçilerine e-postalar.

Bir ziyaretçi telefon numarası bıraktı ve sitenizden ayrıldı — WhatsApp üzerinden devam edebilir miyim? Evet. Sohbetlerini açın ve üç nokta menüsünden WhatsApp’ta devam et seçeneğini seçin (WhatsApp Web veya WhatsApp Business’ın bağlı olması gerekir). Your AI Connector, aynı kişi için bağlantılı bir WhatsApp görüşmesi oluşturur, adını, e-postasını ve ayrıntılarını kopyalar ve yapay zeka, sitenizde söylediklerini aktarır; böylece kimsenin kendini tekrar etmesine gerek kalmaz. Web sitesi sohbeti olduğu yerde kalır ve her iki sohbet de kişi panelindeki Bağlantılı görüşmeler altında birbirini işaret eder. Bkz. Sohbet Arayüzü.

Bir ziyaretçi e-posta adresini bıraktı ancak rezervasyon yapmadı; e-posta ile takip edebilir miyim? Evet, bir otomasyon ile. Kanal ayarı E-posta olarak seçilmiş bir Kişi oluştur adımı, ziyaretçinin bıraktığı adresi bağlı E-posta kanalınızda bir e-posta kişisine dönüştürür ve ardından gelen bir Mesaj gönder adımı e-posta olarak iletilir; yanıtlar e-posta temsilciniz için Sohbetler kısmına düşer. Rezervasyon yaptıklarını belirttiklerinde diziyi nasıl durduracağınız da dahil olmak üzere tarifin tamamı Otomasyonlar → Örnek: web sitesi sohbet potansiyel müşterileri için e-posta takipleri bölümündedir.

Yapay zeka temsilcisi WhatsApp’a geçişi kendisi teklif edebilir mi? Evet, hem de hiçbir ek özelliğe ihtiyaç duymadan; temsilcinin talimatlarına eklenecek tek bir satır bunu sağlar. WhatsApp numaranız için “Merhaba, web sitenizde sohbet ediyordum ve buradan devam etmek istiyorum” gibi önceden doldurulmuş bir mesaj içeren bir Kısa Bağlantı oluşturun, ardından temsilciye bunu ne zaman göndereceğini söyleyin, örneğin: “Ziyaretçinin ayrılması gerekiyorsa, daha sonra devam etmek istiyorsa veya WhatsApp’ı soruyorsa, oradan devam etmeyi teklif edin ve şu bağlantıyı gönderin: (kısa bağlantınız)”. Widget’taki bağlantılara tıklanabilir, böylece ziyaretçi numaranız seçili ve mesajı önceden yazılmış şekilde WhatsApp’a ulaşır ve ilk mesajları gelen kutunuzda bir WhatsApp görüşmesi başlatır. Ziyaretçi, widget formunda yazdığı telefon numarasını (ülke koduyla birlikte) bıraktıysa, Your AI Connector iki görüşmeyi otomatik olarak birbirine bağlar ve WhatsApp’taki yapay zeka, tıpkı WhatsApp’ta devam et özelliğinde olduğu gibi web sitesi sohbetini zaten bilir. Eğer hiçbir telefon numarası alınmadıysa, iki sohbet birbirine bağlanmaz; bu nedenle önceden doldurulmuş mesajı, WhatsApp temsilcisinin kişinin nereden geldiğini anlayabileceği kadar belirgin tutun.

• Gizlilik politikası onayını zorunlu kıl: İsteğe bağlı olarak ziyaretçilerin sohbet etmeden önce gizlilik politikanızı kabul etmelerini zorunlu kılın ve işaret ettiği URL’yi ayarlayın.

Widget, ziyaretçinin tarayıcısında ne saklar ve onu bir çerez banner’ının arkasına koymam gerekir mi? Sadece bir sayfa yüklendiğinde hiçbir şey saklanmaz. Widget, ziyaretçi sohbet etmeyi seçene kadar (ilk mesajı gönderene, ziyaretçi bilgi formunu doldurana veya gizlilik politikanızı kabul edene kadar) hiçbir çerez yazmaz ve tarayıcı depolama alanı kullanmaz. O andan itibaren, ziyaretçi geri döndüğünde sohbetin orada kalması için kendi alan adınızda birinci taraf depolama alanı olarak rastgele bir konuşma kimliği ve konuşmanın bir kopyasını tarayıcıda tutar. Analitik veya izleme betikleri yüklemez ve üçüncü taraf çerezleri ayarlamaz. Ziyaretçi sohbet etmek isteyene kadar hiçbir şey yazılmadığından, bu durum ziyaretçinin talep ettiği bir hizmet için kesinlikle gerekli olan depolama kapsamına girer; bu nedenle onu bir onay banner’ının arkasına almadan yükleyebilirsiniz. Siteniz yine de bir onay aracı kullanıyorsa, widget’ı bunun arkasında tutmanızda bir sakınca yoktur; ziyaretçi kabul ettiğinde sohbet basitçe görünür hale gelir.

Kanallar ve Yerleştirme #

• Ek dosyası düğmesi: Ziyaretçilerin sohbette görsel ve dosya göndermesine olanak tanır.
• Emoji seçici: Mesaj kutusunun yanına bir emoji seçici ekler.
• Kanal bağlantıları: Ziyaretçilerin görüşmeye tercih ettikleri platformda devam edebilmeleri için isteğe bağlı olarak WhatsApp, Instagram veya Messenger bağlantıları ekleyin. Bu seçenek yalnızca bir WhatsApp numarası (WhatsApp Business veya WhatsApp Web), Instagram veya Messenger hesabı bağladığınızda görünür. WhatsApp bağlantısını açmak, bağlı numaranızı otomatik olarak doldurur; bağlantı düzenlenebilir durumdadır, bu nedenle numaranızı değiştirdikten sonra yenisini oraya yazabilirsiniz.
• Eylem düğmeleri: Sohbetin üst kısmında yer alan ve ziyaretçiyi bir görüşmeye sokmak yerine başka bir yere yönlendiren kısayollar dizisi — aşağıda Eylem düğmeleri bölümüne bakın.
• Alan adı beyaz listesi: Widget’ınızın hangi web sitelerine yerleştirilebileceğini kısıtlayın. Widget’ı yüklediğiniz alan adlarını ekleyin (örneğin example.com veya *.example.com); herhangi bir alan adına izin vermek için boş bırakın.
• Engellenen ülkeler: Hizmet vermediğiniz ülkelerdeki ziyaretçilerin widget’ı görmesini engelleyin. Ağ konumu seçtiğiniz bir ülkede olan ziyaretçiler widget’ı asla görmez ve başlatmaya çalıştıkları her türlü sohbet reddedilir. Herkese izin vermek için boş bırakın. Aşağıda Botları ve kredi tüketimini engelleme bölümüne bakın.
• Bu sohbetleri şuraya yönlendir: Kopyalamak üzere olduğunuz koddan gelen sohbetleri karşılaması gereken temsilciyi seçin. Normal sohbet widget’ı yönlendirmenizi kullanmak için Hesap varsayılanı seçeneğinde bırakın. Aşağıda Farklı sayfaları farklı temsilcilere yönlendirme bölümüne bakın.
• Yerleştirme kod parçacığı: Yüzen baloncuk veya Satır içi seçeneğini belirleyin ve yükleme kodunu kopyalayın (aşağıya bakın).
• Müşteri demo bağlantısı: Herhangi bir web sitesi adresini yapıştırın ve Bağlantı oluştur’a tıklayarak, karşı tarafa hiçbir şey yüklemeden sitenizi widget’ınız çalışır halde açan paylaşılabilir bir bağlantı elde edin. Oluşturduğunuz her bağlantı listelenir ve her birini kapatabilirsiniz. Aşağıda Widget’ı başkasının web sitesinde gösterme bölümüne bakın.
• Paylaşım bağlantısı: Asistanınızı herhangi bir web sitesine ihtiyaç duymadan, tam ekran ve kendi sayfasında açan hazır bir bağlantı. Kopyalayın ve istediğiniz yere gönderin. Aşağıda Sohbete doğrudan bağlantı paylaşma bölümüne bakın.

Panelin alt kısmındaki Sohbet penceresini sil eylemi, pencereyi web sitenizden hemen kaldırır — bu işlem geri alınamaz ve ziyaretçiler artık sohbet balonunu görmez.

Eylem düğmeleri #

Bazı ziyaretçiler sohbet etmek istemez. Sadece telefon numaranızı, adresinizi veya e-posta adresinizi tek bir dokunuşla almak isterler. Eylem düğmeleri, tam olarak bu amaçla sohbet panelinin üst kısmında yer alan bir dizi kısayoldur.

Altı taneye kadar ekleyebilirsiniz. Her birinin bir etiketi (düğmenin üzerindeki metin) ve bir hedefi vardır; hedef, seçtiğiniz eyleme göre değişiklik gösterir:

Bu düğmeler kredi harcamaz. Birine dokunmak mesaj göndermez veya konuşma başlatmaz; sadece ziyaretçiyi gitmek istediği yere yönlendirir. Tıpkı daha önce olduğu gibi, yalnızca yapay zeka temsilcinizle yapılan gerçek bir konuşma kredi harcar.

Bilinmesi gereken birkaç nokta:

• Düğmeler, ziyaretçi sohbet ederken görünür kalır. Birisi iki soru sorup ardından sayfayı yenilemeden Yol Tarifi düğmesine dokunabilir.
• Etiketleriniz tam olarak yazdığınız şekilde görünür. Karşılama mesajınızın ve başlangıç sorularınızın aksine, düğme etiketleri otomatik olarak çevrilmez. Bu nedenle, ziyaretçilere birden fazla dilde hizmet veriyorsanız, etiketleri kısa ve anlaşılır tutun (veya ana dilinizde yazın).
• Bir düğmeyi düzgün şekilde doldurmazsanız kaydedilmez. Telefon numarası, e-posta adresi veya bağlantı geçerli değilse, panel bunu belirtir ve sitenizde hiçbir işe yaramayacak bir düğme yayınlamak yerine Değişiklikleri kaydet işlemini engeller.
• Bunlar SSS yanıtları değildir. Eylem düğmeleri insanları yalnızca başka bir yere yönlendirir; hazır metinlerle yanıt vermezler. Soruları yanıtlamak yapay zeka temsilcinizin görevidir ve bu yanıtları bilgi tabanınızdan alır. Ne sorulacağını önermek istiyorsanız, Görünüm ayarları altındaki başlangıç sorularını kullanın.

Özelleştiremeyecekleriniz #

Yönetim paneli tüm seçenekler kümesidir. Özellikle:

• Özel CSS veya stil sayfası yok. Stil belirleme; tema, köşe, yazı tipi ve renk seçicilerin sunduklarıyla sınırlıdır; widget’a kendi CSS’inizi ekleyemezsiniz ve sayfanızdaki kurallar widget’ın içine etki etmez.
• Mesaj kutusunda özel yer tutucu metin yok.
• Sohbet içinde video gömme yok.

Bunlardan biri sizin için bir engel teşkil ediyorsa, satır içi yerleştirme size en fazla kontrolü sağlar: widget, kendi sayfanızda boyutlandırdığınız ve konumlandırdığınız bir kapsayıcı içinde yer alır.

Botları ve Kredi Tüketimini Engelleme #

Her yapay zeka yanıtı kredi harcar, bu nedenle web sitenizde sürekli sohbet açan bir komut dosyası (veya canı sıkılmış bir kişi), herkese açık bir widget’ın savunması gereken tek şeydir. Widget bunun çoğunu kendi başına halleder ve Yönetim panelindeki iki ayar, bunu siteniz için sıkılaştırmanıza olanak tanır.

• Etki alanı beyaz listesi. Yalnızca listelediğiniz web siteleri widget’ı gösterebilir. Gömme kodunuzu başka bir siteye kopyalayan hiç kimse bir şey göremez.
• Engellenen ülkeler. Ağ konumu engellediğiniz bir ülkede olan ziyaretçiler widget’ı asla görmez ve yine de başlatmaya çalıştıkları bir sohbet reddedilir. Konum, ziyaretçinin bağlantısından gelir: VPN kullanan biri VPN’in ülkesinde görünür ve konumu belirlenemeyen bir ziyaretçi engellenmek yerine içeri alınır. Uygulama içindeki kendi önizlemeniz, içinde bulunduğunuz ülkeyi engelleseniz bile çalışmaya devam eder.
• Bağlantı başına yeni konuşmalar. Bir bağlantı (uygulamada bir ev veya ofis adresi), bir widget üzerinde günde 20 yeni konuşma başlatabilir. Mevcut sohbetlerine devam eden geri dönen ziyaretçiler sayılmaz, yalnızca yepyeni konuşmalar sayılır; bu nedenle yapay zeka yanıtlarını toplamak için sürekli yeni sohbetler başlatan bir komut dosyası 20’den sonra tükenirken, gerçek ziyaretçiler bunu asla fark etmez. Sitenizde birçok kişi aynı bağlantıyı paylaşıyorsa (bir kampüs, bir çağrı merkezi), max_new_chats_per_ip_daily ile REST API üzerinden sayıyı artırın; 0 kontrolü kapatır.
• İnsan doğrulaması (isteğe bağlı). Ziyaretçiler, ilk mesajları gönderilmeden önce hızlı bir Cloudflare Turnstile kontrolünden geçer, böylece bir komut dosyası sohbetleri hiç başlatamaz. Çoğu insan hiçbir şeye tıklamaz; Cloudflare yalnızca emin olmadığında bir onay kutusu gösterir. Kendi ücretsiz Turnstile anahtarlarınızı kullanır, aşağıda İnsan doğrulaması ekle bölümüne bakın.
• Yerleşik sınırlar. Bunun da ötesinde, her tarayıcı oturumunun dakika ve gün başına gönderebileceği mesaj sayısı sınırlıdır ve sohbeti yanıtlayan temsilci, Yanıt sınırları altında ayarlanan Sohbet başına maksimum yapay zeka mesajı sınırına ulaşıldığında ziyaretçiye yanıt vermeyi durdurur.

Bunların hiçbiri cihazları veya kişileri tanımlamaz: widget, ziyaretçi sohbet etmeyi seçene kadar tarayıcısında hiçbir şey saklamaz (yukarıya bakın) ve parmak izi alma (fingerprinting) özelliği yoktur.

İnsan doğrulaması ekle (Cloudflare Turnstile) #

Botlar web sitenizde sürekli sohbet açtığında ve yukarıdaki ayarlar yeterli olmadığında bunu açın. Kontrol, ziyaretçinin ilk mesajı gönderilmeden hemen önce bir kez çalışır. Başarılı olan bir ziyaretçi, tekrar görmeden 24 saat boyunca sohbet etmeye devam edebilir ve daha önceki bir konuşmaya geri dönen herkes, kontrol öncesinde konuşmayı okuyabilir.

1. Cloudflare hesabınızda oturum açın (ücretsiz bir hesap yeterlidir) ve Turnstile’ı açın.
2. Add widget (Widget ekle) öğesine tıklayın, bir ad verin ve sohbet widget’ınızın çalıştığı her etki alanını ekleyin (örneğin yourshop.com). Widget modunu Managed (Yönetilen) olarak bırakın.
3. Cloudflare’in size gösterdiği Site key (Site anahtarı) ve Secret key (Gizli anahtar) değerlerini kopyalayın.
4. Uygulamada, sohbet widget’ınızın Manage (Yönet) panelini açın, Human check before chatting (Sohbet etmeden önce insan doğrulaması) seçeneğini açın, her iki anahtarı da yapıştırın ve kaydedin.

Ne beklemeli:

• Her iki anahtar da girilene kadar kontrol kapalı kalır, bu nedenle anahtarlar olmadan açmak ziyaretçileri asla dışarıda bırakmaz.
• Bir ziyaretçi kontrolü geçemezse veya çözülmemiş bırakırsa, mesajı gönderilmez ve bir Yeniden Dene düğmesi görür.
• Kontrol yalnızca Cloudflare’de eklediğiniz etki alanlarında görünür. Başka herhangi bir etki alanında Cloudflare bunu reddeder ve o sitedeki hiç kimse mesaj gönderemez, bu nedenle açmadan önce her etki alanını ekleyin.
• Web siteniz bir İçerik Güvenliği Politikası (Content Security Policy) kullanıyorsa, komut dosyaları ve çerçeveler için https://challenges.cloudflare.com öğesine izin verin, aksi takdirde kontrol yüklenemez.
• Anahtarlar kendi Cloudflare hesabınıza aittir ve gizli anahtar ziyaretçilerinizin tarayıcılarına asla gönderilmez.

Kurulum Talimatları #

Sohbet penceresini web sitenize eklemek için sitenizin HTML’sine bir satır kod ekleyin.

1. Web sitenizin HTML dosyasını bir metin düzenleyicide açın.
2. Kapanış </body> etiketini bulun — bu genellikle dosyanın en sonundadır.
3. Sayfanızın geri kalanının önce yüklenmesi için bu kod satırını </body> etiketinden hemen önce yapıştırın:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

4. CONFIG_ID kısmını, Yönetim panelindeki Kanallar ve Gömme (Channels & Embed) bölümünde gösterilen benzersiz yapılandırma tanımlayıcınızla değiştirin. Bu tanımlayıcı hesabınıza özeldir ve widget’ı mesajlaşma sisteminize bağlar.

Kod parçacığı sitenizi yavaşlatmaz: küçük bir yükleyicidir ve widget’ın kendisi sayfayı engellemeden arka planda indirilir. Yine de widget’ın sayfanız tamamen yüklenene kadar beklemesini isterseniz, aynı URL’yi bunun yerine şu şekilde sarmalayabilirsiniz:

<script>
window.addEventListener('load', function () {
  var s = document.createElement('script');
  s.src = 'https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID';
  s.async = true;
  document.body.appendChild(s);
});
</script>

Eğer geciktirmek istediğiniz şey widget yüklemesi değil de küçük davet balonu ise, bu yukarıdaki Davranış bölümünde bulunan Proaktif açılır balon gecikmesidir; kod gerekmez.

Shopify’a yükleme #

1. Shopify yöneticinizde Online Mağaza > Temalar bölümüne gidin.
2. Mevcut (yayınlanmış) temanız olarak işaretli temanın yanındaki … düğmesine tıklayın ve Kodu düzenle seçeneğini belirleyin. Bir taslak veya temanın kopyası üzerinde yapılan düzenlemeler canlı mağazanızda hiçbir şeyi değiştirmez.
3. layout/theme.liquid dosyasını açın ve alt kısımdaki kapanış </body> etiketine kadar aşağı kaydırın.
4. Yükleme satırınızı </body> etiketinin hemen üzerine yapıştırın ve Kaydet’e tıklayın:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

Widget’ı yükleme satırı defer içermeden önce yüklediyseniz, Shopify’ın kod düzenleyicisi altında kırmızı bir alt çizgi gösterir. Bu alt çizgi, Shopify’ın kod denetleyicisinden gelen, defer veya async içermeyen script satırlarıyla ilgili bir uyarıdır, bir hata değildir: tema yine de kaydedilir ve widget çalışmaya devam eder. Yukarıda gösterildiği gibi defer eklemek alt çizgiyi kaldırır ve widget’ın çalışma şeklinde hiçbir şeyi değiştirmez, bu nedenle diğer sitelerde yeniden yükleme yapmanıza gerek yoktur.

İşte sohbet penceresi uygulanmış bir HTML dosyasının nasıl görünmesi gerektiğine dair tam bir örnek:

<!DOCTYPE html>
<html>
<head>
    <title>My Website</title>
</head>
<body>
    <!-- Your existing website content would be here -->

    <!-- Chat Widget Integration -->
    <script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>
</body>
</html>

Sayfa İçine Gömme (Gelişmiş) #

Sohbetin köşede yüzen bir baloncuk yerine sayfanızın bir parçası olarak (örneğin özel bir “Bize ulaşın” bölümü, yardım sekmesi veya kenar çubuğu içinde) görünmesini tercih ederseniz, Yönetim panelinde Gömme kod parçacığı (Embed snippet) ayarını Satır içi (Inline) olarak değiştirin ve satır içi kod parçacığını kopyalayın.

Şu şekilde görünür:

<div data-chat-widget="CONFIG_ID" style="width:100%;height:600px;"></div>
<script src="https://api.youraiconnector.com/v1/chat-widget/embed.js" async></script>

<div> bağlama noktasıdır; sohbet paneli bunun içinde oluşturulur ve boyutlarını doldurur. Div’i dilediğiniz gibi biçimlendirin (sabit bir yükseklik verin, bir flex konteyner içine yerleştirin, bir ızgara hücresine koyun vb.) ve sohbet paneli buna uyum sağlayacaktır.

Birden fazla sohbet widget’ı yerleştiriyor olsanız bile sayfada sadece bir <script> etiketine ihtiyacınız vardır. Komut dosyası, sayfadaki her <div data-chat-widget="…"> etiketini tarar ve her birine bir sohbet paneli yerleştirir.

Satır içi (inline) ve kayan (floating) kullanım arasında ne zaman seçim yapmalı:

• Kayan baloncuk, site genelinde her zaman erişilebilir bir “Yardıma mı ihtiyacınız var?” butonu için uygundur.
• Satır içi yerleştirme, sohbetin belirli bir yerde (destek sayfası, bilgi bankası kenar çubuğu, uygulama içi yardım sekmesi gibi) bulunması ve o sayfanın doğal bir parçası gibi hissettirmesi gerektiğinde uygundur.

Satır içi gömme, yüzen baloncukla aynı yapılandırmayı (logo, açılış mesajı, müşteri adayı yakalama, başlangıç soruları vb.) yeniden kullanır, böylece hiçbir şeyi iki kez ayarlamanız gerekmez.

Widget’ı Başkasının Web Sitesinde Gösterme #

Sohbet widget’ınızı kontrolünüzde olmayan bir web sitesinde, herhangi bir kod veya site erişimi gerektirmeden çalışırken gösterebilirsiniz. Bu, bir potansiyel müşteriye asistanın kendi sayfalarında nasıl görüneceğini göstermenin en hızlı yoludur.

1. Yönetim panelini açın ve Kanallar ve Gömme (Channels & Embed) kısmına gidin.
2. Müşteri demo bağlantısı (Client demo link) kısmına web sitesi adresini yazın (örneğin www.theircompany.com).
3. İsteğe bağlı: alanın altında, bu demoda yanıt vermesi gereken Temsilciyi (Agent) seçin; örneğin, potansiyel müşterinin kendi web sitesinden oluşturduğunuz ve hizmetleri, fiyatları ve SSS’leri hakkında konuşan bir temsilciyi seçebilirsiniz. Normal sohbet aracı yönlendirmenizi kullanmak için bunu Hesap varsayılanı (Account default) olarak bırakın.
4. Bağlantı oluştur (Create link) düğmesine tıklayın. Bağlantı sizin için kopyalanır ve alanın altındaki listede, Kopyala (Copy) ve Aç (Open) düğmeleri ve kullandığı temsilci ile birlikte görünür.
5. Bağlantıyı göstermek istediğiniz kişiye gönderin.

Bağlantıyı açmak, o web sitesini sohbet widget’ınız üzerinde yüzer haldeyken yükler; tıpkı yüklüymüş gibi görünür. Bağlantıya sahip olan herkes bunu açabilir; giriş yapılması gereken bir şey yoktur.

Bilinmesi gereken birkaç nokta:

• Demodan gelen sohbetler gerçektir. Bir ziyaretçinin demoda gönderdiği mesajlar gelen kutunuza ulaşır, temsilciniz tarafından yanıtlanır ve diğer tüm sohbetler gibi kredi kullanır.
• Sayfa markasızdır. Sadece onların web sitesini ve sizin pencerenizi gösterir, başka hiçbir şey göstermez.
• Bazı web siteleri çerçevelenemez. Birçok site (bankalar, büyük perakendeciler, katı güvenlik ayarları arkasındaki her şey) diğer sayfaların kendilerini görüntülemesini engeller. Bu durumda bağlantı yine de çalışır: gerçek site yerine tarafsız bir sahte tarayıcı penceresi gösterir ve pencereniz bunun üzerinde canlı olarak çalışarak demonun işlevini yerine getirmesini sağlar.
• Web sitelerini değiştirmez. Hiçbir şey yüklenmez ve hiçbir şey değiştirilmez; demo sadece o bağlantının içinde var olur.
• Demo bittiğinde bağlantıyı kapatın. Listedeki bağlantının yanındaki Kapat’a tıklayın ve onaylayın. O andan itibaren, bağlantıyı açan herkes bağlantının kapatıldığını belirten bir sayfa görür. Pencereniz ve diğer demo bağlantılarınız çalışmaya devam eder. Kapatılan bir bağlantı tekrar açılamaz; bunun yerine yeni bir tane oluşturun.
• 25 Eylül 2026’dan önce kopyalanan bağlantılar. Liste mevcut olmadan önce oluşturulan demo bağlantıları listede yer almaz. Listenin altındaki Bunları kapat’a tıklayana kadar çalışmaya devam ederler; bu işlem hepsini aynı anda kapatır (Bunları tekrar aç seçeneği ise işlemi geri alır).

Bir temsilci seçilmeden oluşturulan demo bağlantısı, Bu sohbetleri şuraya yönlendir ayarı ne olursa olsun hesap varsayılan yönlendirmenizi kullanır. Bir temsilci seçildiğinde, o bağlantıdan gelen her sohbet o temsilciye atanır ve onun tarafından yanıtlanır. Pencere kendi görünümünü, adını ve açılış mesajını korur. Bağlantı bunu &agent=AGENT_ID olarak taşır; bunu manuel olarak eski bir bağlantıya eklemek de işe yarar (bağlantı zaten bir ? içerdiğinden ? değil, & kullanın).

Daha sonra bir demo bağlantısının kullandığı temsilciyi silerseniz, bağlantı çalışmaya devam eder: sohbetleri bunun yerine hesap varsayılan yönlendirmenize gider ve liste yanında “silinmiş temsilci, varsayılanı kullanır” ifadesini gösterir. Sohbet aracınızın varsayılanı olan temsilciyi silmek, başka bir temsilciye sabitlenmiş bağlantıları etkilemez.

Sohbete Doğrudan Bağlantı Paylaşma #

Bazen widget’ı koyabileceğiniz bir web sitesi olmaz; birine bir bağlantı verip asistanınızla hemen konuşmaya başlamasını istersiniz. Her sohbet widget’ının bir tane bağlantısı vardır:

1. Yönet panelini açın ve Kanallar ve Yerleştirme kısmına gidin.
2. Paylaşım bağlantısı seçeneğini bulun (Müşteri demo bağlantısının hemen altındadır).
3. Bağlantıyı almak için Kopyala’ya veya kendiniz denemek için Aç’a tıklayın.

Bunu açmak, ekranı tamamen kaplayan asistanınızdan başka hiçbir şey göstermez; arkasında bir web sitesi, tıklanacak bir baloncuk veya yüklenmesi gereken bir şey yoktur. Bunu Instagram biyografinize, bir el ilanındaki QR koduna, e-posta imzanıza veya bir potansiyel müşteriye gönderdiğiniz WhatsApp mesajına ekleyebilirsiniz.

Paylaş bağlantısı, sohbet pencerenizin varsayılan yönlendirmesini izler. Bunun yerine belirli bir temsilciyi açmak için bağlantının sonuna ?agent=AGENT_ID ekleyin; bu bağlantıdan gelen her sohbet o temsilciye atanır ve onun tarafından yanıtlanır, bu sırada sayfa pencerenizin adını ve açılış mesajını korur.

Bilinmesi gereken birkaç nokta:

• Bağlantıdan gelen sohbetler gerçektir. Gelen kutunuza düşerler, temsilciniz bunları yanıtlar ve diğer tüm konuşmalar gibi kredi kullanırlar.
• Sayfa bize ait herhangi bir marka logosu taşımaz. Sadece asistanınızı gösterir ve arama sonuçlarının dışında tutulur.
• Kendi adresinizde çalışır. Sağlayıcınız uygulamayı kendi alan adında çalıştırıyorsa, bağlantı da o adresi kullanır, böylece içinde yabancı bir şey görünmez.
• Bağlantı başına, tarayıcı başına bir ziyaretçi. Bunu açan kişi o tarayıcıda aynı kimliği korur, bu nedenle daha sonra geri gelmek yeni bir yabancıyla başlamak yerine aynı konuşmayı devam ettirir. Farklı bir tarayıcı veya farklı bir widget bağlantısı, farklı bir ziyaretçi anlamına gelir.

Farklı Sayfaları Farklı Temsilcilere Yönlendirme #

Varsayılan olarak, widget’ınız aracılığıyla gelen her sohbet aynı temsilci tarafından karşılanır. Bunu sayfa bazında geçersiz kılabilirsiniz; böylece fiyatlandırma sayfanızdaki ziyaretçiler satış temsilcinizle konuşurken, yardım sayfanızdaki ziyaretçiler destek temsilcinizle konuşur ve tüm bunlar tek bir sohbet widget’ı üzerinden gerçekleşir.

Kodu almanın iki yolu vardır:

• Temsilciden. Yapay Zeka Temsilcileri sayfasında, satırdaki </> düğmesine tıklayın veya temsilciyi açıp Giriş Noktaları sekmesine gidin. Her iki durumda da, doğrudan o temsilciye yönlendirilmiş, yapıştırılmaya hazır bir kod parçacığı alırsınız.

  Bir temsilcinin Giriş noktaları sekmesinde ayrıca, o temsilcinin halihazırda kaç web sitesi sohbetini yönettiğini gösteren bir Web sitesi sohbet aracı paneli bulunur. Gömülü koddan gelen sohbetler doğrudan temsilciye ulaşır, bu nedenle bunlar için bir giriş noktası kuralı oluşturmanıza gerek yoktur; hiçbir kuralı olmayan bir temsilci bile kendi gömülü kodundan gelen sohbetleri yanıtlar.

  </> düğmesi yalnızca aktif temsilcilerde görünür. Duraklatılmış bir temsilci sohbeti alır ancak yanıt veremez, bu nedenle siz tekrar açana kadar seçenek gizlenir. Bir temsilci için ayarlanacak bir kanal yoktur; bir temsilci herhangi bir kanaldan sohbeti devralabilir.

• Widget ayarlarından. Sohbet widget’ınızdaki Ayarlar → Kanallar → Yönet bölümünde, Bu sohbetleri şuraya yönlendir seçeneğini ayarlayın ve altındaki kod parçacığını kopyalayın. Açılır menüyü değiştirmek kod parçacığını yeniden yazar.

Yüzen kod parçacığı, hedefi adresin içinde taşır:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID?agent=AGENT_ID" defer></script>

Satır içi kod parçacığı ise bunu <div> üzerinde taşır, böylece tek bir sayfa farklı yerlere giden birkaç sohbeti barındırabilir:

<div data-chat-widget="CONFIG_ID" data-agent="AGENT_ID" style="width:100%;height:600px;"></div>
<script src="https://api.youraiconnector.com/v1/chat-widget/embed.js" async></script>

Kampanyalar kullanımdan kaldırılmadan önce kopyalanan kod parçacıkları bunun yerine ?campaign= veya data-campaign= içerir. Bunlar çalışmaya devam eder, bu nedenle yeniden yapıştırılacak bir şey yoktur.

Bilinmesi gereken birkaç nokta:

• Kimliği elle yazmak yerine kopyala düğmesini kullanın. Kimlik hesabınızdaki bir temsilciyle eşleşmezse, sohbet yine de çalışır ancak varsayılan yönlendirmenize döner.
• Halihazırda sohbetin ortasında olan biri, daha sonra başka bir yere yönlendiren bir sayfaya gelse bile başladığı kişiyle kalır. Bu, sohbetin yarı yolda kişilik değiştirmesini önler.
• Sayfaya özel bir hedef, hesap varsayılanınızdan ve anahtar kelime tetikleyicilerinden önceliklidir.

Widget’a Ziyaretçinin Kim Olduğunu Söyleyin (Gelişmiş) #

Sohbet widget’ını bir üye alanına, müşteri portalına veya insanların zaten oturum açmış olduğu bir uygulamaya yerleştirirseniz, siteniz zaten kim olduklarını biliyor demektir. Ziyaretçiden daha önce verdiği bilgileri tekrar istememek ve yapay zekanızın onlar hakkında zaten bildiklerinizi kullanabilmesi için bu bilgileri widget’a aktarabilirsiniz.

Widget betiğinden önce küçük bir ayar bloğu ekleyin:

<script>
  window.chatWidgetSettings = {
    visitor: {
      id: "12345",
      name: "Maria",
      email: "maria@example.com",
      phone: "+391234567890"
    },
    data: {
      plan: "Professional",
      customer_since: "2024",
      last_order: "A-2291"
    }
  };
</script>
<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

Sayfanız, oturum açmış olan kişiye göre bu değerleri sunucu tarafında doldurmalıdır.

Bir soyadı da kaydetmek için, visitor bloğunda (satır içi yerleştirmede data-visitor-last-name) name yanına last_name ekleyin. Bu isteğe bağlıdır: Soyadı topla açık olsun ya da olmasın, formu geçmek için bir ad ve e-posta hala yeterlidir.

İki şey gerçekleşir:

• “Başlamadan önce…” formu atlanır. İsim ve e-posta sağlandığında, ziyaretçi doğrudan sohbete geçer ve bu bilgiler, sanki kendisi yazmış gibi kişisine kaydedilir.
• data altındaki her şey yapay zekanıza iletilir. Oraya koyduğunuz her şey (plan, sipariş numarası, yenileme tarihi, kredi bakiyesi, kaç koltuğa sahip oldukları vb.), yapay zekanın o kişi hakkında bildiklerinin bir parçası haline gelir; böylece “planım ne zaman yenileniyor?” gibi soruları, önce kim olduklarını açıklamalarını istemeden yanıtlayabilir. Sizin için anlamlı olan herhangi bir alan adını kullanabilirsiniz; bunlar kişi üzerinde Özel Alanlar altında görünür. Her mesajla birlikte güncel olarak gönderilen 20 değere kadar bilgi iletilebilir, böylece plan sohbet sırasında değişirse yapay zeka yenisini görür.

Satır içi yerleştirmeler için aynı bilgileri bunun yerine <div> üzerine koyabilirsiniz; bu, bir sayfada birden fazla sohbet olduğunda kullanışlıdır:

<div data-chat-widget="CONFIG_ID"
     data-visitor-name="Maria"
     data-visitor-email="maria@example.com"
     data-visitor-data='{"plan":"Professional"}'
     style="width:100%;height:600px;"></div>
<script src="https://api.youraiconnector.com/v1/chat-widget/embed.js" async></script>

Siteniz ziyaretçinin kim olduğunu ancak sayfa yüklendikten sonra biliyorsa (örneğin, oturum açma işleminin sayfa yenilenmeden gerçekleştiği tek sayfalık bir uygulama), ayrıntılara sahip olduğunuzda bunu çağırın; widget kendini güncelleyecektir:

<script>
  window.chatWidget.setVisitor({
    visitor: { id: "12345", name: "Maria", email: "maria@example.com" },
    data: { plan: "Professional" }
  });
</script>

Bilinmesi gereken birkaç nokta:

• Aynı bilgisayarda iki farklı kişi oturum açarsa, ikincisi ilkinin sohbetini görmek yerine yeni bir konuşma başlatır. Widget, kişi değişikliğini fark eder ve kendini sıfırlar.
• Bu özellik tek başına bağlam içindir, birinin oturumunu açmak için değildir. Konuşmalar her zaman olduğu gibi ayrı tutulur, bu nedenle bir id geçirmek kimsenin başkasının sohbetini açmasına izin vermez ve farklı bir cihaz veya tarayıcı kullanan biri orada yeni bir konuşma başlatır. Konuşmayı cihazlar arasında taşımak için, bir sonraki bölümde açıklandığı gibi id oturumunu açın.
• İsteğe bağlıdır. Normal bir herkese açık sayfadaki widget bunların hiçbirine ihtiyaç duymaz ve tam olarak daha önce olduğu gibi davranır.

Aynı konuşmaya herhangi bir cihazda devam edin (oturum açmış ziyaretçi kimliği) #

Müşterilerinizin hesapları varsa, sohbetlerinin onları takip etmesini sağlayabilirsiniz: telefonda oturum açın, dizüstü bilgisayarda devam edin; gelen kutunuzdaki aynı kişiyle aynı konuşma olur ve yapay zeka söylenen her şeyi bilir. Bunun için Your AI Connector, ziyaretçinin gerçekten sayfanızın iddia ettiği kişi olduğuna dair kanıta ihtiyaç duyar, aksi takdirde herkes tarayıcısına bir müşteri numarası yazıp o müşterinin sohbetini okuyabilir. Kanıt, sunucunuzda hesapladığınız bir imzadır.

1. Widget’ın Yönet panelinde, Kanallar ve Yerleştirme altında Oturum açmış ziyaretçiler kısmını bulun ve Gizli anahtar oluştur’a tıklayın. Kimlik gizli anahtarını kopyalayın. Bunu yalnızca sunucunuzda tutun; asla sayfanın kendisine koymayın.

2. Sunucunuz oturum açmış bir müşteri için bir sayfa oluşturduğunda, o müşterinin kimliğini (ID) gizli anahtarı kullanarak küçük harfli onaltılık (hex) bir dize olarak HMAC-SHA256 ile hesaplayın:

// Node.js
const hash = require("crypto").createHmac("sha256", IDENTITY_SECRET).update(customerId).digest("hex");

// PHP
$hash = hash_hmac('sha256', $customerId, IDENTITY_SECRET);

# Python
import hmac, hashlib
hash = hmac.new(IDENTITY_SECRET.encode(), customer_id.encode(), hashlib.sha256).hexdigest()

3. Kimliği ve karmayı (hash), zaten ilettiğiniz ad ve e-postanın yanındaki ayarlar bloğuna yerleştirin:

<script>
  window.chatWidgetSettings = {
    visitor: {
      id: "12345",
      hash: "3f2a…e91c",
      name: "Maria",
      email: "maria@example.com"
    }
  };
</script>
<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

Satır içi gömme, <div> üzerindeki data-visitor-hash ile aynı değeri alır ve window.chatWidget.setVisitor({ visitor: { id, hash } }), sayfayı yeniden yüklemeden kişilerin oturumunu açan uygulamalar için çalışır.

İmza doğrulandığında ne olur:

• Müşterinin sohbeti tarayıcı altında değil, hesabı altında saklanır, böylece oturum açtıkları her cihazda ve her tarayıcıda aynı konuşma olur ve gelen kutunuzda tek bir kişi olarak görünür.
• Önceki mesajları yeni cihazda yüklenir ve yapay zeka kaldığı yerden devam eder.
• İmza yanlışsa, widget sessizce daha önce olduğu gibi normal, tarayıcı bazlı bir sohbet gibi davranır ve bir geliştiricinin fark edebilmesi için nedeni tarayıcı konsoluna yazdırır. Ziyaretçileriniz asla bir hata görmez.
• Kimlik, gönderdiğiniz şekilde tam olarak karşılaştırılır, bu nedenle id olarak ilettiğiniz değerin aynısını imzalayın ve her yerde aynı kişi için aynı kimliği kullanın.

Bilmeniz gereken iki şey:

• Yönet panelindeki Yeniden oluştur, size yeni bir gizli anahtar verir. Eski anahtarla oturum açmaya devam eden sayfalar, sunucunuz yeni gizli anahtarı kullanana kadar normal tarayıcı bazlı sohbetlere geri döner. Mevcut konuşmalar korunur; bunlar gizli anahtara değil, müşterinin kimliğine bağlıdır.
• Birinin anonim bir ziyaretçi olarak oturum açmadan önce yaptığı konuşma, ayrı bir sohbet olarak kalır. Hesap tabanlı konuşma, oturum açmışken gönderdikleri ilk mesajla başlar.

Widget Ayarlarını Kendi Kodunuzdan Değiştirin (API) #

Widget’ın Yönet panelindeki her şey REST API üzerinden de değiştirilebilir; bu, birçok web sitesini yönetiyorsanız veya bir müşteri için ek dosya düğmesinin otomatik olarak kapatılmasını istiyorsanız oldukça kullanışlıdır. API anahtarınızla birlikte https://api.youraiconnector.com/v1/chat-widget-configs/CONFIG_ID adresine bir PATCH gönderin ve yalnızca değiştirmek istediğiniz alanları belirtin; örneğin {"show_upload_button": false} ek dosya düğmesini gizler, {"show_emoji_button": false} emoji seçiciyi gizler ve {"launcher_icon": "chat-dots"} başlatıcı simgesini değiştirir. CONFIG_ID, yerleştirme kodunuzdakiyle aynı tanımlayıcıdır. Kabul edilen alanların tam listesi (ad, karşılama mesajı, renkler, başlatıcı simgesi, izin verilen alan adları, ziyaretçi bilgi formu, gizlilik bildirimi, tema, köşe ve yazı tipi stili) API Başvurusu altında Sohbet Widget’ı bölümünde yer almaktadır. Web siteleri, değişikliği sayfa bir sonraki yüklendiğinde algılar.

Kurulumdan Sonra Sizi Neler Bekliyor #

Komut dosyasını web sitenize ekledikten sonra, sohbet widget’ı web sitenizin köşesinde (varsayılan olarak sağ alt) otomatik olarak bir sohbet düğmesi oluşturacaktır. Widget, kullanıcılar sayfalarınızda gezinirken sabit bir konumda kalarak her zaman erişilebilir olmasını sağlar.

Ziyaretçiler bu düğmeye tıkladığında, karşılama mesajınızı göstererek konuşmayı başlatabilecekleri tam bir sohbet penceresine genişler. Ziyaretçi bilgilerini topla özelliği açıksa, yazmaya başlamadan önce adlarını ve e-postalarını (ve isteğe bağlı olarak telefonlarını) isteyen küçük bir form görünür.

Sohbet arayüzü farklı ekran boyutlarına otomatik olarak uyum sağlar, bu nedenle hem masaüstü hem de mobil cihazlarda sorunsuz çalışır.

Uygulamanızı Test Etme #

Widget’ı sitenize ekledikten sonra çalıştığını test edin:

1. Web sitenizi bir tarayıcıda açın.
2. Widget’ı açmak için sohbet düğmesine tıklayın.
3. Bir test mesajı gönderin ve yanıt aldığınızı doğrulayın.
4. Her yerde çalıştığından emin olmak için farklı bir cihaz veya tarayıcıda tekrarlayın.

Sohbet widget’ı sitenizde görünmüyorsa şunları kontrol edin:

1. CONFIG_ID kısmını gerçek yapılandırma tanımlayıcınızla değiştirdiğinizden emin olun.
2. Script etiketinin kapanış </body> etiketinden önce yerleştirildiğinden emin olun.
3. Kodda yazım hatası olup olmadığını kontrol edin.
4. Shopify’da, yayınlanmış temayı düzenlediğinizden ve Kaydet’e tıkladığınızdan emin olun. Bir taslak veya kopyalanmış tema üzerinde yapılan düzenlemeler asla canlı mağazanıza ulaşmaz.

Kurumsal Güvenlik Duvarının Arkasında #

Widget halka açık olarak yükleniyor ancak ofis ağındaki personel için yüklenmiyorsa, ağ neredeyse kesinlikle yüklendiği alan adını engelliyordur. BT ekibinizden 443 numaralı bağlantı noktasında (port) normal HTTPS üzerinden şunlara izin vermelerini isteyin:

• Yerleştirme kodunuzdaki alan adı — Yönetim panelinden kopyaladığınız <script src="..."> satırındaki adres.
• api.youraiconnector.com — widget mesajlarını buraya da gönderir.

Başka hiçbir şeyin açılmasına gerek yoktur: ek bağlantı noktaları veya gelen kuralları gerekmez. Widget buna rağmen görünmüyorsa, sayfada tarayıcınızın geliştirici konsolunu açın ve bize bildirdiklerini gönderin; engellenen bir istek, reddedilen alan adını belirtir ve bu genellikle cevabın tamamıdır.