Тексты и языки

Виджет говорит на немецком, английском, польском. Любой из примерно 200 текстов можно заменить: в аккаунте для всех страниц или в коде для отдельных.

Как виджет выбирает язык

Виджет находится внутри страницы. Поэтому то, что посетитель читает сейчас, важнее настройки браузера. Порядок:

1. Язык, выбранный страницей для посетителя через ReactiveChat('setLocale', …) (ниже).
2. Фиксированный язык в коде встраивания (data-rc-locale) или конфигурации.
3. Иначе язык страницы из <html lang="…">.
4. Иначе язык по умолчанию аккаунта.
5. Иначе язык браузера, в конце — английский.

Региональные коды сокращаются: de-AT становится de. Неизвестный виджету язык заменяется английским.

Поэтому важнее всего правильный <html lang> на страницах. Тогда виджет сам следует языковым версиям сайта.

Язык по умолчанию в аккаунте

В /app/projects/{id}, вкладка Установка, раздел Основное, задаётся Язык по умолчанию: de, en или pl. Две задачи:

• Действует на страницах без <html lang>, если код встраивания не задаёт язык.
• На нём пишутся свои формулировки, главный экран и промокарточка (ниже).

Задание языка в коде

Фиксированно для страницы, в коде встраивания:

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

Во время работы, например из своего переключателя языков:

ReactiveChat('setLocale', 'en');

setLocale сразу меняет тексты виджета. Выбор запоминается в браузере посетителя на год, затем имеет приоритет над data-rc-locale и на других страницах. Собственного переключателя языка в виджете нет. Если посетитель должен выбирать, вызывайте setLocale из своего переключателя.

Свои формулировки в аккаунте

На вкладке Тексты и формы, в разделе Свои формулировки, перечислены все тексты с ключами, сгруппированы по областям и свёрнуты. Наш текст показан серым в поле. Введённое заменяет его. Заголовок показывает число собственных текстов.

• До 400 символов на текст.
• Пусто означает наш текст.
• Текст, точно совпадающий с нашим, не сохраняется.
• Виджет подставляет значения в фигурные скобки, например {n}, {name}, {time}. Сохраните их, если значение должно отображаться.

Важно о языке: тексты вводятся на языке проекта по умолчанию и действуют там. Посетители с другим языком виджета по-прежнему видят наши тексты. Для собственных текстов на других языках используйте код (ниже), лучше на страницах соответствующей языковой версии.

Изменения доходят до посетителей в течение минуты.

Важнейшие ключи

Выборка по областям:

• launcher.text, launcher.subtext — подпись и вторая строка кнопки. Изначально пусты; запись имеет приоритет над полями Внешний вид → Оформление.
• launcher.label — подпись кнопки для экранных дикторов («Открыть чат»).
• header.title, header.subtitle_online, header.subtitle_bot, header.response_time — заголовок и вторые строки вверху.
• home.greeting, home.sub, home.start, home.start_sub — приветствие и входная точка главного экрана (приветствие проще задать в Главном экране).
• tabs.home, tabs.messages, tabs.help — вкладки.
• input.placeholder и остальные input.* — поле ввода.
• offline.* — форма «Оставьте сообщение».
• prechat.* — форма перед чатом.
• bh.* — уведомления о часах работы.
• ds.* и daten.* — согласие и карточка «Ваши данные».
• msg.ki_notice — уведомление перед первым ответом ИИ-ассистента.
• csat.* — оценка после разговора.
• transcript.*, upload.*, handoff.*, queue.*, teaser.*, err.* — переписка на почту, вложения, передача команде, очередь, облачко подсказки и ошибки.

Полный список виден в аккаунте.

Надпись «Powered by reactive.chat» (см. Окно чата) и тексты туров (см. Туры по продукту) через тексты не меняются.

Замена текстов в коде

В коде встраивания — data-rc-strings как JSON, ключи через точки:

<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>

Или в конфигурации:

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

Второй вызов boot на той же странице загружает новые strings. Так можно менять тексты, например после входа.

Тексты из кода действуют одинаково на всех языках. Поэтому задавайте их на страницах с фиксированным языком и там же задавайте язык.

Порядок приоритета, от сильного к слабому:

1. Тексты в коде (strings) — действуют только на своей странице.
2. Свои формулировки аккаунта на языке по умолчанию.
3. Наши тексты на языке посетителя.
4. Английский.

Код побеждает намеренно: если одна страница требует другой подписи, сделайте это там, не меняя настройки всех остальных.

Другие тексты в других местах

У некоторых текстов собственные поля, часто для каждого языка:

• Приветствие, плитки, главный экран: Главный экран чата
• Фраза над формой перед чатом (по языкам): Доступность, формы и обслуживание
• Фраза согласия и ссылка на политику (по языкам): Конфиденциальность и согласие
• Тексты подсказок и проактивных сообщений: Проактивные сообщения
• Имя и тон ИИ-ассистента: ИИ-ассистент
• Промокарточка, в коде также по языкам: Промокарточка в чате