WebBlocks Live Chat

Ziyaretçilerle CMS operatörleri arasında kendi sunucunuzda destek görüşmeleri yürütün. Ziyaretçiler sitenizde bir sohbet bileşeni açar; operatörler CMS panelindeki Live Chat bölümünden mesajları okur ve yanıtlar. Harici sohbet hesabı veya WebSocket hizmeti gerekmez. Bu rehber Live Chat 0.7.1 sürümünü belgeler.

Gereksinimler ve kurulum

PHP 8.4 veya üzerini ve gerekli WebBlocks UI çalışma zamanını sağlayan WebBlocks CMS ^1.95.1 sürümünü kullanın. Uyumlu ZIP paketini Live Chat katalog sayfasından indirin. Sistem → Eklentiler bölümünden yükleyip etkinleştirin ve veritabanı kurulumunun başarıyla tamamlandığını kontrol edin. Eski bir sunucu uygulaması eklenti sağlık uyarısı verebilir; bu sürümü kullanmadan önce uygulamayı yükseltin.

Sitenin sohbet bileşenini yapılandırma

Live Chat → Ayarlar bölümünü açıp siteyi seçin. Genel ayarlar; bileşenin etkinliğini, çevrimiçi/çevrimdışı durumunu, sağ/sol konumunu, çevrimdışıyken e-posta zorunluluğunu ve isteğe bağlı operatör e-postalarını denetler. Uygunluk elle belirlenir; operatörün hazır olup olmadığını algılamaz.

Dil metinlerinin ayrı formu vardır. Her etkin site dili için başlığı, karşılama mesajını, çevrimdışı mesajını ve açma düğmesinin etiketini belirleyin. Genel ayarları kaydetmek dil metinlerini, dil metinlerini kaydetmek genel ayarları korur. Eksik metin için önce varsayılan dil, ardından mevcut eski metin kullanılır.

Etkin bileşen yalnızca ziyaretçi açma düğmesine tıkladığında açılır. Ziyaretçi adını ve isteğe bağlı e-posta adresini verir; yeni çevrimdışı görüşmelerde e-postayı zorunlu tutabilirsiniz. Bileşeni kapatmak gönderilmemiş taslağı korur. Görüşme kapandıktan sonra Yeni görüşme başlat ziyaretçiyi giriş formuna döndürür. Mesajlar ve operatör yanıtları düzenli sorgulamayla bileşene gelir.

Görüşmelerle çalışma

Operatörlerin görüşmeleri okumak için Canlı sohbeti görüntüleme, yanıtlamak veya kapatmak için Canlı sohbeti yanıtlama, bileşeni yapılandırmak için Canlı sohbeti yönetme izni gerekir. Seçilen site, görüşme listesini ve kullanılabilir işlemleri sınırlar.

İşleri bulmak için açık, yanıt bekleyen, okunmamış ve kapalı görünümlerini kullanın. Arama; ziyaretçi adları, e-posta adresleri ve mesaj geçmişiyle eşleşir. Varsayılan açık görünümde yanıt bekleyen görüşmeler önce gelir; en yeniden veya en eskiden sıralama da bulunur. Okunmamış ve yanıt bekleyen farklı durumlardır: mesajı okumak onu yanıtlamaz.

Gelen kutusu ve görüşme, görünürken her beş saniyede yenilenir. Görünür görüşmenin en altında okumak ziyaretçi mesajlarını okundu işaretler. Eski mesajlara giderseniz yenileri konumunuzu değiştirmez; son mesajlara dönmek için Yeni mesajlar düğmesini kullanın. Yanıt gönderin, tamamlanan görüşmeyi kapatın veya daha fazla yardım gerektiğinde yeniden açın. Yeniden açmak ziyaretçinin yanıt vermesini geri getirir.

Yetkili operatörler yeni ziyaretçi mesajları için okunmamış yan menü rozetleri ve panel içi bildirimler de alır. Bunlar görüşmeleri okundu işaretlemez ve işletim sistemi bildirimi göndermez.

İsteğe bağlı e-posta bildirimleri

Çevrimdışı operatör bildirimleri isteğe bağlıdır. Alıcıyı yapılandırın ve yalnızca gerektiğinde açın. Ziyaretçiye yanıt e-postaları kapalıdır; operatör yanıtları sohbet bileşeninden teslim edilir.

E-posta içeriği ve sıklığı CMS sitesinin bildirim politikasından alınır. Politikaya göre bildirimler hemen, toplu veya günlük özet içinde gönderilebilir. Yalnızca uyarı içeren mesajlarda ziyaretçi adları, adresleri, mesaj gövdeleri ve özel görüşme tokenları bulunmaz. Günlük özetler daima asgari içeriklidir.

Toplu/günlük teslim ve günlük hatırlatmalar için sunucunun Laravel zamanlayıcısı her dakika çalışmalıdır. E-posta beklemede kalıyorsa kayıtlı zamanlayıcı sağlığını kontrol edin. Günlük hatırlatma olmadan yalnızca anında bildirimler zamanlanmış gönderim gerektirmez. Gönderim CMS e-posta ayarlarını kullanır; taşıma katmanına başarılı teslim, alıcının gelen kutusuna ulaşıldığını kanıtlamaz.

Ayarlar API'si

Etkin eklenti, yollarını CMS API keşfi ve OpenAPI üzerinden bildirir. live-chat.read ile GET /webadmin/api/plugins/webblocks-live-chat/settings?site_id=1 kullanın. Aynı yoldaki PATCH veya PUT, live-chat.settings.write ve açık bir site_id gerektirir.

Yazma işlemleri yalnızca gönderilen alanları günceller ve gönderilen dil değerlerini mevcut metinlerle birleştirir. Yalnızca etkin site dilleri kabul edilir. Tokenın site kısıtları ve güncel devredilmiş erişim geçerliliğini korur. Desteklenen token yetkisi politikasını kurulu CMS'den öğrenin; eklentiyi etkinleştirmenin erişim verdiğini varsaymayın.

Açma düğmesi görünmüyorsa eklenti etkinliğini, site seçimini, bileşenin etkinliğini ve sunucu uygulamasının uyumluluğunu kontrol edin. Çevrimdışı ayarı giriş metnini değiştirir; bileşenin etkinliği ayrı bir denetimdir. Yanıtlar durduysa görüşmenin kapatılıp kapatılmadığını kontrol edin. E-posta beklemedeyse alıcıyı, CMS e-posta ayarlarını, devralınan politikayı ve zamanlayıcı sağlığını inceleyin.

Eklentilere genel bakışa dönün, katalog sürümünü inceleyin veya Internal Content API başvurusunu kullanın.