
Як працює Mau Saver: шлях від посилання до файлу
Архітектура Mau Saver: обробники платформ, Kafka, кеш Telegram file_id, доставка медіа та типові збої.
Один чат, кілька різних задач
Для користувача все виглядає просто: надіслати посилання й отримати медіа в Telegram. Для системи це розпізнавання джерела, пошук придатного формату, отримання файлу та його доставка. На кожному етапі можливі окремі помилки — від недоступного матеріалу до обмеження Telegram.
Нижче описуємо загальну архітектуру за кодом репозиторію Mau Saver, переглянутим 11 листопада 2026 року. Конкретні шляхи для платформ відрізняються, а наявність опції в коді сама по собі не підтверджує її стан у поточному розгортанні. Схема — огляд, а не перелік усіх сервісів.
Від посилання до відповіді
- Повідомлення й вибір обробника. Бот приймає посилання та передає його логіці відповідної платформи. Різні джерела повертають різні структури: одиночне відео, зображення, альбом або аудіо.
- Перевірка повторного запиту. У спільному обробнику частини платформ спочатку шукається збережений Telegram file_id за посиланням. Якщо придатний запис знайдено, бот може повторно надіслати медіа без нового завантаження з джерела. Якщо кеш не допоміг, запит переходить до завантажувача.
- Отримання та обробка. Окремі сервіси працюють із конкретними платформами. Наприклад, у YouTube-частині репозиторію є yt-dlp і FFmpeg для отримання та підготовки медіа; не кожен файл обов’язково перекодовується.
- Доставка та результат. Бот надсилає придатний файл у чат, а для деяких сценаріїв зберігає отриманий file_id для повторного використання. Якщо джерело або доставка недоступні, важливо завершити сценарій повідомленням про помилку, а не залишити користувача чекати без пояснення.
Оглядовий шлях: для повторного запиту деякі обробники можуть використати збережений Telegram file_id.
Скріншот секції flowНавіщо розділяти обробники
Посилання різних платформ мають різні формати, помилки й правила доступу. У репозиторії для кількох джерел є окремі сервіси завантаження, а для частини запитів — окремі Kafka-теми. Це дозволяє змінювати логіку конкретного джерела окремо від решти системи й організовувати роботу воркерів за напрямами.
Поділ не гарантує повної ізоляції: мережа, диски, база, брокер і Telegram можуть залишатися спільними залежностями. Якщо спільний компонент перевантажений, проблема здатна зачепити кілька джерел. Тому перевіряти потрібно і платформний сервіс, і спільний шлях доставки.
Чому file_id змінює шлях повторного запиту
Після першого успішного надсилання Telegram може повернути file_id. Код Mau Saver зберігає для частини медіа зв’язок між посиланням, типом і цим ідентифікатором у базі; поряд є короткочасний кеш у пам’яті процесу. За наступного збігу бот може попросити Telegram повторно надіслати файл за file_id. [1]
Це обходить повторне завантаження з джерела для відповідного кешованого сценарію, але не означає, що будь-який URL завжди буде в кеші або працюватиме вічно. Тип медіа, зміни джерела, помилка збереження чи доставки впливають на результат. file_id прив’язаний до конкретного бота; file_unique_id не замінює його для повторного надсилання. [1]
Черги, очікування і повтори
У коді є Kafka-теми запитів і відповідей для окремих платформ. Запит отримує ідентифікатор, за яким відповідь зв’язують з очікуванням; очікування має тайм-аут. Це дає змогу відокремити обробку від приймання повідомлення, але додає запитання про затримку в черзі, недоступного воркера та повторні події.
У документації репозиторію описано характерний ризик довгої обробки YouTube: тривале перекодування може перевищити інтервал опитування Kafka і призвести до втрати очікуваної відповіді. Урок — узгоджувати тайм-аути й тривалість важкої роботи, а не вважати повідомлення про прогрес доказом завершення.
Окремий Rust-воркер доставки також присутній у коді, але в документації зазначено, що він вмикається прапорцем і потребує поетапного розгортання. Без перевірки конфігурації ми не стверджуємо, що він обробляє весь поточний трафік.
Ліміти Telegram і великі файли
Спосіб доставки важливий так само, як розмір файлу. Документація Telegram для звичайного Bot API описує завантаження файлів multipart до 50 МБ для інших типів медіа, а локальний Bot API Server підтримує завантаження до 2 000 МБ. Для повторного надсилання за file_id діють інші правила. Це можливості API, а не обіцянка, що кожен файл такого розміру обробить Mau Saver. [1]
Великі файли довше передаються й займають місце та мережеву пропускну здатність. Потрібно окремо перевіряти обмеження активної конфігурації, доступне місце, очищення тимчасових файлів і поведінку при перерваній доставці.
Що ламається і що варто вимірювати
| Симптом | Що перевірити | Корисний сигнал |
|---|---|---|
| Джерело не повертає медіа | Доступність матеріалу, зміни сторінки або відповіді джерела. | Помилки за платформою та типом. |
| Запит довго чекає | Завантаженість воркерів, чергу, тайм-аути та тривалість обробки. | Час очікування окремо від часу виконання. |
| Файл готовий, але не доставлений | Відповідь Telegram, розмір і повтори доставки. | Затримка доставки та кількість помилок/повторів. |
| Повторні звернення не прискорюються | Ключ кешу, наявність file_id та результат повторного надсилання. | Частка попадань у кеш і помилок кешованої доставки. |
Скільки коштує підтримувати пайплайн
Бюджет — це не лише сервер бота: враховуйте обчислення під час обробки відео, тимчасове сховище, мережевий трафік, брокер, базу, моніторинг і час команди на оновлення. Фактичні витрати залежать від розміру файлів, повторюваності посилань, навантаження та конфігурації. Підтверджених поточних витрат тут не публікуємо.
Зберігайте лише медіа, на використання якого маєте права, і враховуйте правила джерела та приватність людей у чаті. Інструкції для користувачів: додати бота в групу, обробити посилання YouTube. Про інший бік задачі — вартість розробки бота.
Джерела
Дізнайтеся більше про Mau Saver
На сторінці продукту зібрані можливості бота та способи почати роботу.
Пов'язані статті

Як додати Mau Saver у Telegram-групу та зберігати медіа прямо в чаті
Покрокова інструкція, як додати Mau Saver у Telegram-групу, перевірити доступи та завантажувати відео й аудіо одним посиланням.

Як зберегти відео з YouTube у Telegram: швидкий спосіб через Mau Saver
Надішліть YouTube-посилання Mau Saver і отримайте відео, аудіо або плейлист у Telegram. Покрокова інструкція та сценарії використання.

Скільки коштує Telegram-бот для бізнесу у 2026: реальні бюджети
Telegram Bot API безкоштовний, а бізнес-бот ні. Реальні бюджети 2026 для CRM, платежів, Mini Apps і адмінок та як окреслити обсяг без прихованих витрат.