Как устроены Telegram-боты: понятное объяснение

Большинство пользователей, которые регулярно общаются с Telegram-ботами, понимают их работу только наполовину. Этот разрыв порождает путаницу, когда конкретный бот не делает то, чего вы ожидали. Например, бот TubeDisk: принимает пересланные видео, но игнорирует ссылки на YouTube. В этом материале разбираем, как Telegram-боты устроены на самом деле, что они могут и не могут по своему дизайну, и почему ограничения существуют.

Что такое Telegram-бот по сути

Telegram-бот это обычный аккаунт, которым управляет программа, а не человек. Для серверов Telegram он выглядит как пользователь: у него есть имя (с суффиксом bot в конце), он может получать и отправлять сообщения, его можно добавлять в группы. Разница в том, что где-то на сервере работает программа, которая читает входящие сообщения бота и решает, как на них отвечать.

Часть со стороны Telegram называется Bot API: это набор HTTP-вызовов, через которые внешняя программа получает сообщения от Telegram, отправляет ответы и выполняет несколько других действий. Зарегистрировать бота может любой через @BotFather, инфраструктура самого бота (сервер, читающий сообщения и принимающий решения) лежит на операторе.

Что боты умеют делать

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

Чего боты не могут

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

Лимит на размер файла: 20 МБ против 2 ГБ

Стандартный Bot API ограничивает один файл двадцатью мегабайтами. Это жёсткое ограничение публичного интерфейса от Telegram. Бот, работающий через стандартный сервер Telegram, не может принять или отправить файл больше этого размера.

Есть обходной путь: Telegram открыл исходный код сервера Bot API, и любой оператор может запустить свой экземпляр вместо использования размещённого на серверах Telegram. Свой сервер Bot API поднимает лимит примерно до 2 ГБ на файл (это тот же лимит, что у обычных пользователей Telegram). TubeDisk использует собственный сервер Bot API именно по этой причине: чтобы бот мог принимать те крупные видео-файлы, которыми обычно делятся в чатах.

Почему бот TubeDisk не принимает ссылки

Этот вопрос задают чаще всего: "отправил боту ссылку на YouTube, и ничего не произошло, почему?". Ответ структурный, а не "не успели добавить функцию":

Бот TubeDisk это бот в Telegram. Он умеет получать файлы, которые ему пересылают. Это родное действие Telegram с понятным смыслом.
Для скачивания по ссылке (YouTube, TikTok, Instagram) у TubeDisk есть веб-интерфейс. Вставка ссылки там запускает наш конвейер обработки, который учитывает особенности конкретного источника (склейка DASH-потоков для YouTube, расшифровка подписи, заголовки для обхода защиты от ботов).
Если смешать эти два сценария и принимать ссылки в боте, пришлось бы дублировать всю логику веб-интерфейса в боте. В принципе можно, но это новая поверхность для атак (ограничение частоты запросов, защита от злоупотреблений пришлось бы переделывать для бота), и главное, пользователи бы путались, какой канал для какой задачи.

Мы выбрали ясность: бот для пересланных файлов (родное действие Telegram). Веб-интерфейс для ссылок (всё остальное). Оба пишут в одно облако, которое вы настроили.

Как безопасно пользоваться любым Telegram-ботом

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

Частые заблуждения о Telegram-ботах

"Бот в моей группе читает всё, что мы пишем"

По умолчанию нет. Боты в группах работают в "режиме приватности": видят только сообщения, в которых их упомянули (например, @botname привет), и ответы на свои сообщения. Режим приватности оператор может отключить, но обычно это делают только для модерационных ботов, и видно это в настройках бота.

"Я могу через бота читать сообщения канала, в котором меня нет"

Нет. Бот читает сообщения только из чатов, в которых он сам участвует. Даже если вас в канале нет, нужно чтобы там был бот, и только сообщения, появившиеся после того, как бот туда вошёл.

"Telegram-боты сканируют все мои личные чаты"

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

"Моего бота забанили, что это значит?"

Telegram отозвал доступ бота к Bot API. Обычно за нарушение политики площадки (массовый спам, распространение запрещённого содержимого, злоупотребления). Токен бота перестаёт работать, он не может получать и отправлять сообщения. Бан бота обычно не снимается.

Частые вопросы

Почему бот TubeDisk каждый раз присылает подтверждение?

По двум причинам: чтобы вы знали, что файл реально получен и сохранён (сам Telegram об этом не сообщает), и чтобы ссылка на сохранённый файл была видна в истории чата с ботом для удобства последующего обращения.

Может ли бот автоматически сохранять в Google Drive посты канала, в котором я админ?

Нет. Как объяснено выше, боты не могут читать историю канала или проактивно следить за новыми постами в каналах, в которых они не состоят. Практический предел "перешлите то, что хотите сохранить, бот сохранит".

Что будет, если я заблокирую бота TubeDisk?

Блокировка остановит сообщения от бота вам. Уже сохранённые файлы остаются в вашем облаке. Чтобы возобновить использование, разблокируйте и отправьте /start заново.

Можно ли нескольким пользователям делить один аккаунт TubeDisk через бота?

Каждый аккаунт TubeDisk привязан к одному пользователю Telegram. Для командных задач рекомендуется завести отдельный аккаунт на каждого участника, каждый направить на одну общую папку в облаке (Drive или Dropbox) через настройки.

См. также

Часто задаваемые вопросы

Чем отличается «forward-бот» от «URL-бота»?

URL-боты принимают только ссылку в чат: вы копируете URL видео, отправляете боту, он возвращает файл или ссылку на загрузку. Forward-боты принимают переслыки из других каналов: вы пересылаете видео-сообщение из канала, бот скачивает оригинальный media-attachment и заливает в ваше облако. TubeDisk поддерживает оба сценария: URL-вход через web и Telegram, forward-вход через Telegram. Это разные пайплайны: URL парсится через yt-dlp, forward пересылается через Bot API.

Безопасно ли пересылать боту приватные ссылки?

Ссылка отправляется в наш Telegram-бот через шифрованное соединение Telegram MTProto. На наших серверах URL обрабатывается только для извлечения видео-потока (yt-dlp), затем файл заливается в подключенное вами облако и удаляется из временного хранилища. URL и метаданные могут попасть в access-логи (как и в любом веб-сервисе) - они хранятся 30 дней и автоматически удаляются.

Лимиты Telegram - что это и как обходятся?

Telegram Bot API имеет ограничение 50 MB на исходящий файл для обычных ботов. Для файлов больше 50 MB мы используем Telegram Local Bot API Server (наш собственный self-hosted instance) - там лимит 2 GB. Поэтому для больших видео TubeDisk-бот может прислать файл, а sandbox-боты на бесплатных серверах - нет.

Почему бот «думает» по 30-60 секунд?

Время отклика бота складывается из: 1) yt-dlp parsing видео-метаданных (3-10 сек), 2) загрузка с источника на наш сервер (зависит от размера и канала), 3) транзит файла обратно в Telegram или upload в cloud-провайдер. Premium-тарифы получают приоритет в очереди обработки.

Как на самом деле устроены Telegram-боты, и почему бот TubeDisk не принимает ссылки