Script etiketi başvurusu: tüm öznitelikler ve yapılandırma kaynakları

Widget tamamen script etiketindeki özniteliklerle ayarlanabilir; satır içi betik gerekmez, dolayısıyla sıkı Content Security Policy altında da çalışır. JavaScript yazmayı tercih ediyorsanız aynı alanları window.ReactiveChatSettings veya ReactiveChat('boot', …) ile ayarlayın.

Tasarım, metinler, ana ekran, kurallar ve turlar normalde hesabınızda ayarlanır; bağlantı kurulduğunda sunucudan gelirler. Buradaki öznitelikler sayfa başına geçerli olacak ayarlar içindir. Tüm tasarım seçenekleri Özelleştirme altında açıklanır.

Dört yapılandırma kaynağı ve öncelikleri

Sonraki kaynak önceliklidir; birleştirme yüzeyseldir (brand gibi nesne alanı bir bütün olarak değiştirilir; derinlemesine birleştirilmez):

1. Widget varsayılanları
2. Yükleyici etiketindeki data-rc-* öznitelikleri
3. window.ReactiveChatSettings (yükleyiciden önce ayarlanmış)
4. Kuyruktaki ReactiveChat('boot', {...}) çağrıları, sıralarıyla

Widget’ın bilmediği alanlar atılır; dolayısıyla hatalı yazılmış öznitelik sessizce etkisiz kalır.

<script>
  window.ReactiveChatSettings = { locale: 'en', position: 'left' };
</script>
<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        async></script>

Öznitelik değerleri nasıl okunur?

Ad, kebab case biçiminden camel case biçimine çevrilir: data-rc-site-key → siteKey. Tür varsayılandan belirlenir:

• Dize – değiştirilmeden alınır.
• Mantıksal değer – yalnızca "false" ve "0" false olur; boş öznitelik dâhil diğer her şey true olur.
• Liste – virgülle ayrılmış; örneğin "idle,pointer".
• Sayı veya nesne – JSON olarak okunur. JSON geçersizse varsayılan kalır.

Yalnızca o anda çalıştırılan etiket okunur (document.currentScript). Bu nedenle yükleyiciyi type="module" ile değil, klasik betik olarak yerleştirin.

Zorunlu

• data-rc-site-key (dize, zorunlu) – projenizin anahtarı; hesabınızda Proje → Kurulum altında bulunur. Desen: [A-Za-z0-9_-]{8,64}. Eksik veya geçersizse hiçbir şey başlamaz; konsolda mesaj da görünmez.

Bağlantı ve dağıtım

