---
title: "Тексти інтерфейсу віджета"
description: "Ключі custom_lang_translations: які рядки видно відвідувачу, які лише в словнику, плейсхолдери й відмінності мов."
---

# Тексти інтерфейсу віджета

Підміняє підписи інтерфейсу віджета (поле вводу, кнопки шапки, карусель). Тексти сценарію й поля `title` / `subtitle` у `kw('init')` сюди не входять.

Поля запуску: [Параметри налаштувань віджета](/uk/channels/how-to/widget/widget-settings.md).

## Як передати

Структура: **мова → група → ключ**. Передавайте лише те, що змінюєте: віджет зливає об’єкт із вбудованим словником.

Вбудовані мови: `uk`, `en`, `ru`, `de`, `vn`. Інший код (наприклад `pl`) створює нову мову на базі української.

```javascript
kw('init', {
  bot_id: 1,
  language_code: "uk",
  custom_lang_translations: {
    uk: {
      common: {
        write_a_message: "Напишіть нам…"
      },
      header: {
        privacy_agree: "Погоджуюсь"
      }
    },
    en: {
      common: {
        write_a_message: "Type a message…"
      }
    }
  }
});
```

У `header.privacy_policy_text` залиште `{url}` — туди підставляється `privacy_policy_url`. У `carousel.goToSlide` залиште `{slide}` і `{total}`.

Словники мов **не однакові**: у `uk` немає `common.frame_title` і групи `language_settings`; у `de` і `vn` немає `header.expand` / `header.minimize`. Підміна все одно працює, якщо ключ передати.

## Рядки на екрані

Типовий текст — українською, як у словнику `uk`.

| Ключ | Де на екрані | Типово (uk) |
|---|---|---|
| `common.write_a_message` | Плейсхолдер поля вводу | Напишіть повідомлення |
| `common.send` | Підказка кнопки надіслати | Надіслати |
| `common.reopen_dialog` | Кнопка перезапуску діалогу | Перезапустити |
| `common.you_offline` | Немає мережі, заголовок | Ви не в мережі |
| `common.check_offline` | Немає мережі, підказка | Перевірте своє інтернет-з'єднання |
| `common.too_many_tries` | Антиспам, заголовок | Ви надто часто надсилаєте повідомлення. |
| `common.please_wait` | Антиспам, підказка | Зачекайте, будь ласка, і спробуйте ще раз пізніше. |
| `common.input_phone_label` | Поле телефону в сценарії | Введіть телефон тут... |
| `common.input_email_label` | Поле email у сценарії | Введіть E-mail тут... |
| `common.file_sent_message` | Після надсилання файлу | Файл успішно надіслано |
| `header.expand` | Розгорнути вікно | Розгорнути віджет |
| `header.minimize` | Згорнути вікно | Згорнути віджет |
| `header.stop_chat_sure` | Підтвердження закриття чату | Ви дійсно хочете закрити чат? |
| `header.stop_chat_btn` | Кнопка в цьому підтвердженні | Зупинити |
| `header.continue_chat_btn` | Кнопка в цьому підтвердженні | Продовжити |
| `header.switch_channel` | Перехід у месенджер (мультиканал) | Перейти в месенджер |
| `header.privacy_policy_text` | Текст згоди з політикою | …`<a href="{url}">Політикою конфіденційності</a>`… |
| `header.privacy_agree` | Кнопка згоди | Погодитись, продовжити |
| `header.ip_ban` | Якщо немає `user_block_message` для мови | Доступ до чату з цієї IP-адреси… |
| `agent.thinking` | «Агент думає», якщо в кроці сценарію немає свого тексту | Агент думає... |
| `errors.max_size` | Файл більший за 10 МБ | Розмір файлу не повинен перевищувати 10мб |
| `errors.invalid_file_type` | Непідтримуваний тип файлу | Непідтримуваний тип файлу. |
| `notifications.new_message` | Сповіщення / заголовок вкладки | Нове повідомлення |
| `weekday_names.mon` | Підпис дня | Пн |
| `weekday_names.tue` | Підпис дня | Вт |
| `weekday_names.wed` | Підпис дня | Ср |
| `weekday_names.thu` | Підпис дня | Чт |
| `weekday_names.fri` | Підпис дня | Пт |
| `weekday_names.sat` | Підпис дня | Сб |
| `weekday_names.sun` | Підпис дня | Нд |
| `weekday_names.minutes_age` | «N хв. назад» | хв. назад |
| `carousel.previous` | Карусель, доступність | Попередній слайд |
| `carousel.next` | Карусель, доступність | Наступний слайд |
| `carousel.container` | Карусель, доступність | Карусель зі слайдами |
| `carousel.item` | Карусель, доступність | Слайд |
| `carousel.goToSlide` | Карусель; залиште `{slide}` `{total}` | Перейти до слайду {slide} з {total} |
| `product_cards.buy_button` | Картка товару, якщо немає свого CTA | Купити |
| `product_cards.show_all_specs` | Характеристики картки | Дивитись всі характеристики |
| `product_cards.hide_details` | Характеристики картки | Сховати деталі |

## Є в словнику, на екрані майже не з’являються

Віджет ці рядки зараз не показує. Перевизначити можна так само.

| Ключ | Типово (uk) |
|---|---|
| `app.access_denied` | Доступ заборонено |
| `header.logout` | Вийти |
| `common.close` | Закрити |
| `common.save` | Зберегти |
| `common.success` | Успішно |
| `common.error` | Помилка |
| `common.error_permitions` | не вистачає прав |
| `common.error_delete` | видалення |
| `common.error_update` | оновлення |
| `common.error_save` | збереження |
| `common.error_get` | отримання |
| `common.error_exit` | виходу |
| `common.error_modify` | отримання |
| `common.remove_the_file` | Видалити фай |
| `common.cancel` | Відмінити |
| `common.edit` | Редагувати |
| `common.frame_subtitle_number` | Номер |
| `common.frame_subtitle_status` | Статус |
| `common.frame_subtitle_open` | Відкрита |
| `errors.connect` | Connection error |
| `rules.required` | Поле обов'язкове для заповнення |
| `rules.not_empty` | Поле не повинно бути порожнім |
| `rules.phone` | Поле телефон має бути в форматі +380XXXXXXXXX |
| `rules.email` | Введіть коректний email |
| `login.authorization` | Авторизація |
| `login.email_field` | Email |
| `login.password_field` | Пароль |
| `login.login_button` | Вхід |
| `login.auth_error` | Помилка авторизації |

Ключі **не в українському** словнику, є в `en` / `ru` / `de` / `vn`:

| Ключ | Типово (en) |
|---|---|
| `common.frame_title` | Switching to Business plat having Personal plan paid |
| `language_settings.choose_lang` | Choose language: |
| `language_settings.ru` | Russian |
| `language_settings.en` | English |
| `language_settings.de` | Deutsch (лише словник `de`) |

У словнику віджета немає `modules.op.access_denied`, `modules.op.lack_rights`, `modules.op.texts.without_subject`. Підміна через `custom_lang_translations` можлива, але це не публічний набір рядків.

## Пов’язані статті

- [Параметри налаштувань віджета](/uk/channels/how-to/widget/widget-settings.md)
- [Як налаштувати віджет у Налаштуваннях](/uk/channels/how-to/widget/configure-widget-settings.md)
- [Як налаштувати повідомлення про блокування за IP-адресою](/uk/channels/how-to/widget/configure-ip-blocking-message.md)
- [JavaScript API](/uk/channels/explanation/widget-javascript-api.md)