Widget'ı kurun

RolChat widget’ı, açtığınız modüllere uyum sağlayan tek bir yüzen düğmedir: sohbet, geri arama talep formu, toplantı rezervasyonu, potansiyel müşteri formu ve bilgi bankası araması hepsi onun içindedir. Bir kez kurarsınız; neyi göstereceğine panelden karar verilir.

1. Kodu kopyalayın

Ayarlar → Widget bölümünde siteyi seçin ve kurulum kodunu kopyalayın. Şuna benzer:

<!-- RolChat widget -->
<script>
  window.rolchatConfig = {
    "site_id": "ste_…",
    "account_id": "…",
    "widget_key": "wk1.<site>.<signature>",
    "modules": ["chat"]
  };
</script>
<script async src="https://widget.rolchat.com/stub.js"></script>

Widget anahtarı herkese açıktır ve bir sayfada yayınlanması güvenlidir. Sitenizi tanımlar ve imzalıdır, bu nedenle kimse widget’ın bir kopyasını hesabınıza yönlendiremez. Widget ayarlarını değiştirdikçe panel nesneye başka anahtarlar da ekler (karşılama mesajı, başlık, tema, çalışma saatleri, ekran boyutuna göre düzen); değişikliklerden sonra kodu yeniden kopyalayın ya da nesneyi minimal bırakıp gerisini widget’ın kendisinin çekmesine izin verin.

stub.js birkaç kilobayttır ve geri kalanını yalnızca ziyaretçi ihtiyaç duyduğunda yükler: ilk açılışta sohbet arayüzünü, onaydan sonra izlemeyi, gerektiği yerde onay banner’ını.

2. </body> etiketinden önce yapıştırın

Kodu widget’ı istediğiniz her sayfaya ekleyin; ideal olarak site şablonunuz veya etiket yöneticiniz üzerinden, böylece her yerde aynı anda görünür. Script eşzamansız yüklenir ve oluşturmayı engellemez; ilk yükleme paketi Core Web Vitals değerlerinizi etkilemeyecek şekilde bilerek küçük tutulur.

3. Çalıştığını kontrol edin

Sitenizi gizli bir pencerede açın. Düğme seçtiğiniz köşede görünür. Panelde Ziyaretçiler yeni anonim oturumu gerçek zamanlı gösterir ve widget’tan gönderilen bir mesaj Gelen kutusunda yeni bir konuşma olarak görünür.

Oturum açmış kullanıcıları tanımlayın

Ziyaretçileriniz ürününüzde oturum açıyorsa, konuşmaların doğru kişiye bağlanması için RolChat’e kim olduklarını bildirin:

window.rolchat.identify({
  email: "alice@example.com",
  first_name: "Alice",
  last_name: "Martin",
  phone: "+15551234567",
  external_id: "user_12345",
  custom_fields: { plan: "pro" },
});

Kabul edilen özellikler email, phone, first_name, last_name, external_id ve düz bir custom_fields nesnesidir; diğer her şey yok sayılır. RolChat e-postayı CRM’de arar. Kişi varsa oturum ona bağlanır ve temsilci profili görür; yoksa bilgiler saklanır ve ziyaretçi ilk kez yazdığında bir potansiyel müşteri oluşturulur.

Daha yüksek güven için arka ucunuz kimliği imzalayabilir: RolChat’in kullanıcı için verdiği imzayı özelliklerle birlikte iletin; oturum yalnızca imza doğrulanırsa yükseltilir. Kullanıcı oturumu kapattığında window.rolchat.reset() çağırın; aksi halde o tarayıcıdaki bir sonraki kişi önceki konuşmayı görür.

JavaScript API

window.rolchat, stub çalışır çalışmaz kullanılabilir; paket yüklenmeden önce yapılan çağrılar kuyruğa alınır ve sırayla yürütülür.

Yöntem	Ne yapar
show() / hide()	Başlatıcıyı gösterir veya gizler
open() / close()	Sohbet panelini açar veya kapatır
identify(traits)	Oturumu bir kişiye bağlar (yukarıda)
reset()	Kimliği unutur ve yeni bir anonim oturum başlatır
pushEvent(name, props)	Tetikleyici mesajlar ve otomasyon için özel bir olay bildirir
trackPageView(path?)	Tek sayfalık uygulamalarda sayfa görüntülemesi bildirir
setLocale(code)	Widget dilini değiştirir
showConsentPreferences()	Onay tercih merkezini açar
on(event, handler) / off(event, handler)	chat:opened, chat:closed, message:sent, message:received, session:started olaylarına abone olur

window.rolchat.pushEvent("cart_abandoned", { value: 129.9, currency: "EUR" });
window.rolchat.on("message:received", () => audio.play());

Dil ve yön

Widget, window.rolchatConfig içinde lang ile sabitlediğiniz dili konuşur (örneğin "lang": "de"); o yoksa RolChat’in desteklediği 40 dil arasından ziyaretçinin tarayıcı dilini, tarayıcı tercihlerinin sırasına göre; hiçbiri uymazsa İngilizceyi kullanır. Sitenin kendi dil ayarı kullanılmaz: widget’ın sitenizin dilini konuşması için lang ayarlayın. Arapça ve İbranice sağdan sola görüntülenir. Temsilci mesajları widget tarafından çevrilmez; bunun yerine temsilci tarafında yapay zeka ile canlı çeviri kullanılabilir.

Çerezler ve onay

Onay banner’ının gerektiği yerlerde widget, ziyaretçileri onaydan önce izlemez. RolChat Gizlilik modülünü kullanıyorsanız banner ve widget tek bir onay durumunu paylaşır. Başka bir onay aracı kullanıyorsanız widget’ın analiz olayları Ayarlar → Gizlilik → Yerleştirme bölümünde yapılandırdığınız sinyali bekler.

Widget nerede yapılandırılır

Ne	Nerede
Renkler, konum, karşılama mesajı, giriş noktaları, kurulum kodu	Ayarlar → Widget
Widget içinde hangi modüllerin görüneceği	Ayarlar → Modüller (site başına)
Çalışma saatleri ve çevrimdışı mesajı	Ayarlar → Siteler → Çalışma saatleri
Belirli sayfalarda gösterilen tetikleyici mesajlar	Pazarlama → Tetikleyiciler