Telegram Client API vs Bot API: в чём разница и что выбрать

Начну с реального кейса. Хочешь автоматически читать сообщения из закрытого чата, куда тебя добавили как обычного пользователя, — обычный бот не справится. Ему туда просто не дадут доступ. И вот тут начинается путаница: люди идут на api.telegram.org/bot и думают, что нашли то, что нужно. Но это не то.

Разбираемся, в чём реальная разница между Telegram Client API и Bot API, когда нужен userbot, а когда хватит aiogram.

Что такое Telegram Bot API

Telegram Bot API — это HTTP-интерфейс, который Telegram предоставляет для управления ботами. Работает через api.telegram.org/bot<TOKEN>/метод. Ты отправляешь запросы на серверы Telegram, они выполняют действия от имени бота.

Как это выглядит технически:

→ Регистрируешь бота через @BotFather

→ Получаешь токен

→ Делаешь HTTP-запросы или используешь библиотеку (aiogram, python-telegram-bot)

→ Бот отвечает только на то, что ему написали напрямую или в группе, где он участник

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

Это мощный инструмент для 80% задач. Если тебе нужен чат-бот, воронка, поддержка, автоответы — Bot API закрывает всё.

Что такое Telegram Client API (MTProto)

Telegram Client API — это низкоуровневый протокол MTProto, через который работают сами приложения Telegram (iOS, Android, Desktop). Ты подключаешься к нему напрямую, используя данные зарегистрированного приложения.

Чтобы получить доступ, нужно зарегистрировать приложение на my.telegram.org и получить два параметра:

→ api_id

→ api_hash

Это не токен бота — это учётные данные приложения, через которое ты будешь взаимодействовать с API. Дальше ты можешь авторизоваться либо как бот (передав токен), либо как обычный пользователь (userbot).

Ключевая разница: userbot действует от имени реального аккаунта. Он может всё, что может человек за экраном.

«Мы использовали userbot через Pyrogram для парсинга участников закрытых чатов конкурентов. За неделю собрали 40 000 пользователей в нашу базу — без единого рубля на рекламу. Bot API для этого просто не подходит.» — Максим Наговицын, вайбкодер и основатель vibecoderz.ru

Pyrogram vs Telethon: какую библиотеку выбрать

Обе библиотеки работают с Client API (MTProto) и позволяют создавать userbotы на Python. Но между ними есть важное различие.

Pyrogram

Долгое время был стандартом для userbot-разработки. Современный, асинхронный, с простым синтаксисом. Установка:

pip install pyrogram tgcrypto

tgcrypto — криптографическая библиотека, которая ускоряет работу с MTProto. Без неё всё тоже работает, но медленнее.

Минимальный эхо-бот на Pyrogram:

from pyrogram import Client, filters

app = Client("my_account", api_id=API_ID, api_hash=API_HASH)

@app.on_message(filters.me)
async def echo(client, message):
    await message.reply(message.text)

app.run()

Фильтр filters.me — важная деталь. Он означает, что хендлер срабатывает только на твои собственные сообщения. Так работает защита от случайного ответа на чужие.

Проблема: Pyrogram перестал активно поддерживаться разработчиком. Последние обновления редкие, часть функций устарела. Это критично при работе с новыми фичами Telegram API.

Telethon

Активно поддерживается, регулярно обновляется. Чуть более многословный синтаксис, но зато стабильный и актуальный.

pip install telethon

Пример авторизации и простого хендлера:

from telethon import TelegramClient, events

client = TelegramClient('session_name', api_id, api_hash)

@client.on(events.NewMessage)
async def handler(event):
    print(event.message.text)

with client:
    client.run_until_disconnected()

При первом запуске Telethon запросит номер телефона → код из Telegram → пароль 2FA (если есть). Сессия сохраняется в файл — при следующих запусках авторизация не нужна.

Важно: Telethon скрывает ввод пароля через модуль getpass. Если кажется, что ничего не происходит — просто вводи пароль вслепую.

Aiogram: когда это правильный выбор

aiogram — это не библиотека для Client API. Это Python-фреймворк для работы с Bot API. Если тебе нужен полноценный бот с хендлерами, машиной состояний, роутером и inline-клавиатурами — aiogram это лучший выбор в 2026.

pip install aiogram

Простейший бот:

from aiogram import Bot, Dispatcher, types
from aiogram.filters import Command

bot = Bot(token="TOKEN")
dp = Dispatcher()

@dp.message(Command("start"))
async def start(message: types.Message):
    await message.answer("Привет!")

async def main():
    await dp.start_polling(bot)

aiogram не даёт доступ к Client API. Он работает только через Bot API — то есть ограничения бота остаются.

