База знань GetMyBot

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

Де зберігати фото й файли для повідомлень бота. Завантаження до бібліотеки та спосіб отримати файл через Telegram без платної бібліотеки.

На цій сторінці

Якщо бот часто надсилає той самий файл або фотографію, завантажте їх до медіабібліотеки й використовуйте в повідомленнях повторно. Однаковий файл зберігається в одному примірнику, навіть якщо завантажити його кілька разів. Медіабібліотека доступна на платних тарифах, до яких входить зберігання файлів (image_storage).

Для Telegram є також спосіб без платної бібліотеки: завантажити файл через службовий чат і отримати його ідентифікатор file_id. Нижче пояснено обидва способи та їхні обмеження.

Власне сховище

Завантажений файл зберігається в GetMyBot і отримує ідентифікатор. Виберіть файл у блоці повідомлення «Фото» або «Файл», і бот використає його під час надсилання. Через API файл завантажується запитом POST /api/bots/{id}/media, а для попереднього перегляду читається через GET /api/bots/{id}/media/{mediaID}.

Пошук однакових файлів

Якщо завантажити той самий файл ще раз, GetMyBot знайде збережену копію й поверне її попередній ідентифікатор. Однакові файли не займають місце двічі. Для порівняння використовується контрольна сума SHA-256. Технічна назва такого пошуку повторів – дедуплікація.

Доступ за платним тарифом

Медіабібліотека належить до платних можливостей (image_storage). Щоб завантажувати файли, потрібна активна підписка на тариф, який її включає. Без неї завантаження повертає помилку 402 (потрібна оплата). Раніше збережені файли можна переглядати й без активної підписки.

Один файл для медіабібліотеки може мати розмір не більше 2 МіБ.

Завантаження через Telegram-чат без платної бібліотеки

Якщо медіабібліотека недоступна, завантажте файл через службовий Telegram-чат. GetMyBot поверне file_id, за яким бот зможе надсилати цей файл повторно. Платна підписка для цього не потрібна. Розмір файлу також обмежений 2 МіБ. Для розробника: операція має назву sink-upload, адреса – POST /api/bots/{id}/chats/{chatID}/sink-upload.

Який спосіб обрати

ЗавданняСпосібУмови
Зберігати й повторно надсилати фото, бачити попередній перегляд і не створювати копії однакових файлівМедіабібліотекаТариф з image_storage, файл до 2 МіБ
Отримати Telegram file_id без підпискиsink-upload через службовий чатTelegram-чат, файл до 2 МіБ

Що далі