Widget’ı yerleştirme

Kısa anlatım

Bu satırı sayfanızın head bölümüne ekleyin ve SITE_KEY yerine kendi anahtarınızı yazın:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="en"
        async></script>

Hepsi bu. Yükleyicinin boyutu 3,48 kB’tır; çekirdeği yalnızca tarayıcının zamanı olduğunda veya ziyaretçi sohbet düğmesine dokunduğunda alır.

loader.js dosyasını kendiniz sunuyorsanız bir satır daha gerekir

Bazı kişiler betiği dağıtım ağımız yerine kendi dizinlerinden yüklemeyi tercih eder; bir politika, test ortamı veya yalnızca alışkanlık nedeniyle. Bu mümkündür; ancak sohbet bağlantısını açıkça belirtmeniz gerekir:

<script src="/js/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-ws-url="wss://ws.reactive.chat/rc_wss/"
        async></script>

Nedeni: Bu ayar olmadan widget adresi, betiğin geldiği konumdan türetir. Betik sizin alan adınızdan geldiyse sohbeti de orada arar ve bulamaz.

Üstelik hata kolayca gizlenir. Sohbet düğmesi görünür, pencere açılır, renk ve dil doğrudur; her şey tamamlanmış görünür. Ancak hiçbir mesaj ulaşmaz. Hata mesajı yoktur: bağlantı arka planda sürekli yeniden denenir ve bu da sorunu gizler. Boşuna aranan ana makine adını yalnızca tarayıcı konsolu gösterir.

Yukarıdaki değer bizdeki her hesap için aynıdır. Yalnızca sunucuyu kendiniz çalıştırıyorsanız kendi değerinizi girersiniz.

Kendi web sitenizin alt alan adı üzerinden

Sohbet kendi alt alan adınız üzerinden birinci taraf olarak çalışacaksa (örneğin cdn.reactive.chat yerine chat.your-company.com), proxy kurulumu özel alan adı kılavuzunda açıklanır. Hesabınız bunun için uygun kodu gösterir.

WebSocket bağlantıları engellendiğinde

Bir ağ WebSocket bağlantısına izin vermiyorsa, örneğin şirket proxy’si arkasında, sohbet otomatik olarak normal HTTPS üzerinden devam eder. Bunun için Content Security Policy içinde wss:// adresine ek olarak aşağıdaki https:// adresi gerekir. Yedeğin ne zaman devreye girdiği ve test için nasıl zorlanacağı HTTP yedeği bölümünde açıklanır.

Sohbeti kendi bağlantılarınızdan açın, tanıtım kartı gösterin

Sayfanızdaki herhangi bir bağlantı veya düğme sohbeti açabilir; pencere hemen yanında görünür: Sohbeti kendi bağlantınızdan veya düğmenizden açma. Sohbette ücretli planınız gibi kendi teklifiniz için kart göstermeyi Sohbette tanıtım kartı bölümü açıklar.

Gizlilik metnini otomatik yerleştirme

Gizlilik politikası sayfanızdaki küçük bir öğe, sohbetle ilgili uygun metni gösterir; her zaman proje ayarlarınızla uyumlu ve sayfanın dilindedir: Gizlilik metnini otomatik yerleştirme.

Neden satır içi betik yok?

Rakiplerimizin yaygın olarak sunduğu biçim, satır içi <script> etiketidir. unsafe-inline içermeyen sıkı Content Security Policy altında tek bir satırı çalışmadan önce engellenir. Yukarıdaki öznitelik biçimi böyle bir betik gerektirmez.

Politikanızın ayrıca izin vermesi gerekenler:

• script-src için dağıtım ana makinesi; burada cdn.reactive.chat
• connect-src için WebSocket adresi; burada wss://ws.reactive.chat
• connect-src için aynı adresin https:// biçimi de; burada https://ws.reactive.chat – şirket proxy’si WebSocket bağlantılarını engellediğinde çevrimdışı form ve HTTP yedeği bunu kullanır

Script etiketindeki ayarlar

1. data-rc-site-key — zorunlu. Olmadan hiçbir şey başlamaz; bu bilinçli bir tercihtir.
2. data-rc-locale — de, en veya pl. Yoksa tarayıcı karar verir.
3. data-rc-brand — marka renginiz. Metin okunabilir olana kadar yeniden hesaplanır.
4. data-rc-ws-url — loader.js dosyasını cdn.reactive.chat üzerinden yüklemediğinizde zorunludur. Yukarıdaki bölüme bakın.

Diğer her şey özelliklere genel bakış ve fiyatlandırma sayfasında bulunur.

Dokümantasyonda ayrıntılar

Adım adım: Hızlı başlangıç. Her script etiketi özniteliği, türü ve varsayılanı: Script etiketi başvurusu. Tüm bölümler dokümantasyondadır.