Як налаштувати параметри файлів?

Налаштування файлів дозволяє встановити обмеження для завантаження файлів у систему, такі як максимальний розмір файлу та дозволені типи файлів.

Коли знадобиться

Потрібно встановити максимальний розмір файлу (у мегабайтах).
Треба обмежити типи файлів за розширеннями (наприклад, тільки зображення або документи).
Клієнти надсилають стікери Telegram (статичні .webp або анімовані .tgs), і оператори мають бачити їх у стрічці — потрібно дозволити відповідні розширення та MIME-типи.

Що важливо знати

Формат JSON — налаштування зберігаються як об’єкт з полем files (масив правил для типів файлів) та max_file_size_mb (максимальний розмір у мегабайтах).
Кожен елемент у files описує один дозволений тип: назву для довідки (title), розширення без крапки (extension), список MIME-типів (mime_types) і чи дозволено завантаження (allow: true / false).
Максимальний розмір файлу — число в мегабайтах (наприклад, 25).
Стікери Telegram в Операторській панелі — статичні стикери часто приходять як .webp (звичайне зображення); анімовані — як .tgs. У стрічці діалогу анімовані .tgs відображаються як стікер (не лише посиланням на файл), якщо файл успішно завантажено та доступний за посиланням. Щоб вхідні файли з Telegram не відхилялись політикою типів, потрібно додати відповідні розширення та MIME у список дозволених (див. приклад нижче).

Перед початком

Ви увійшли в систему з правами адміністратора або супервайзера.
У вас є права на збереження налаштувань операторської панелі.

Покрокова інструкція

1. Відкрити налаштування файлів

Перейдіть до модуля Налаштування через меню або безпосередньо за адресою /settings-page.
У бічному меню знайдіть розділ «Налаштування» (підрозділ операторської панелі) та розгорніть його.
Натисніть на пункт «Робота з файлами» (/settings-page/op-settings/files).

2. Редагувати JSON-конфігурацію

Відкрийте JSON-редактор на сторінці.
У масиві files додайте або змініть об’єкти з полями title, extension, mime_types, allow.
Вкажіть max_file_size_mb (ціле число, мегабайти). Зверніть увагу: анімовані стикери .tgs мають обмеження розміру з боку Telegram (типово до кількох десятків кілобайт), але загальна політика розміру в системі все одно застосовується.

Телеграм-стікери — що додати в files (якщо цих типів ще немає):

Призначення	`extension`	Приклад `mime_types` (вкажіть ті, що реально віддає ваше сховище / браузер)
Статичний стикер (зображення WebP)	`webp`	`["image/webp"]`
Анімований стикер (Telegram TGS)	`tgs`	`["application/octet-stream"]` — найчастіше для бінарних `.tgs`; за потреби додайте інші типи, якщо завантаження або сховище віддає інший `Content-Type`

Приклад фрагмента з дозволом WebP та TGS (решту записів залиште як у вашій поточній конфігурації):

{
  "files": [
    {
      "title": "Зображення WebP",
      "extension": "webp",
      "mime_types": ["image/webp"],
      "allow": true
    },
    {
      "title": "Анімований стикер Telegram (TGS)",
      "extension": "tgs",
      "mime_types": ["application/octet-stream"],
      "allow": true
    }
  ],
  "max_file_size_mb": 25
}

3. Зберегти налаштування

Перевірте всі внесені зміни.
Натисніть кнопку "Зберегти" у верхній частині сторінки.
Дочекайтеся повідомлення про успішне збереження.

Що відбувається після

Обмеження застосовуються до всіх операторів у системі:

При спробі завантажити файл, що перевищує максимальний розмір, система показує помилку.
При спробі завантажити файл недозволеного типу, система показує помилку.
Вхідні файли з каналів (зокрема Telegram) перевіряються на відповідність дозволеним розширенням (а для завантажень оператора — також MIME-типам з налаштувань).
Оператори бачать обмеження при завантаженні власних файлів.

Як переконатися, що все вдалось

Спробуйте завантажити файл, що перевищує максимальний розмір — система повинна показати помилку.
Спробуйте завантажити файл недозволеного типу — система повинна показати помилку.
Спробуйте завантажити файл, що відповідає обмеженням — завантаження повинно пройти успішно.
Надішліть у діалог з Telegram анімований стикер при дозволеному розширенні tgs — у стрічці Операторської панелі має відображатися анімація стикера.