Налаштуйте мову віджета DobroDesk

Що саме локалізується

Віджет завантажує два типи мовного вмісту. Текст інтерфейсу охоплює кнопку, поля, перевірки та повідомлення про стан. Клієнтський вміст охоплює запропоновані відповіді й керовані сценарії підтримки, схвалені для цієї locale.

Зміна лише мови інтерфейсу не перекладає наявну публічну відповідь. Кожну клієнтську відповідь потрібно перевірити й опублікувати окремо для її locale, щоб клієнт не бачив суміші мов.

• Англійська використовує locale code en.
• Українська використовує locale code uk.
• Німецька використовує locale code de.
• Іспанська використовує locale code es.
• Французька використовує locale code fr.
• Бразильська португальська використовує locale code pt.
• Регіональне значення браузера, наприклад uk-UA, зіставляється з primary language code uk.
• Завантажувач використовує запитану мову, лише якщо її додано до ввімкнених мов віджета. Інакше він використовує налаштовану мову за замовчуванням.

Увімкніть автоматичне визначення мови

Згенерований embed code типово використовує auto. Під час завантаження віджет читає основну мову браузера, порівнює її з увімкненими мовами й використовує налаштовану мову за замовчуванням, якщо запитану мову не ввімкнено. Автоматичне визначення не аналізує текст сторінки й не перекладає вміст у браузері.

<script
  async
  src="https://widget.dobrodesk.com/widget/loader/v1.min.js"
  data-dobrodesk-integration="wgt_7f4c1d2e3a5b6980718293a4b5c6d7e8"
  data-dobrodesk-locale="auto"
></script>

Задайте явну мову для локалізованої сторінки

Використовуйте явну locale, якщо сайт має окремі мовні маршрути. Підтримуються мови інтерфейсу en, uk, de, es, fr і pt. Віджет усе одно використає лише мову, ввімкнену в його конфігурації, а інакше — налаштовану мову за замовчуванням.

<script
  async
  src="https://widget.dobrodesk.com/widget/loader/v1.min.js"
  data-dobrodesk-integration="wgt_7f4c1d2e3a5b6980718293a4b5c6d7e8"
  data-dobrodesk-locale="uk"
></script>

Задайте або змініть locale через SDK

Передайте ввімкнену locale під час ініціалізації, якщо застосунок уже знає поточну мову. Якщо відвідувач змінює мову без повного перезавантаження, викличте setLocale з новою підтримуваною locale. Віджет перезавантажить відповідний інтерфейс і клієнтський вміст.

const supportWidget = createDobroDeskWidget({
  integrationId: "wgt_7f4c1d2e3a5b6980718293a4b5c6d7e8",
  locale: currentSiteLocale,
});

await supportWidget.ready;

// After an in-app language change
supportWidget.setLocale("uk");

Підготуйте публічний вміст для кожної мови

1. 1

   Визначте, чи кожен мовний маршрут сайту використовуватиме auto або явну ввімкнену locale: en, uk, de, es, fr чи pt. Якщо мову не ввімкнено, використовується налаштована мова за замовчуванням.

2. 2

   Створіть або перевірте запропоновані відповіді й керовані сценарії окремо для кожної мови, яку публікуєте. Перекладайте зміст і актуальні правила, а не окремі слова.

3. 3

   Перевірте назви продуктів, ціни, юридичні формулювання, робочі години й очікуваний час відповіді в кожній опублікованій версії.

4. 4

   Публікуйте лише завершені відповіді. Якщо одна мова ще не готова, вимкніть для неї автоматичні ШІ-відповіді й передавайте звернення колезі.

Перевірте ввімкнені мови й налаштовану мову за замовчуванням

1. 1

   Відкрийте публічний сайт у приватному вікні, задавши в браузері мову locale, яку перевіряєте.

   

2. 2

   Перевірте кнопку "Підтримка", заголовок, доступність, поля форми, перевірки й підтвердження.

   

3. 3

   Відкрийте кожну запропоновану відповідь і керований сценарій. Перевірте, чи немає відсутніх текстових ключів або речень іншою мовою.

4. 4

   Надішліть повідомлення з назвою locale й переконайтеся, що розмова надійшла до DobroDesk із цією locale.

5. 5

   Повторіть тест із мовою браузера, яку не ввімкнено, і перевірте, що віджет використовує налаштовану мову за замовчуванням.