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

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

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

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

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

Максимальний розмір файлу (МБ) — задається окремим полем у верхній частині сторінки (наприклад, 25).
Таблиця типів файлів — основний спосіб керування: для кожного рядка вказуються Дозволено, Розширення, Назва та MIME-типи. Додавання й редагування — через діалог «Додати тип файлу» / редагування рядка.
JSON (додатково) — у згорнутому блоці JSON можна переглянути або змінити ту саму конфігурацію текстом; зміни в редакторі одразу відображаються в таблиці вище.
Кожен тип у списку — розширення без крапки (наприклад, pdf), назва для довідки, один або кілька MIME-типів, прапорець дозволу.
Стікери Telegram в Операторській панелі — статичні стикери часто приходять як .webp (звичайне зображення); анімовані — як .tgs. У стрічці діалогу анімовані .tgs відображаються як стікер (не лише посиланням на файл), якщо файл успішно завантажено та доступний за посиланням. Щоб вхідні файли з Telegram не відхилялись політикою типів, потрібно додати відповідні розширення та MIME у список дозволених (див. приклад нижче).

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

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

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

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

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

2. Задати максимальний розмір

У полі «Максимальний розмір файлу (МБ)» введіть ліміт у мегабайтах (ціле число, мінімум 1).

3. Керувати дозволеними типами файлів

У таблиці типів файлів перегляньте поточні рядки (колонки Дозволено, Розширення, Назва, MIME).
Щоб додати тип, натисніть «Додати тип файлу», заповніть у діалозі:
- Дозволено — чи приймається цей тип;
- Розширення — без крапки (наприклад, pdf);
- Назва — підпис для адміністратора;
- MIME-типи — через кому (підказка на формі, наприклад application/pdf, image/jpeg).
Натисніть «Зберегти» у діалозі. Якщо розширення вже є в таблиці, з’явиться повідомлення «Тип файлу з таким розширенням уже існує» — змініть розширення або відредагуйте існуючий рядок.
Щоб змінити або прибрати тип, використайте кнопки редагування або видалення в рядку таблиці.
(Опційно) Розгорніть блок JSON, якщо зручніше правити конфігурацію текстом — зміни синхронізуються з таблицею.

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

Додайте відповідні рядки в таблиці (або записи в JSON). Зверніть увагу: анімовані стикери .tgs мають обмеження розміру з боку Telegram (типово до кількох десятків кілобайт), але загальна політика розміру в системі все одно застосовується.

Що додати:

Призначення	`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
}

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

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

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

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

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

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

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