Одно действие вместо сайта-скачивалки

Одно действие и никаких инструкций

Человек отправляет ссылку — бот присылает файл. Больше ничего делать не нужно: ни выбирать платформу, ни указывать качество, ни чистить ссылку от хвостов.

Ссылка распознаётся в любом виде, в каком её присылают: короткие адреса кнопки «Поделиться» — vm.tiktok.com, fb.watch, pin.it, youtu.be, региональные адреса Pinterest, ссылка без https:// и даже ссылка в подписи к фото или видео. Именно такие обычно и присылают, и на них обычно спотыкаются.

Пять платформ и то, что с них забирается: Instagram — Reels, видео, карусели и отдельные фото; TikTok — видео и фото-слайдшоу; Facebook — видео; Pinterest — картинки и целые доски; YouTube — видео.

Под каждую платформу — свой рецепт

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

У Facebook первым идёт кодек, который Telegram показывает на всех устройствах, и бот перебирает четыре способа его добыть, прежде чем согласиться на модный новый, — ровно чтобы не приходил «звук без картинки». У YouTube бот берёт самое высокое разрешение, какое есть у ролика, — хоть 4K, — если файл помещается в лимит, и сам спускается ступенькой ниже, если не помещается; вес прикидывается заранее, чтобы не качать зря то, что всё равно не отправится. До 1080p бот по возможности берёт самый совместимый формат, а выше YouTube хранит ролики только в новых форматах сжатия — и бот берёт их: здесь выбрано качество, а не совместимость со старыми телефонами. Звук для длинных роликов подбирается отдельно, чтобы часовое видео не срывалось из-за одной дорожки. У TikTok первой берётся версия без водяного знака, а копия со знаком остаётся на самый крайний случай — лучше с меткой, чем ничего. У Instagram отдельно вытаскивается более высокое разрешение, которое платформа прячет в раздельных дорожках.

Звучит как мелочи, но именно из этих мелочей складывается разница между «скачалось» и «скачалось так, что можно смотреть».

Где один инструмент пасует, включается второй

Основной загрузчик отлично работает с видео и совершенно не умеет доски Pinterest, смешанные карусели Instagram и фото-слайдшоу TikTok — на них он либо возвращает пустоту, либо молча теряет половину картинок.

Для этих трёх случаев бот сразу идёт другим инструментом, а если и тот ничего не принёс — возвращается к первому. Человек об этой развилке не знает: он просто получает свой альбом целиком.

Видео до полутора гигабайт

Обычный бот упирается в пятьдесят мегабайт: больше Telegram от ботов не принимает. Поэтому рядом с ботом, на том же сервере, работает собственный сервер Telegram — официальная открытая программа самого Telegram как раз для таких случаев. Через него уходят файлы до полутора гигабайт.

Потолок мог бы быть и два гигабайта, но свой сервер Telegram обрывает соединение, если ответа нет дольше восьми с лишним минут. Два гигабайта на скорости домашнего канала уходят почти впритык к этому пределу, и если отправка его переждёт, бот уже не узнает, дошёл ли файл. Полтора уходят с запасом.

Большие файлы приносят свои поломки, и они закрыты заранее. Если Telegram оборвал соединение после долгой отправки, файл, скорее всего, уже ушёл: бот не отправляет его второй раз, а пишет, что Telegram ещё обрабатывает файл и он, скорее всего, появится в чате в ближайшие минуты, — иначе человек получил бы два одинаковых видео. Если YouTube не отдал кусок ролика, бот не склеивает видео с дырой, а честно говорит, что скачать не вышло, и это скачивание не засчитывает. Файл, который всё-таки вышел тяжелее лимита, не отправляется: бот говорит, сколько получилось, и советует ролик покороче.

Загрузки идут на отдельный внешний диск. Если он отвалится, файлы пошли бы на маленький системный — и гигабайтное видео уронило бы весь сервер вместе с базой. Поэтому перед каждой загрузкой бот проверяет, что места хватает, а при нехватке просит попробовать через несколько минут — и попытку не списывает.

Видно, сколько осталось

Гигабайт качается и уходит минутами, поэтому бот не молчит. Статус живёт в одном сообщении и обновляется по ходу работы.

Перед началом скачивания видно, в каком качестве и какого веса придёт видео. Если не в максимальном, бот объясняет почему: в 4K ролик весит больше, чем можно отправить, поэтому придёт лучшее, что помещается, — например, 1080p.

Во время скачивания — шкала с процентами и оставшимся временем. Когда видео склеивается со звуком, так и написано. При отправке в Telegram — примерный процент: сам Telegram ход приёма файла не сообщает, и бот считает его по средней скорости последних крупных отправок. Поэтому процент честно помечен как примерный.

