Довідковий центр DobroDesk
Використовуйте англійську або українську у віджеті DobroDesk
Увімкніть автоматичне визначення мови або задайте locale віджета, а потім разом перевірте підписи інтерфейсу, публічні відповіді й повідомлення клієнта.
Результат
Віджет відкриватиметься англійською або українською, а для іншої мови браузера повертатиметься до англійської.
Що саме локалізується
Віджет завантажує два типи мовного вмісту. Текст інтерфейсу охоплює кнопку, поля, перевірки та повідомлення про стан. Клієнтський вміст охоплює запропоновані відповіді й керовані сценарії підтримки, схвалені для цієї locale.
Зміна лише мови інтерфейсу не перекладає наявну публічну відповідь. Кожну клієнтську відповідь потрібно перевірити й опублікувати окремо для її locale, щоб клієнт не бачив суміші мов.
- Англійська використовує locale code en.
- Українська використовує locale code uk.
- Регіональне значення браузера, наприклад uk-UA, зіставляється з primary language code uk.
- Будь-яка інша locale зараз повертається до англійської.
Увімкніть автоматичне визначення мови
Згенерований embed code типово використовує auto. Під час завантаження віджет читає основну мову браузера: для uk або uk-UA використовує українську, для en або en-US — англійську, а для інших мов — англійську як fallback. Автоматичне визначення не аналізує текст сторінки й не перекладає вміст у браузері.
<script
async
src="https://dobrodesk.com/widget/loader/v1.min.js"
data-dobrodesk-integration="wgt_7f4c1d2e3a5b6980718293a4b5c6d7e8"
data-dobrodesk-locale="auto"
></script>Використовуйте auto, якщо сайт обслуговує відвідувачів кількома мовами, а налаштування браузера достатньо точно відображає вподобання клієнта.
Задайте явну мову для локалізованої сторінки
Використовуйте явну locale, якщо сайт має окремі мовні маршрути. Задавайте uk на українському маршруті та en на англійському. Зараз це дві доступні публічні locale віджета.
<script
async
src="https://dobrodesk.com/widget/loader/v1.min.js"
data-dobrodesk-integration="wgt_7f4c1d2e3a5b6980718293a4b5c6d7e8"
data-dobrodesk-locale="uk"
></script>Залиште на сторінці один embed. Передавайте потрібне значення locale з наявного мовного стану сайту, а не додавайте окремий script для кожної мови.
Задайте або змініть locale через SDK
Передайте en або uk під час ініціалізації, якщо застосунок уже знає поточну мову. Якщо відвідувач змінює мову без повного перезавантаження, викличте setLocale з новою підтримуваною locale. Віджет перезавантажить відповідний інтерфейс і клієнтський вміст.
const supportWidget = createDobroDeskWidget({
integrationId: "wgt_7f4c1d2e3a5b6980718293a4b5c6d7e8",
locale: currentSiteLocale,
});
await supportWidget.ready;
// After an in-app language change
supportWidget.setLocale("uk");Підготуйте публічний вміст для кожної мови
Визначте, чи кожен мовний маршрут сайту використовуватиме auto, en або uk. Для іншої мови браузера fallback зараз англійський.
Створіть або перевірте запропоновані відповіді й керовані сценарії окремо англійською та українською. Перекладайте зміст і актуальні правила, а не окремі слова.
Перевірте назви продуктів, ціни, юридичні формулювання, Business hours і очікуваний час відповіді в обох версіях.
Публікуйте лише завершені відповіді. Якщо одна мова ще не готова, вимкніть для неї автоматичні ШІ-відповіді й передавайте звернення колезі.
Машинний переклад може допомогти підготувати чернетку, але перед публікацією її має перевірити відповідальна за комунікацію з клієнтами людина.
Перевірте англійську, українську та fallback
Відкрийте публічний сайт у приватному вікні, задавши в браузері мову locale, яку перевіряєте.
Перевірте кнопку "Підтримка", заголовок, доступність, поля форми, перевірки й підтвердження.
Відкрийте кожну запропоновану відповідь і керований сценарій. Перевірте, чи немає відсутніх текстових ключів або речень іншою мовою.
Надішліть повідомлення з назвою locale й переконайтеся, що розмова надійшла до DobroDesk із цією locale.
Повторіть fallback-тест з іншою мовою браузера й перевірте появу англійської.