База знаний GetMyBot

Медиабиблиотека

Где хранить фотографии и файлы для сообщений бота. Загрузка в библиотеку и способ получить файл через Telegram без платной библиотеки.

На этой странице

Если бот часто отправляет одну и ту же программу курса или фотографию, загрузите файл в медиабиблиотеку и используйте его в сообщениях повторно. Одинаковый файл хранится в одном экземпляре, даже если загрузить его несколько раз. Эта возможность входит в платные тарифы, где доступно хранение файлов (image_storage).

Для отправки через Telegram есть и способ без платной библиотеки: загрузить файл через служебный чат и получить его Telegram-идентификатор file_id. Оба способа и их ограничения описаны ниже.

Своё хранилище

Загруженный файл сохраняется в GetMyBot и получает свой идентификатор. Выберите его в блоке сообщения «Фото» или «Файл»; при отправке бот подставит нужный файл. Для подключения через API: загрузка POST /api/bots/{id}/media, чтение для предпросмотра GET /api/bots/{id}/media/{mediaID}.

Дедупликация по содержимому

Если загрузить тот же файл ещё раз, GetMyBot найдёт уже сохранённую копию и вернёт прежний идентификатор. Одинаковые файлы не занимают место дважды. Для сравнения используется контрольная сумма файла SHA-256; такой поиск повторов называется дедупликацией.

Premium-доступ

Медиабиблиотека относится к premium-возможностям (image_storage). Она доступна на платном тарифе, который её включает; без активной подписки загрузка в библиотеку возвращает ошибку 402 (требуется оплата). Предпросмотр уже сохранённых файлов работает без ограничений.

Размер одного файла при загрузке в библиотеку ограничен 2 МиБ.

Загрузка через Telegram-чат (без платной библиотеки)

Если платная библиотека недоступна, загрузите файл через служебный Telegram-чат. GetMyBot вернёт file_id, по которому бот сможет отправлять этот файл повторно. Способ доступен без платной подписки; размер файла также ограничен 2 МиБ. Для разработчика: операция называется sink-upload, адрес POST /api/bots/{id}/chats/{chatID}/sink-upload.

Что использовать

ЗадачаПодходящий способТребования
Хранить и повторно отправлять одинаковые изображения, видеть предпросмотр и не создавать дублиМедиабиблиотекаТариф с image_storage, файл до 2 МиБ
Получить file_id Telegram без подпискиsink-upload через служебный чатTelegram-чат, файл до 2 МиБ

Что дальше