Когда нужен userbot, а когда хватит бота

Самый частый вопрос. Вот простая логика:

Выбирай Bot API + aiogram, если:

→ Нужен чат-бот, воронка, поддержка

→ Принимаешь заказы, оплату

→ Бот будет работать в группах как участник

→ Нужен inline-режим

→ Хочешь запустить быстро без регистрации приложения

→ Не хочешь рисковать аккаунтом

Выбирай Client API + Telethon (userbot), если:

→ Нужно парсить участников чатов

→ Нужен доступ к истории сообщений до добавления бота

→ Нужно автоматически вступать в каналы или группы

→ Нужно управлять своим аккаунтом программно

→ Делаешь автоматизацию для личного использования

→ Нужно читать сообщения в чатах, куда бот не может попасть

Используй оба вместе, если:

→ Userbot собирает данные, бот раздаёт их пользователям

→ Нужна полная автоматизация Telegram-присутствия

Как получить api_id и api_hash через api.telegram.org

Это нужно и для Pyrogram, и для Telethon — без этих данных к Client API не подключиться.

→ Открой my.telegram.org

→ Войди через номер телефона

→ Перейди в «API development tools»

→ Заполни форму: название приложения, короткое имя

→ Скопируй api_id (число) и api_hash (строка)

Храни их как секреты — в .env файле или конфиге, который не попадает в Git. Не публикуй в репозиториях.

# config.ini
[pyrogram]
api_id = 12345678
api_hash = abcdef1234567890abcdef1234567890

FloodWait и другие ограничения Client API

При работе с userbot через Client API есть важное исключение — FloodWaitError (в Pyrogram) или FloodWaitError (в Telethon). Возникает, когда ты делаешь слишком много запросов к серверу за короткое время.

from pyrogram.errors import FloodWait
import asyncio

try:
    await message.edit(text)
except FloodWait as e:
    await asyncio.sleep(e.value)

Обрабатывай этот случай всегда — особенно в массовых рассылках, редактировании сообщений и парсинге.

И главное: Telegram банит аккаунты за спам и нарушение правил. Userbot — инструмент для автоматизации личных задач, не для массовой рассылки чужой рекламы.

Реальные юзкейсы из практики

На основе разобранных видео и опыта работы с Telegram API — вот что реально строят на userbotах:

Парсинг аудитории:

Получить список участников открытого или закрытого чата → выгрузить в базу → использовать для таргетинга. Python + Pyrogram/Telethon закрывают эту задачу полностью.

Анимированные сообщения:

Typing effect — редактирование сообщения каждые 50 мс с добавлением по одной букве. Выглядит как набор в реальном времени. Реализуется через метод edit + обработка FloodWait.

Фильтрация входящих:

Userbot мониторит все входящие сообщения по ключевым словам и пересылает нужные в отдельный чат или сохраняет в базу.

Массовое удаление сообщений:

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

Мониторинг каналов:

Подписаться на 50 каналов и автоматически пересылать посты с ключевыми словами в агрегатор.

FAQ

Чем отличается api.telegram.org bot от Client API?

api.telegram.org/bot — это адрес Bot API, HTTP-интерфейса для управления ботами по токену. Client API (MTProto) — низкоуровневый протокол для полного доступа к Telegram как пользователь. Это разные вещи с разными возможностями.

Pyrogram или Telethon — что сейчас актуально?

В 2026 году Pyrogram фактически заброшен разработчиком. Для новых проектов рекомендуем Telethon — он активно поддерживается и совместим с актуальными версиями Telegram API.

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

Зависит от задачи. Парсинг открытых чатов — серая зона. Массовая рассылка спама — прямое нарушение правил Telegram и гарантированный бан аккаунта. Автоматизация личных задач — ок.

Нужен ли api_id для обычного бота через Bot API?

Нет. Для Bot API нужен только токен от @BotFather. api_id и api_hash нужны только для Client API (Pyrogram, Telethon).

Aiogram работает с Client API?

Нет. aiogram — фреймворк исключительно для Bot API. Для Client API нужен Pyrogram или Telethon.

Что делать, если userbot получает FloodWait?

Обрабатывать исключение и делать паузу на указанное количество секунд (e.value). Не игнорировать — иначе аккаунт могут временно заблокировать.

Можно ли авторизовать несколько аккаунтов одновременно?

Да. В Telethon каждая сессия — отдельный файл с уникальным именем. Создаёшь несколько экземпляров TelegramClient с разными именами сессий — работают параллельно.

Обновлено: июнь 2026 | Каталог инструментов для вайбкодинга → | Консультация с Максимом: t.me/maxnagovitsyn