27 октября 2026 г.
Доступы к Telegram API получены, а что на них собирать - непонятно. Разбираю два пути по шагам: что умеет бот и чего он не умеет никогда, что может только свой клиент на api_id и api_hash, чем этот путь опаснее для вашего аккаунта и как выбрать за пять минут по своему списку задач.
Дальше по порядку: в чём разница между двумя путями на уровне механики, что умеет бот и чего он не умеет никогда, что доступно только своему клиенту, чем этот путь опаснее, как выбрать за пять минут по своему списку задач, что делать, если задача требует обоих, и куда смотреть, когда ничего не работает.
Бот и свой клиент: в чём разница
Коротко: бот - отдельный аккаунт, которым управляет ваш код через простой интерфейс поверх HTTPS. Свой клиент - полноценное приложение Telegram, которое входит в ваш личный аккаунт и работает его руками.
Документация Telegram описывает три разных API, и нам сейчас важны два из них.
Bot API. Боты - это особые аккаунты, которым не нужен отдельный номер телефона. Такой аккаунт служит интерфейсом для кода, который работает где-то на вашем сервере. Шифрование и общение с внутренним протоколом Telegram берёт на себя промежуточный сервер самого Telegram, а ваш код разговаривает с ним по обычному HTTPS. Разбираться в устройстве MTProto не нужно совсем.
Telegram API. Это доступ для тех, кто собирает собственное приложение-клиент. Он открывается по api_id и api_hash, которые вы получаете в разделе «API development tools» на my.telegram.org, и работает от имени того самого аккаунта, чей номер вы туда ввели. Как получить эти ключи и что делать, когда форма выдаёт ошибку, я разбирала в статье про api id и api hash Telegram.
Разница, из которой вырастает всё остальное: бот - новая сущность рядом с вами, клиент - вы сами в виде программы. У бота своя аватарка, своё имя, своя история переписок. У клиента своего нет ничего: он открывает ваш аккаунт, видит то же, что видите вы, и отвечает за свои действия вашей репутацией.
Что умеет бот и чего он не умеет никогда
Коротко: бот отлично работает там, где человек пришёл сам. Начать разговор первым он не может в принципе, и на этом рассыпается половина идей про рассылки.
Что бот закрывает хорошо:
- Приём заявок. Человек отвечает в чате на три вопроса, ответы падают в таблицу. Как собрать такую связку без программиста, показано в разборе как подключить телеграм-бота к n8n.
- Выдача бесплатника. Гайд, подборка, видео отдаются сразу после нажатия кнопки.
- Уведомления команде. Креатор сдал ролик, форма заполнена, оплата прошла - сообщение падает в рабочий чат.
- Ответы на повторяющиеся вопросы. Сроки, размеры, условия.
- Витрина и оплата. Мини-приложения внутри Telegram и приём платежей.
Теперь жёсткие границы, которые прописаны в документации прямым текстом.
Бот не начинает разговор с человеком. Пользователь должен сам написать боту или добавить его в группу. Найти бота люди могут по юзернейму или по ссылке вида t.me с этим юзернеймом. Отсюда практический вывод: база из тысячи номеров не превращается в рассылку через бота никаким способом. Сначала человек нажимает «Начать», потом вы можете ему писать.
Бот по умолчанию не видит всю переписку в группе. Все боты в группах работают в режиме приватности и получают только адресованное им: команды со своим юзернеймом, общие команды вроде /start, если бот писал в группу последним, ответы на свои сообщения и служебные сообщения. Режим отключается, и тогда бот читает чат как обычный участник, но Telegram советует делать это лишь там, где без этого бот не работает. Бот-администратор получает все сообщения независимо от режима.
У бота мало места в облаке: старые сообщения сервер может удалить вскоре после того, как они обработаны. Хранить историю надо у себя.
И оговорка про случай, который многие принимают за «бот всё-таки пишет первым». Telegram Business позволяет подключить бота к своему аккаунту, чтобы он разбирал входящие и отвечал от вашего имени там, где вы это разрешили: владелец сам указывает, к каким чатам у бота есть доступ, а права включают ответ, отметку прочитанными и удаление. Это ответ на письмо, которое вам уже написали, и не способ написать незнакомому человеку.
Что умеет только свой клиент
Коротко: клиент на api_id и api_hash нужен там, где надо читать то, что видит ваш аккаунт, и действовать от его имени.
Задачи, которые бот не закроет никогда:
- Чтение чатов, в которых вы состоите. Радар спроса по профильным чатам, поиск вопросов по своей теме, сбор упоминаний бренда.
- Выгрузка своей переписки. Архив диалогов с клиентами, перенос истории в свою базу.
- Работа от своего имени. Отправка сообщения в чат как вы, а не как сторонний бот с пометкой в шапке.
- Свой интерфейс Telegram. Собственный клиент под узкую задачу.
Как это выглядит в работе завода. У нас есть десяток профильных чатов, где спрашивают про внешний трафик и про креаторов. Клиент читает новые сообщения, отбирает те, где есть слова-признаки заявки, и складывает их в таблицу со ссылкой, автором и временем. Менеджер раз в день открывает таблицу и отвечает руками, по одному. Собрать такой контур под свой процесс - это вайбкодинг для контент-заводов: нейросеть пишет код, вы задаёте правила и смотрите на результат.
Что при этом нельзя даже под соусом автоматизации. Условия использования Telegram API запрещают вмешиваться в базовую работу мессенджера, и первым пунктом там идут действия от имени человека без его ведома и согласия. Там же сказано, что данные, полученные с платформы Telegram, запрещено использовать для обучения и дообучения нейросетей. Массовая рассылка в личные тем, кто вас не звал, в эти рамки не попадает ни при каком сценарии.
Чем свой клиент опаснее для вашего аккаунта
Коротко: за действия клиента отвечает ваш личный аккаунт, а не абстрактный скрипт. За злоупотребление документация обещает блокировку навсегда.
Три риска, которые надо принять до того, как вы заведёте ключи.
Первый. Наблюдение по умолчанию. В документации сказано: из-за массовых злоупотреблений все аккаунты, которые входят через неофициальные клиенты, автоматически попадают под наблюдение. Вы ещё ничего не сделали, а аккаунт уже в особом списке.
Второй. Блокировка навсегда. Все клиентские библиотеки строго контролируются. За флуд, спам и накрутку счётчиков подписчиков и просмотров каналов блокируют навсегда - именно это слово стоит в документации. Если аккаунт заблокировали без нарушения условий, Telegram предлагает написать на адрес для восстановления и объяснить, что вы собирались делать с API; письма читает человек, и автоматические обращения детектируются и блокируются.
Третий. Один номер - один api_id. На момент проверки каждый номер может иметь только один api_id, и важные уведомления для разработчиков Telegram присылает на тот номер, который вы указали при получении ключей. То есть ключи привязаны к живому аккаунту, который вам нужен для работы.
Посчитайте цену ошибки в своих деньгах. Личный аккаунт предпринимателя в телеграме - это переписка с клиентами, доступы к рабочим чатам и вход в каналы, где лежит ваша же база. Потеря такого аккаунта обходится дороже недели работы программиста. Поэтому логика у меня простая: любая задача, которая решается ботом, решается ботом, а клиент заводится только там, где без него задачи не существует.
И популярная подмена, которая не работает. Фраза «сделаю ботом, чтобы не рисковать аккаунтом» верна только до того момента, когда в задаче появляется чтение чужих чатов. Чтения в Bot API нет, и бот его не заменяет ничем.
Бот или свой клиент Telegram: как выбрать за пять минут
Коротко: выписать задачи, отметить, у кого в каждой инициатива, и завести доступ только под большинство. Пять шагов, одна страница бумаги.
Шаг 1. Выпишите свои задачи - каждую одной строкой. Формулировка строгая: кто пишет, кому и что должно случиться. Например: «человек с прокладки оставляет телефон, телефон падает в таблицу».
Шаг 2. Отметьте те, где инициатива у человека. Он сам открывает чат и пишет вам. Это задачи для бота, и обычно их большинство.
Шаг 3. Отметьте те, где нужно читать чужие чаты или свою переписку. Это задачи для клиента.
Шаг 4. Проверьте спорные. Задача требует писать первым незнакомым людям - вычеркивайте, так нельзя ни ботом, ни клиентом. Это не технический запрет, который обходится настройкой, это условия сервиса.
Шаг 5. Заведите доступ под большинство задач. Для бота это токен в BotFather - как его получить по шагам, разобрано в статье про создание бота в Telegram. Для клиента это api_id и api_hash на my.telegram.org.
Адрес, с которого начинается путь клиента:
my.telegram.org
Имя, с которого начинается путь бота:
@BotFather
Если в задаче нужны оба пути
Коротко: два доступа в одном проекте удваивают риск утечки, поэтому второй путь заводится позже и отдельно.
Бывает, что без обоих не обойтись: клиент читает профильные чаты и приносит вопросы, бот принимает заявки с прокладки и пишет менеджеру. Такая связка нормальна, но собирается она в два этапа, а не в один вечер.
Порядок, по которому я это делаю:
- Сначала собирается и выходит в работу бот. Он проще, безопаснее и обычно закрывает большую часть задач.
- Клиент добавляется, когда бот уже работает месяц и понятно, чего в контуре правда не хватает.
- Токен бота и ключи клиента лежат в разных местах и не попадают в один файл настроек. Это разные секреты, и их постоянно путают.
- Клиент запускается с отдельного аккаунта, если это возможно по вашей задаче. Личный аккаунт собственника в такой схеме трогать не надо.
- У каждого процесса свой запуск и свой лог. Два процесса на одних доступах выедают лимиты вдвое быстрее, и второй часто оказывается забытым запуском на другом компьютере.
Если на этом месте вы поняли, что проектируете уже целую систему, разложите её на бумаге до кода. Такие контуры я собираю на стратегической сессии: что живёт в боте, что в клиенте, что в таблице и кто на это смотрит каждый день.
Частые ошибки и что они значат
Коротко: почти все сбои на старте упираются в путаницу между двумя доступами и в режим приватности.
- Бот молчит на сообщение в группе. Включён режим приватности, и бот получает только то, что адресовано ему. Либо дайте боту права администратора, либо отключите режим и добавьте бота в группу заново.
- Бот не может написать человеку первым. Это не ошибка настройки. Пользователь должен сам написать боту или добавить его в группу.
- Ключи клиента подставлены в бота. api_id и api_hash не работают в Bot API, а токен бота не работает в клиентской библиотеке. Доступы разные, проверьте, что подставили.
- Один номер, второй api_id. Каждый номер может иметь только один api_id. Второй набор ключей на тот же номер получить не получится.
- Клиент работает на тестовом api_id из примеров. В открытом коде Telegram лежит образец api_id: он ограничен на стороне сервера, и у приложений с живыми пользователями выдаёт ошибку о превышении лимита по опубликованному идентификатору. Свой api_id обязателен по условиям использования.
- Аккаунт попал под ограничения после первого же запуска скрипта. Клиентские библиотеки под контролем, и резкий поток запросов с нового доступа читается как злоупотребление.
Если не получилось
Коротко: сначала проверьте, что задача вообще решается выбранным доступом, потом настройки, и только затем пишите в поддержку сервиса.
Порядок, который экономит время:
- Перечитайте свою задачу из шага 1 и проверьте, у кого инициатива. Половина тупиков - это попытка сделать ботом то, что бот не умеет.
- Для бота: откройте его по ссылке t.me со второго аккаунта, нажмите «Начать» и посмотрите, доходит ли сообщение до вашего кода. Если бот открывается, проблема в коде или в сценарии.
- Для бота в группе: проверьте режим приватности и права. Админ получает все сообщения независимо от режима.
- Для клиента: проверьте, что ключи взяты с того же аккаунта, с которым вы работаете, и что запущен только один процесс.
- Проверьте логи на ошибку про ожидание: если сервис просит подождать, перезапуск скрипта это время не сбрасывает. Соседние сбои разобраны в материале про то, что делать, когда api.telegram.org не отвечает.
Если аккаунт заблокировали после работы с API и вы уверены, что условия не нарушали, Telegram предлагает написать по адресу восстановления и объяснить своими словами, что вы собирались делать с API. Письмо читает человек, поэтому шаблонная заготовка от нейросети тут работает против вас.
Правила, лимиты и изменения по ботам публикуются в документации и в новостном канале платформы ботов, и там же есть официальная поддержка.
Не хотите разбираться сами
Коротко: подключение и автоматизацию можно отдать, а разбор задачи бесплатный.
Самостоятельная сборка оправдана, пока контур простой: принять заявку, отдать файл, прислать уведомление. Как только в нём появляются оплата, напоминания, чтение чатов и аналитика, ваше время начинает стоить дороже работы специалиста. Посчитайте честно: сколько ваших вечеров уйдёт на разбирательство и сколько заявок за это время пройдёт мимо. А как устроена связка редактора и нейросети, которая этот код пишет, видно в разборе что такое MCP простыми словами.
Если хотите отдать целиком - собираем бота, клиентский контур и автоматизацию под ваш процесс в ИИ-разработке. Если сначала надо понять, что вообще автоматизировать, приходите на бесплатный созвон на 20 минут или на консультацию: разберём ваш список задач и решим, где хватит бота, а где без клиента правда не обойтись.
Я, Анастасия Майер, собираю такие связки каждую неделю и выкладываю рабочие схемы в Telegram-канале. Разборы своих настроек и чужих ошибок мы устраиваем в клубе Майер - туда можно принести свой список задач и выбрать путь вместе.
Источники
- Документация Telegram: боты для разработчиков - боты как особые аккаунты без отдельного номера телефона, промежуточный сервер и интерфейс поверх HTTPS, запрет начинать разговор первым, ограниченное облачное хранилище, режим приватности, токен как полный контроль над ботом. Проверено 27 октября 2026.
- Документация Telegram: три API платформы - разделение на Bot API, Telegram API и TDLib, клиентский доступ по api_id и api_hash через MTProto.
- Документация Telegram: создание своего приложения - получение api_id и api_hash через my.telegram.org, один api_id на номер, уведомления разработчику на этот номер, наблюдение за аккаунтами неофициальных клиентов, пожизненная блокировка за флуд и накрутку, адрес для восстановления, ограничения тестового api_id из открытого кода.
- Условия использования Telegram API - запрет действий от имени человека без его ведома и согласия, запрет использования данных платформы для обучения нейросетей, требование своего api_id, сроки на устранение нарушений.
- Документация Telegram: возможности ботов - режим приватности в группах и что именно бот получает по умолчанию, права бота-администратора, подключение бота к бизнес-аккаунту и права на ответ в личных чатах, отдельный бот для тестов.
- Практика 20 контент-заводов в 10 нишах: телеграм-контур в воронке, радар спроса по профильным чатам, разборы на консультациях.