Teksty i języki

Widget mówi po niemiecku, angielsku i polsku. Każdy z jego około 200 tekstów można zastąpić: w koncie dla wszystkich stron albo w kodzie dla pojedynczych stron.

Jak widget wybiera język

Widget działa wewnątrz twojej strony. Dlatego to, co odwiedzający właśnie czyta, liczy się bardziej niż ustawienie jego przeglądarki. Kolejność:

1. Język, który twoja strona wybrała dla tego odwiedzającego przez ReactiveChat('setLocale', …) (zob. niżej).
2. Stały język we fragmencie osadzenia (data-rc-locale) albo w konfiguracji.
3. W przeciwnym razie język twojej strony z <html lang="…">.
4. W przeciwnym razie język domyślny z konta.
5. W przeciwnym razie język przeglądarki, a na końcu angielski.

Oznaczenia regionalne są skracane: de-AT staje się de. Język, którego widget nie zna, zamienia się na angielski.

Najważniejsze jest więc poprawne <html lang> na twoich stronach. Wtedy widget sam podąża za każdą wersją językową twojej strony.

Język domyślny w koncie

Pod /app/projects/{id} w zakładce Instalacja, sekcja Podstawy, wybierasz Język domyślny: de, en albo pl. Pełni on dwie funkcje:

• Obowiązuje dla odwiedzających na stronach bez <html lang>, jeśli fragment osadzenia nie ustala języka.
• W nim piszesz swoje własne teksty, stronę startową i kartę promocyjną (zob. niżej).

Ustalanie języka w kodzie

Na stałe dla strony, we fragmencie osadzenia:

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

W trakcie działania strony, np. z twojego własnego przełącznika języka:

ReactiveChat('setLocale', 'en');

setLocale od razu zmienia napisy w widgecie. Widget zapamiętuje ten wybór na rok w przeglądarce odwiedzającego i wtedy także na innych stronach ma on pierwszeństwo przed data-rc-locale. W samym widgecie nie ma wyboru języka. Jeśli twoi odwiedzający mają wybierać, wywołaj setLocale z twojego przełącznika.

Własne teksty w koncie

W zakładce Teksty i formularze, sekcja Własne teksty, jest każdy tekst widgetu wraz z kluczem, pogrupowany według obszaru i zwinięty. W polu szarym kolorem widać nasz tekst. To, co wpiszesz, go zastępuje. Nagłówek pokazuje, ile masz już własnych tekstów.

• Najwyżej 400 znaków na tekst.
• Puste pole oznacza nasz tekst.
• Tekst identyczny z naszym nie jest zapisywany.
• Symbole zastępcze w nawiasach klamrowych, jak {n}, {name} albo {time}, widget wypełnia sam. Zostaw je w swoim tekście, jeśli chcesz pokazać tę wartość.

Ważne w kwestii języka: teksty wpisujesz w języku domyślnym projektu i to w nim one działają. Odwiedzający, u których widget działa w innym języku, widzą tam nadal nasze dostarczone teksty. Dla własnych tekstów w kolejnych językach skorzystaj z drogi przez kod (niżej), najlepiej na stronach danej wersji językowej.

Zmiany docierają do twoich odwiedzających w ciągu minuty.

Najważniejsze klucze

Wybór, według obszaru:

• launcher.text, launcher.subtext – etykieta i druga linia przycisku czatu. Fabrycznie puste, wpis ma pierwszeństwo przed polami w Wygląd → Marka.
• launcher.label – etykieta przycisku czatu odczytywana przez czytniki ekranu („Otwórz czat”).
• header.title, header.subtitle_online, header.subtitle_bot, header.response_time – tytuł i drugie linie w nagłówku.
• home.greeting, home.sub, home.start, home.start_sub – powitanie i wejście na stronie startowej (powitanie wygodniej ustawisz w Strona startowa).
• tabs.home, tabs.messages, tabs.help – zakładki.
• input.placeholder i inne input.* – pole wpisywania.
• offline.* – formularz „Zostaw wiadomość”.
• prechat.* – formularz wstępny.
• bh.* – informacje o godzinach pracy.
• ds.* i daten.* – zgoda i karta danych „Twoje dane”.
• msg.ki_notice – informacja przed pierwszą odpowiedzią asystenta AI.
• csat.* – ocena po rozmowie.
• transcript.*, upload.*, handoff.*, queue.*, teaser.*, err.* – historia rozmowy e-mailem, załączniki, przekazanie do zespołu, kolejka, dymek i komunikaty o błędach.

Pełną listę zobaczysz w koncie.

Przez teksty nie da się zmienić informacji „Powered by reactive.chat” (zob. Okno czatu) ani tekstów przewodników po produkcie (zob. Przewodniki po produkcie).

Zastępowanie tekstów w kodzie

We fragmencie osadzenia atrybutem data-rc-strings jako JSON, z kluczami w zapisie z kropkami:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="de"
        data-rc-strings='{"input.placeholder":"Deine Frage zur Bestellung …","header.title":"Kundenservice"}'
        async></script>

Albo w konfiguracji:

ReactiveChat('boot', {
  strings: { 'input.placeholder': 'Twoje pytanie o zamówienie …' }
});

Drugie wywołanie boot na tej samej stronie wczytuje nowe strings. Tak możesz zmienić teksty np. po zalogowaniu.

Teksty ustawione w kodzie obowiązują w każdym języku tak samo. Dlatego ustawiaj je na stronach o ustalonym języku i od razu ustal tam też język.

Kolejność, od najsilniejszego do najsłabszego:

1. Teksty w kodzie (strings) – obowiązują tylko na stronie, na której się znajdują.
2. Własne teksty z konta, w języku domyślnym.
3. Nasze dostarczone teksty w języku odwiedzającego.
4. Angielski.

Kod wygrywa celowo: kto chce inaczej opisać pojedynczą stronę, robi to właśnie tam, bez zmiany ustawienia dla wszystkich innych stron.

Inne teksty w innych miejscach

Niektóre teksty mają własne pole, często osobne dla każdego języka:

• Powitanie, kafelki i strona startowa: Strona startowa czatu
• Zdanie nad formularzem wstępnym (dla każdego języka): Dostępność, formularze i obsługa
• Zdanie zgody i link do polityki prywatności (dla każdego języka): Ochrona danych i zgoda
• Teksty dymków i wiadomości proaktywnych: Wiadomości proaktywne
• Imię i ton asystenta AI: Asystent AI
• Karta promocyjna, także osobno dla każdego języka w kodzie: Karta promocyjna w czacie