Библиотека файлов

Что такое библиотека файлов

Каждый бот имеет собственную библиотеку медиафайлов — централизованное хранилище изображений, видео, аудио и документов. Файлы загружаются один раз и затем используются в любом количестве блоков.

Загрузка файлов

Из редактора блока

При редактировании медиаблока (Изображение, Видео, Аудио, Документ) нажмите кнопку загрузки — файл сохранится и в блок, и в библиотеку автоматически.

Из менеджера файлов

Нажмите кнопку «Файлы» в шапке конструктора. Откроется библиотека, где можно:

• Загружать новые файлы прямо в библиотеку.
• Просматривать все загруженные файлы с фильтрацией по типу (фото / видео / аудио / документы).
• Удалять неиспользуемые файлы.

Выбор файла из библиотеки

При добавлении медиаблока вместо загрузки нового файла нажмите кнопку «Из библиотеки». Откроется пикер с поиском по названию и фильтром по типу файла.

Выберите нужный файл — он подставится в блок.

Кеширование file_id

После первой отправки файла пользователю Telegram возвращает специальный идентификатор файла — file_id. Конструктор сохраняет его автоматически.

При повторных отправках того же файла бот использует сохранённый file_id — это значительно ускоряет отправку и снижает нагрузку.

Первая отправка файла может занять немного больше времени — пока Telegram обрабатывает и кеширует файл. Последующие отправки будут мгновенными.

Поддерживаемые форматы

Советы

• Давайте файлам понятные названия при загрузке — они отображаются в пикере и помогают быстро найти нужный файл.
• Используйте библиотеку для часто повторяющихся файлов (логотип бота, стандартные изображения меню).
• Файлы из библиотеки также доступны как источник для Inline-меню в динамическом режиме.

Внешний ID (out_id)

При добавлении или редактировании файла можно указать Внешний ID — произвольный уникальный идентификатор, который вы задаёте сами.

Если вы планируете получать файл по внешнему идентификатору, то укажите его здесь.

Внешний ID удобен, когда нужно обращаться к конкретному файлу из сценариев бота без привязки к числовому ID. Например, можно задать welcome_banner и всегда получать нужный файл по этому ключу, даже если вы заменили файл и его числовой ID изменился.

Для получения файла по внешнему ID используйте действие «Получить файл по внешнему ID» в блоке [База данных](База данных) (источник «Файлы»).

• Внешний ID уникален в пределах одного бота.
• При копировании файла поле Внешний ID очищается, чтобы не возникало конфликтов.