Смысл простой: пока видно, что работа идёт, незачем присылать ссылку второй раз или думать, что бот завис.

До пяти ссылок за раз

Ссылки можно присылать пачкой — до пяти, одним сообщением или по одной. Бот ставит их в очередь и качает по одной; у каждой своё сообщение со статусом и местом в очереди: «В очереди: 2-я». Присылать заново не нужно — бот дойдёт до каждой сам. Та же ссылка дважды в очередь не встаёт, а лишние сверх пяти бот не теряет молча: перечисляет, какие не поставил и почему.

Очередь устроена так, чтобы через неё нельзя было обойти лимит и чтобы ссылка не пропала молча. Бесплатное скачивание бронируется в момент, когда ссылка встаёт в очередь, а не когда до неё дойдёт черёд, — пачка из пяти ссылок не проскочит мимо лимита в три. Если бесплатные кончились посреди пачки, предложение подписки приходит одно, а не на каждую ссылку. А если бот перезапустился, пока ссылки ждали или качались, при старте человек получит список недокачанного, и эти скачивания ему не засчитаются.

Файлы разложены по правилам Telegram

Альбом уезжает частями, крупные картинки отправляются файлом, порядок кадров сохраняется, а смешанные наборы «видео плюс фото» не рассыпаются. Если связь с Telegram моргнула, отправка повторяется с нарастающей паузой, а когда Telegram сам просит подождать — бот ждёт ровно столько, сколько попросили, а не наугад. Короткие беззвучные ролики, которые Pinterest отдаёт вместо гифок, уходят в чат гифкой, а не видео с пустой дорожкой.

Там, где выбор дорожек богатый — у YouTube и Facebook, — бот заранее прикидывает вес и берёт вариант, который поместится в лимит, а не упирается в него в конце долгой загрузки.

Ошибки написаны словами

Приватное видео, удалённая ссылка, гео-блокировка, возрастное ограничение, слишком большой файл, слетевшая авторизация, «слишком много запросов» — на каждый случай свой человеческий ответ, а где есть что посоветовать, там и подсказка, что делать дальше. Разобрано десять самых частых отказов. На одиннадцатый, которого бот ещё не встречал, наружу уйдёт короткая техническая строчка — это край, а не обычное дело, и по ней сразу видно, что чинить. Ключи и служебные адреса из неё вырезаются.

Это не косметика. Внятная ошибка снимает обращение в поддержку: человек сам понимает, что ссылка приватная, и не пишет «у вас не работает».

Бесплатный лимит, подписка и профиль

Бесплатно — три скачивания в сутки, и сутки считаются от каждого скачивания, а не от полуночи. Неудачное скачивание не списывается. Когда бесплатные кончились, бот не просто отказывает, а говорит, через сколько откроется следующее, и тут же предлагает подписку.

Подписка — месяц без ограничений, оплата звёздами прямо в Telegram: одна кнопка, без реквизитов, переводов и скриншотов владельцу. Звёзды — внутренняя валюта Telegram, их покупают в самом приложении. Подписка продлевается сама каждые тридцать дней и отменяется в настройках Telegram. Условия, поддержка и вопросы по оплате открываются отдельными командами — этого Telegram требует от ботов, которые продают.

Главная работа здесь — не кнопка оплаты, а то, чтобы деньги нигде не потерялись. Если бот лежал, пока человек платил, при запуске он найдёт этот платёж и зачислит, а старые ссылки из той же очереди выбросит. Повторное известие о том же платеже не продлит подписку второй раз. Продление сдвигает дату ровно на тридцать дней, даже если в ту же секунду человек прислал ссылку.

В разделе «Мой статус» видно, сколько бесплатных осталось на сутки, до какого числа действует подписка и сколько скачано всего.

Админка вместо доступа к серверу

Владельцу не нужно ни базы, ни консоли: всё делается в том же Telegram. Найти человека по имени или номеру, выдать подписку на нужное число дней, заблокировать и разблокировать, посмотреть сводку — сколько всего людей, сколько активных подписок, сколько скачиваний за сутки, за неделю и за месяц.

О каждой оплате и каждом продлении владелец узнаёт сообщением. В карточке человека — его платежи, и любой можно вернуть в два нажатия: звёзды уходят обратно, автопродление отключается, подписка снимается. Вернуть один платёж дважды нельзя, и никто, кроме владельца, этого сделать не может.

После отправки не остаётся ничего

Скачанный файл удаляется сразу, как только ушёл в чат. Отдельно, раз в несколько минут, бот подчищает всё, что могло зависнуть после сбоя, — в том числе если процесс оборвался посреди загрузки.

Для такого бота это вопрос не аккуратности, а доверия: бот не складывает чужие видео у себя — его копия живёт ровно столько, сколько нужно, чтобы её отправить.