Metinler ve diller

Bileşen Almanca, İngilizce ve Lehçe konuşur. Yaklaşık 200 metninin her biri değiştirilebilir: hesabınızda tüm sayfalar için veya kodda tek tek sayfalar için.

Bileşen dili nasıl seçer?

Bileşen sayfanızın içinde yer alır. Bu nedenle ziyaretçinin o anda okuduğu içerik, tarayıcı ayarından daha önemlidir. Sıralama:

1. Sayfanızın bu ziyaretçi için ReactiveChat('setLocale', …) aracılığıyla seçtiği dil (aşağıya bakın).
2. Kod parçacığında (data-rc-locale) veya yapılandırmada sabitlenmiş dil.
3. Aksi hâlde <html lang="…"> üzerinden sayfanızın dili.
4. Aksi hâlde hesabınızdaki varsayılan dil.
5. Aksi hâlde tarayıcının dili ve son olarak İngilizce.

Bölgesel kodlar kısaltılır: de-AT, de olur. Bileşenin tanımadığı bir dil yerine İngilizce kullanılır.

Bu yüzden en önemli şey, sayfalarınızda doğru bir <html lang> değeridir. Böylece bileşen web sitenizin her dil sürümünü kendiliğinden izler.

Hesabınızdaki varsayılan dil

/app/projects/{id} altında Kurulum sekmesinin Temel bilgiler bölümünde Varsayılan dil seçilir: de, en veya pl. Bu ayarın iki işlevi vardır:

• Kod parçacığı bir dil belirlemiyorsa <html lang> olmayan sayfalardaki ziyaretçiler için geçerlidir.
• Kendi ifadelerinizi, ana ekranı ve tanıtım kartını bu dilde yazarsınız (aşağıya bakın).

Dili kodda belirleme

Bir sayfa için kod parçacığında sabitleme:

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

Çalışma sırasında, örneğin kendi dil değiştiricinizden:

ReactiveChat('setLocale', 'en');

setLocale, bileşenin metinlerini hemen değiştirir. Bileşen bu seçimi ziyaretçinin tarayıcısında bir yıl hatırlar; seçim daha sonra diğer sayfalarda da data-rc-locale değerinden öncelikli olur. Bileşenin kendisinde dil seçici yoktur. Ziyaretçilerinizin seçim yapmasını istiyorsanız kendi dil değiştiricinizden setLocale çağırın.

Hesabınızda kendi ifadeleriniz

Metinler ve formlar sekmesinin Kendi ifadeleriniz bölümünde bileşenin her metni anahtarıyla birlikte, alanlara göre gruplandırılmış ve daraltılmış olarak listelenir. Bizim metnimiz alanda gri görünür. Girdiğiniz metin onun yerini alır. Başlıkta kaç metni özelleştirdiğiniz gösterilir.

• Metin başına en fazla 400 karakter.
• Boş bırakmak bizim metnimizin kullanılacağı anlamına gelir.
• Bizimkiyle tamamen aynı olan metin kaydedilmez.
• Bileşen, {n}, {name} veya {time} gibi süslü parantezli yer tutucuları doldurur. Değerin görünmesini istiyorsanız bunları metninizde koruyun.

Dil hakkında önemli bilgi: metinleri projenin varsayılan dilinde yazarsınız ve yalnızca o dilde etkili olurlar. Bileşeni farklı bir dilde çalışan ziyaretçiler, o dilde bizim sağladığımız metinleri görmeye devam eder. Diğer dillerde kendi metinleriniz için kod kullanın (aşağıda); tercihen ilgili dil sürümünün sayfalarında.

Değişiklikler bir dakika içinde ziyaretçilerinize ulaşır.

En önemli anahtarlar

Alanlara göre bir seçki:

• launcher.text, launcher.subtext – sohbet düğmesinin yazısı ve ikinci satırı. Başlangıçta boştur; bir değer girildiğinde Görünüm → Marka altındaki alanlardan öncelikli olur.
• launcher.label – ekran okuyucuların okuduğu sohbet düğmesi etiketi (“Sohbeti aç”).
• header.title, header.subtitle_online, header.subtitle_bot, header.response_time – üstbilgideki başlık ve ikinci satırlar.
• home.greeting, home.sub, home.start, home.start_sub – ana ekrandaki karşılama ve başlangıç noktası (karşılama Ana ekran altında daha kolay ayarlanır).
• tabs.home, tabs.messages, tabs.help – sekmeler.
• input.placeholder ve diğer input.* – giriş alanı.
• offline.* – “Mesaj bırakın” formu.
• prechat.* – sohbet öncesi formu.
• bh.* – hizmet saatleriyle ilgili bildirimler.
• ds.* ve daten.* – onay ve “Verileriniz” veri kartı.
• msg.ki_notice – yapay zekâ asistanının ilk yanıtından önceki bildirim.
• csat.* – sohbet sonrasındaki değerlendirme.
• transcript.*, upload.*, handoff.*, queue.*, teaser.*, err.* – e-postayla sohbet dökümü, ekler, ekibe aktarma, kuyruk, ipucu balonu ve hata mesajları.

Listenin tamamını hesabınızda görebilirsiniz.

“Powered by reactive.chat” ibaresi (bkz. Sohbet penceresi) ve ürün turlarının metinleri (bkz. Ürün turları) metinler üzerinden değiştirilemez.

Metinleri kodda değiştirme

Kod parçacığında data-rc-strings ile JSON olarak, noktalı gösterimdeki anahtarlarla:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="en"
        data-rc-strings='{"input.placeholder":"Your question about your order …","header.title":"Customer service"}'
        async></script>

Veya yapılandırmada:

ReactiveChat('boot', {
  strings: { 'input.placeholder': 'Your question about your order …' }
});

Aynı sayfada ikinci bir boot çağrısı yeni strings değerlerini yükler. Böylece örneğin oturum açıldıktan sonra metinleri değiştirebilirsiniz.

Kodda belirlenen metinler her dilde aynı şekilde geçerlidir. Bu nedenle bunları dili sabit olan sayfalarda belirleyin ve orada dili de ayarlayın.

En güçlüden en zayıfa öncelik sırası:

1. Koddaki metinler (strings) – yalnızca bulundukları sayfa için geçerlidir.
2. Hesabınızdaki kendi ifadeleriniz, varsayılan dilde.
3. Ziyaretçinin dilinde bizim sağladığımız metinler.
4. İngilizce.

Kodun öncelikli olması bilinçli bir tercihtir: tek bir sayfada farklı bir metin istiyorsanız diğer tüm sayfaların ayarını değiştirmeden bunu o sayfada yaparsınız.

Başka yerlerdeki diğer metinler

Bazı metinlerin, çoğu zaman dile göre ayrı olan kendi alanları vardır:

• Karşılama, kutucuklar ve ana ekran: Sohbetin ana ekranı
• Sohbet öncesi formunun üstündeki cümle (dile göre): Müsaitlik, formlar ve hizmet
• Onay cümlesi ve gizlilik politikası bağlantısı (dile göre): Gizlilik ve onay
• İpuçları ve proaktif mesajların metinleri: Proaktif mesajlar
• Yapay zekâ asistanının adı ve üslubu: Yapay zekâ asistanı
• Tanıtım kartı, kodda dile göre de ayarlanabilir: Sohbette tanıtım kartı