• data-rc-ws-url (dize, isteğe bağlı) – sohbet bağlantısının adresi. Verilmezse loader.js konumundan türetilir (cdn.reactive.chat → wss://ws.reactive.chat/rc_wss/). loader.js dosyasını cdn.reactive.chat üzerinden yüklemediğinizde ve .co.uk gibi iki parçalı uzantıya sahip alan adlarında zorunludur. Taşıma bölümüne bakın.
• data-rc-cdn-base (dize, isteğe bağlı) – çekirdek ve modüllerin yüklendiği dizin. Varsayılan: loader.js dizini.
• data-rc-core-url (dize, isteğe bağlı) – aynı dizindeki core.<hash>.js yerine çekirdeğin sabit adresi. Yalnızca kendi aynanız gibi özel durumlar için.
• data-rc-transport (http, isteğe bağlı) – HTTP yedeğini baştan zorlar. Başlangıçta belgede bulunan herhangi bir öğede çalışır; alternatif olarak ReactiveChatSettings.transport = 'http'. boot üzerinden etkisi yoktur.
• data-rc-max-retries (sayı, varsayılan 2) – çekirdek yüklenmezse yeniden denemeler (aralık 300 ms × deneme).

Dil, tema, hareket

• data-rc-locale (dize, varsayılan auto) – de, en veya pl. auto önce <html lang>, ardından tarayıcı dilini alır; aksi durumda İngilizce. Diğer diller İngilizceye döner.
• data-rc-theme (auto | light | dark, varsayılan auto) – auto, sayfanızın açık/koyu modunu, yoksa sistemi izler.
• data-rc-motion (auto | reduced | full, varsayılan auto) – animasyonlar; auto, prefers-reduced-motion ayarını izler.
• data-rc-strings (JSON nesnesi, varsayılan {}) – tek tek metinleri geçersiz kılma; örneğin {"a11y.launcher":"Open help"}. Diğer durumlarda metinleri hesabınızda yönetirsiniz (Özelleştirme).

Gösterim ve konum

• data-rc-position (right | left, varsayılan right) – sohbet düğmesinin ve pencerenin köşesi.
• data-rc-offset (JSON, varsayılan {"x":20,"y":20}) – güvenli alana ek olarak kenardan piksel cinsinden uzaklık.
• data-rc-z-index (sayı, varsayılan 2147483000).
• data-rc-avoid-overlap (mantıksal değer, varsayılan true) – alt kenardaki sabit çubuklardan kaçınır (çerez bildirimleri, sepet çubukları).
• data-rc-hide-launcher (mantıksal değer, varsayılan false) – sohbet simgesi yok; pencere yalnızca kendi bağlantılarınız veya JavaScript API’si üzerinden açılır. Bu durumda ipucu balonları bastırılır. Hesap ayarından bağımsız geçerlidir.
• data-rc-auto-open (mantıksal değer, varsayılan false) – başlangıçtan sonra pencereyi açar.
• data-rc-isolation (shadow | iframe, varsayılan shadow) – widget kapalı shadow DOM içinde yer alır; iframe, çok baskın genel stilleri olan sayfalar için pencereyi çerçeve içinde oluşturur.
• data-rc-brand (JSON nesnesi) – marka rengi ve sohbet düğmesinin şekli. Yükleyici buradan primary (#rrggbb), onPrimary, radius ve launcher.shape (circle, rounded, square, bubble, leaf), launcher.size (44–72) ve launcher.size_m alanlarını hemen okur; kalanını çekirdek kontrol eder. Hesabınızdaki kod bu değerleri zaten içerir; geçerli primary olmadan yükleyici geçici düğme göstermez, renk sunucudan gelene kadar bekler (renk sıçraması yoktur, ancak düğme daha geç gelir). Nesne yalnızca bu başlangıç alanlarını içeriyorsa bağlantı kurulunca hesabınızdaki marka geçerlidir; ek alanlarla (örneğin accent) sizinki geçerlidir. Ayrıntılar Özelleştirme altında.
• data-rc-logo (JSON nesnesi) – src, placement (launcher, header, both), height, alt.
• data-rc-custom-css (dize) – shadow DOM içindeki kendi CSS kodunuz. Özelleştirme bölümüne bakın.

Yükleme ve davranış

• data-rc-load-triggers (liste, varsayılan beşinin tümü) – çekirdeğin ne zaman yükleneceği: idle (tarayıcı boşta), pointer (sohbet düğmesinde fare veya parmak), command (boot, update, track, identify dışındaki API komutu), frustration (MousePlayer sinyali), push. İlk tetikleyici uygulanır.
• data-rc-idle-timeout-ms (sayı, varsayılan 3000) – idle tetikleyicisi için zaman aşımı.
• data-rc-consent (auto | granted | denied, varsayılan auto) – onay durumu. auto onay platformunuza sorar (__tcfapi üzerinden IAB TCF v2; yoksa consented.eu); granted/denied sabitler. Gizlilik entegrasyonu bölümüne bakın.
• data-rc-dom-spiegel (mantıksal değer, varsayılan true) – false, asistana sayfa metni göndermez ve “Bana göster” özelliğini kapatır.
• data-rc-promo (mantıksal değer, varsayılan true) – false, bu sayfada tanıtım kartını gizler.
• data-rc-launcher-selector (CSS seçicisi) – eşleşen öğelere tıklamak pencereyi açıp kapatır. Yalnızca çekirdek yüklendikten sonra çalışır; hemen çalışması gereken bağlantılar için data-rc-open kullanın (aşağıda).
• data-rc-dnd (mantıksal değer, varsayılan false) – “Rahatsız etmeyin” başlangıç değeri.
• data-rc-session-ttl-ms (sayı, varsayılan 1800000) – MousePlayer oturumunun ne kadar süre devralınacağı.
• data-rc-debug (mantıksal değer, varsayılan false) – konsolda tanılama çıktısı. Eşdeğeri: tarayıcıda localStorage.setItem('rc_debug', '1').

Sayfanızdaki diğer öğelerin öznitelikleri

Sohbeti açma (çekirdek yüklenmeden önce bile hemen çalışır):

• data-rc-open – herhangi bir öğede; tıklama sohbeti öğenin yanında açar. data-rc-open="corner" köşede açar.
• href="#rc-open" veya href="#reactive-chat" – bağlantılar için aynı şey.
• data-rc-anchor="none" – corner gibi.
• data-rc-message – giriş alanına yazılan ancak gönderilmeyen metin (en fazla 200 karakter).
• data-rc-tab – msg, home veya help: önde olan sekme.

Ayrıntılar: Sohbeti kendi bağlantınızdan veya düğmenizden açma.

Gizlilik metni:

• data-rc-privacy – gizlilik politikanızdaki reactive.chat bölümü için yer tutucu; data-lang, data-heading (2–6) ve data-email ile. Durum data-rc-privacy-state içinde (loading, done, error). Gizlilik entegrasyonu bölümüne bakın.

Sayfa metnini hariç tutma:

• data-rc-private veya eşdeğeri data-rc-ignore – bu alt ağaç asistana sayfa metni olarak asla gönderilmez ve “Bana göster” tarafından asla hedeflenmez.

<aside data-rc-private>
  Internal notes the assistant should not read.
</aside>

URL parametreleri

• ?rc_ab=A ile E – kalite kontrolleri için çalışan A/B testinin varyantını zorlar (Özelleştirme bölümüne bakın).

Widget yüklenirken adresteki diğer parametreleri değerlendirmez.

Birden fazla kez yerleştirme

Yükleyici sayfada iki kez varsa (örneğin şablon ve etiket yöneticisi üzerinden) yalnızca geçerli site anahtarlı ilki başlar; ikincisi hiçbir şey yapmaz. Anahtarı geçersiz ilk etiket, doğru ikinci etiketi engellemez.

Sonraki: JavaScript API’si · Olaylar