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ı tema; görünümü, renkleri, köşeleri ve yazı tipini birlikte 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 ve yarı saydam bir panel; başlık ve mesaj kutusu 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 herhangi bir 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 (Varsayılan, Serif, Yuvarlak veya Mono) seçer — 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ünecek 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 (sohbet balonu, kağıt uçak, soru işareti ve daha fazlası) seçin, 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 oldukça kullanışlıdır.
• Renkler: Her biri widget’ın boyadığı kısmını belirten beş renk. Marka rengi, kayan düğme, başlık ve ziyaretçinin kendi mesajları içindir; Marka metni ise bunların üzerindeki 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 edemezler. 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ışması durumunda 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?” — 10 taneye kadar eklenebilir.

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 balon: İnsanları sohbete davet etmek için sohbet düğmesinin yanında beliren isteğe bağlı küçük bir balon. Mesajını, kabul et/reddet düğmesi metnini ve görünmeden önce kaç saniye bekleneceğini ayarlamak için açın. Balon, kimse tıklamazsa 20 saniye sonra kendiliğinden gizlenir (bu sayı sabittir) ve bir ziyaretçi Şimdi değil düğmesine tıkladığında, ziyaretinin geri kalanında tekrar görünmez. Sohbet penceresi kendi kendine asla açılmaz: ziyaretçi sohbet düğmesine veya balona tıkladığında açılır ve kapatana kadar açık kalır.
• Yapay zeka yanıt hızı: Daha yavaş (daha insansı — yapay zeka yanıt vermeden önce 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 ortada yer alır.

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. İkisi de desteklediğimiz bir dil değilse, İngilizce gösterir.
• Veya kendiniz bir tane seçin. Davranış bölümündeki Widget dili alanı varsayılan olarak yukarıdaki algılamayı yapan Otomatik olarak ayarlanmıştır. Oradan bir dil seçerseniz, widget’ın kendi etiketleri (ziyaretçi formundaki Ad, E-posta ve Telefon alanları ve ö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, Rumence, Lehçe, Arapça, Fince ve Filipince. Bu, widget’ın kendi düğmeleri ve etiketleri için olan listedir.
• Mesajlarınız sizin için çevrilir. Her kaydettiğinizde, karşılama mesajınız, proaktif açılır balonunuz ve başlangıç sorularınız yukarıdaki on iki dilin tamamına çevrilir. Bunları yalnızca bir kez, tercih ettiğiniz dilde yazarsınız.
• 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. 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.

İ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-postaları (ve isteğe bağlı olarak telefon numaraları) istenir, böylece sohbeti yarıda bıraksalar 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 sadece ad ve e-posta toplanır.

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ü.

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 dosya düğmesi: Ziyaretçilerin sohbette görsel ve dosya göndermesini sağlar.
• Emoji seçici: Mesaj kutusunun yanına bir emoji seçici ekler.
• Kanal bağlantıları: Ziyaretçilerin konuşmaya 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ı, Instagram veya Messenger hesabı bağladığınızda görünür.
• Eylem düğmeleri: Sohbetin en üstünde yer alan ve ziyaretçiyi konuşma başlatmak yerine başka bir yere yönlendiren kısayollar dizisi — aşağıda Eylem düğmeleri bölümüne bakın.
• Etki alanı beyaz listesi: Widget’ınızın hangi web sitelerine yerleştirilebileceğini kısıtlayın. Widget’ı yüklediğiniz etki alanlarını ekleyin (örneğin example.com veya *.example.com); herhangi bir etki alanına izin vermek için boş bırakın.
• Bu sohbetleri şuraya yönlendir: Kopyalamak üzere olduğunuz koddan gelen sohbetleri karşılaması gereken kampanyayı veya 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ı kampanyalara 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ı: Widget’ınızın üzerinde çalıştığı bir siteyi açan paylaşılabilir bir bağlantı almak için herhangi bir web sitesi adresi yapıştırın; karşı tarafın bir şey yüklemesi gerekmez. Aşağıda Widget’ı başkasının web sitesinde gösterme 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; tema, köşe, yazı tipi ve renk seçicilerin sunduklarıdır — widget’a kendi CSS’inizi enjekte edemezsiniz ve sayfanızdaki kurallar widget’ın içine etki etmez.
• Mesaj kutusunda özel yer tutucu metin yok.
• Ülke veya coğrafi kısıtlama yok. Etki alanı beyaz listesi, widget’ı hangi web sitelerinin yerleştirebileceğini sınırlar; ziyaretçinin nerede olduğuna bağlı olarak onu göstermenin veya gizlemenin bir yolu yoktur. Buna ihtiyacınız varsa, yerleştirme kodunu istemediğiniz sayfalarda veya kitleler için kendiniz gizleyin.
• Sohbet içinde video yerleştirme yok.
• Otomatik gizleme zamanlayıcısı yok. Davet balonu 20 saniye sonra kendiliğinden kaybolur ve bu sayı değiştirilemez; açık sohbet penceresi kendi kendine asla kapanmaz. Balon sayfa içeriğinizin üzerinde kalıyorsa, widget’ı Konum ofsetleriyle taşıyın veya balonu kapatıp sadece başlatıcı düğmeyi tutun.

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.

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"></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.

İş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"></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 Yerleştirme bölümüne gidin.
2. Müşteri demo bağlantısı kısmına web sitesi adresini yazın (örneğin www.theircompany.com).
3. Bağlantıyı kopyalamak için Kopyala’ya veya önce kendiniz görmek için Aç’a tıklayın.
4. 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 düşer, temsilciniz tarafından yanıtlanır ve diğer tüm görüşmeler gibi kredi harcar.
• Sayfa markasızdır. Sadece onların web sitesini ve sizin widget’ınızı 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 siteler) 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 widget’ınız üzerinde canlı olarak çalışmaya devam ederek demo işlevini yerine getirir.
• 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 bağlantısı, Bu sohbetleri şuraya yönlendir ayarı ne olursa olsun her zaman hesap varsayılan yönlendirmenizi kullanır. Demo sohbetlerinin belirli bir temsilci tarafından karşılanmasını istiyorsanız, önce o temsilciyi sohbet widget’ınızın varsayılanı olarak ayarlayın.

Farklı Sayfaları Farklı Kampanyalara Yönlendirme #

Varsayılan olarak, widget’ınız aracılığıyla gelen her sohbet aynı kampanya veya temsilci tarafından ele alınır. Bunu sayfa bazında geçersiz kılabilirsiniz; böylece fiyatlandırma sayfanızdaki ziyaretçiler satış kampanyanızla konuşurken, yardım sayfanızdaki ziyaretçiler destek temsilcinizle konuşur — hepsi tek bir sohbet widget’ından.

Kodu almanın iki yolu vardır:

• Kampanyadan veya temsilciden. Kampanyalar sayfasında, bir kampanyanın yanındaki ⋮ menüsünü açın ve Web sitesine ekle seçeneğini belirleyin. Temsilciler sayfasında, satırdaki </> düğmesine tıklayın veya temsilciyi açıp Giriş noktaları sekmesine gidin. Her iki durumda da, doğrudan o kampanyaya veya 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.

  Web sitesine ekle, yalnızca yayında olan ve gelen sohbetleri karşılayacak şekilde ayarlanmış kampanyalarda görünür. Taslak halindeki bir kampanya henüz ziyaretçi kabul edemediğinden, siz onu yayınlayana kadar bu seçenek gizli kalır. Temsilciler sayfasında ise aktif temsilcilerde görünür. Duraklatılmış bir temsilci sohbeti alabilir ancak asla yanıt veremez, bu nedenle siz onu tekrar açana kadar seçenek gizli kalır. Bir temsilci için ayarlanacak bir kanal yoktur; bir temsilci herhangi bir kanaldan gelen sohbeti alabilir.

• 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?campaign=CAMPAIGN_ID"></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-campaign="CAMPAIGN_ID" style="width:100%;height:600px;"></div>
<script src="https://api.youraiconnector.com/v1/chat-widget/embed.js" async></script>

Bir temsilci için ifade ?agent=AGENT_ID veya data-agent="AGENT_ID" olarak değişir.

Bilinmesi gereken birkaç nokta:

• Kimliği elle yazmak yerine kopyala düğmesini kullanın. Kimlik, hesabınızdaki bir kampanya veya temsilciyle eşleşmezse sohbet yine de çalışır ancak varsayılan yönlendirmenize geri döner.
• Hali hazırda görüşme yapmakta olan biri, daha sonra başka bir yere yönlendiren bir sayfaya gelse bile başladığı kişiyle görüşmeye devam eder. Bu, bir görüşmenin ortasında kişiliğinin değişmesini engeller.
• 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"></script>

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

İ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:

• İki farklı kişi aynı bilgisayarda oturum açarsa, ikincisi ilkinin sohbetini görmek yerine yeni bir sohbet başlatır. Widget kişi değişikliğini fark eder ve kendini sıfırlar.
• Bu, birinin oturumunu açmak için değil, bağlam sağlamak içindir. Sohbetler her zaman olduğu gibi ayrı tutulur, bu nedenle bir id geçmek kimsenin başkasının sohbetini açmasına izin vermez ve farklı bir cihaz veya tarayıcı kullanan biri orada yeni bir sohbet başlatır.
• Bu isteğe bağlıdır. Normal bir herkese açık sayfadaki widget bunların hiçbirine ihtiyaç duymaz ve her zamanki gibi davranır.

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. Komut dosyası etiketinin kapanış </body> etiketinden önce yerleştirildiğinden emin olun.
3. Kodda yazım hatası olup olmadığını kontrol edin.

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.