Не конструктор со сценариями, а свой бот, который думает моделью. Разберём, где он живёт, чем думает, что помнит и в какие лимиты упирается.
Телеграм-бот с нейросетью состоит из трёх частей: токена, который бесплатно выдаёт BotFather, программы-обработчика, которая должна быть запущена постоянно, и ключа к языковой модели, которая пишет ответы. Сложность не в коде: обработчик сегодня пишет агент за несколько минут. Сложность в том, что программе нужно где-то работать круглосуточно, а каждый ответ модели стоит денег.
Дальше по шагам: получить токен, выбрать место работы, подключить модель (включая бесплатный российский вариант), написать обработчик заданием для агента, добавить память диалога, свериться с лимитами Telegram и выпустить бота к людям. Все технические цифры сверены с официальной документацией Bot API и тарифами GigaChat 13 сентября 2026 года.
Что узнаешь из гайда
Часть 1 · Устройство
Главное
Telegram не умеет думать, а модель не умеет получать сообщения. Бот это посредник между ними, и живёт он на вашей стороне.
| Часть | Кто даёт | Сколько стоит |
|---|---|---|
| Токен бота | BotFather в Telegram | бесплатно |
| Место работы | свой компьютер или сервер | от нуля до стоимости сервера |
| Мозги | API языковой модели | по токенам, есть бесплатные квоты |
Если в этой схеме убрать модель, получится обычный сценарный бот с кнопками, который собирается в конструкторе без кода: такой путь разобран в гайде чат-бот своими руками. Здесь речь именно про бота, который отвечает свободным текстом.
Шаг 1 · Токен
В поиске Telegram находите BotFather, пишете команду создания бота, задаёте видимое имя и адрес, который заканчивается на bot. В ответ приходит токен вида 123456:ABC-DEF1234ghIkl. По документации именно этот токен подставляется во все запросы, которые идут на адрес https://api.telegram.org/bot<token>/METHOD_NAME и обязательно по HTTPS.
Важно про токен
Токен это пароль от бота целиком. Его не публикуют в чатах, не коммитят в репозиторий и не вставляют в скриншоты. Если утёк, перевыпускается у BotFather, и старый сразу перестаёт работать.
Шаг 2 · Место
Это главный вопрос всей затеи, и именно на нём спотыкаются новички. Бот это не файл, который лежит в Telegram, а программа, которая должна быть запущена. Выключили компьютер, бот замолчал.
Отсюда же вытекает выбор способа получать сообщения. По документации их ровно два и они взаимоисключающие: getUpdates, когда бот сам спрашивает Telegram о новостях, и вебхук, когда Telegram сам отправляет обновления на ваш адрес. Там же важная деталь: входящие обновления хранятся на сервере Telegram не дольше 24 часов, так что бот, лежавший неделю, чужие сообщения уже не увидит.
Шаг 3 · Мозги
Модель подключается по ключу API. Из России удобнее начинать с российских провайдеров: не нужна иностранная карта и нет вопросов с доступом. По странице тарифов GigaChat для физлиц, обновлённой 31 августа 2026 года, бесплатный Freemium даёт 365 миллионов токенов на двенадцать месяцев с разбивкой 250 миллионов на Lite, 40 на Pro, 25 на Max и 50 на GigaChat-3-Ultra, при этом генерация идёт в один поток. Когда бесплатное закончится, пакеты стоят 1 300 рублей за 20 миллионов токенов Lite, 1 500 за 3 миллиона Pro и 1 950 за 3 миллиона Max, срок пакета месяц.
Зарубежные модели дают качество выше, особенно на сложных задачах, но требуют оплаты валютой. Если этот путь нужен, способы оплаты из России разобраны в гайде оплата зарубежных сервисов, а из проверенных вариантов пополнения подходит сервис оплаты зарубежных сервисов из России.
Практический совет
Начинайте с дешёвой модели и включайте дорогую только там, где она реально нужна. Половина ботов отвечает на простые повторяющиеся вопросы, и разницы между младшей и старшей моделью пользователь не заметит, а счёт отличается в разы.
Шаг 4 · Код
Минимальный бот это тридцать строк: принять сообщение, отправить его модели, вернуть ответ. Писать их руками сегодня необязательно, зато обязательно точно описать поведение. Вот заготовка задания, которую можно скопировать и поправить под себя.
Напиши телеграм-бота на Python.
Библиотека: любая популярная для Bot API, объясни выбор.
Поведение:
- на /start короткое приветствие и что бот умеет;
- обычное сообщение отправляет в модель и возвращает ответ;
- хранит последние 10 сообщений диалога по каждому пользователю;
- если модель вернула ошибку, отвечает понятным текстом, не падает;
- ограничивает ответ 1500 символами.
Ключи брать из переменных окружения, в код не вписывать.
Добавь README: как запустить локально и как запустить на сервере.Обратите внимание на предпоследнюю строку. Ключи в коде это самая частая ошибка начинающих: файл уезжает в репозиторий, и токен бота вместе с ключом от модели становится общим достоянием. Как ставить задачи агенту по коду и не получать кашу, разобрано в гайдах вайбкодинг с нуля и промптинг для Claude Code.
Шаг 5 · Память
Модель не помнит прошлые сообщения. Всё, что она знает, это текст, который вы прислали в текущем запросе. Значит, память бота это ваша структура данных: словарь, файл или таблица, где по каждому пользователю лежат последние реплики.
Если боту нужно отвечать по вашим материалам, а не по общим знаниям модели, память превращается в поиск по базе: перед ответом достаётся нужный кусок документа. Эта схема называется RAG, её устройство разобрано в гайде RAG простыми словами.
Шаг 6 · Лимиты
| Что ограничено | Значение | Когда мешает |
|---|---|---|
| Рассылка сообщений | до 30 в секунду по умолчанию | массовая рассылка по базе |
| Платная рассылка | до 1000 в секунду, 0,1 Stars за сообщение | требует 10 000 Stars на балансе |
| Загрузка фото | до 10 МБ через multipart | снимки с хорошей камеры |
| Загрузка других файлов | до 50 МБ | видео и большие архивы |
| Скачивание ботом | до 20 МБ через getFile | приём длинных PDF от клиентов |
| Хранение обновлений | не дольше 24 часов | бот лежал дольше суток |
Самая болезненная строка это последняя: пока бот не работает, сообщения копятся, но живут сутки. Поэтому для рабочего бота важнее не мощность сервера, а то, что программа поднимается сама после сбоя.
Шаг 7 · Выпуск
Чего делать не надо
Не открывайте бота для всех, пока не поставлен лимит на количество сообщений от одного пользователя. Бесплатная квота модели выносится одним человеком с включённым воображением за полчаса.
Часть 8 · Деньги
Считать надо три статьи: сервер, токены модели и своё время. Первая известна заранее, вторая зависит от того, сколько людей пишут боту и какой длины у него память, третья обычно недооценивается.
Ориентир по токенам
Один обмен репликами это примерно от пятисот до полутора тысяч токенов вместе с историей. Бесплатных 250 миллионов токенов на младшей модели GigaChat при таком расходе хватает на сотни тысяч ответов, то есть личный или небольшой рабочий бот годами не выходит за бесплатный уровень.
Коротко
Источники
FAQ
Сам бот в Telegram бесплатный: токен у BotFather не стоит ничего. Деньги уходят на две вещи: место, где программа работает круглосуточно, и запросы к модели. Начать можно вообще без затрат, если запускать бота на своём компьютере и взять бесплатный режим российского API, например Freemium GigaChat на 365 миллионов токенов сроком двенадцать месяцев.
Писать код руками уже не обязательно, но понимать устройство бота придётся. Агент напишет обработчик по вашему заданию, однако именно вы решаете, где бот живёт, какой моделью думает, что помнит и как ведёт себя при ошибке. Эти решения за вас не примет никто.
Где угодно, где программа запущена постоянно. Домашний компьютер годится для проб, но при выключении бот замолкает. Для работы берут небольшой сервер или запуск по событию. Telegram хранит непрочитанные обновления не дольше суток, поэтому долгий простой означает потерю сообщений.
Два взаимоисключающих способа получать сообщения. При getUpdates бот сам периодически спрашивает Telegram, есть ли новости. При вебхуке Telegram сам стучится на ваш адрес по HTTPS. Первый проще для старта и не требует публичного адреса, второй экономнее и быстрее под нагрузкой.
Если не хочется возиться с иностранной картой, начинайте с российских API: у GigaChat для физлиц бесплатный режим даёт 365 миллионов токенов на двенадцать месяцев, а платные пакеты стоят 1 300 рублей за 20 миллионов токенов Lite, 1 500 за 3 миллиона Pro и 1 950 за 3 миллиона Max. Зарубежные модели дают качество выше, но требуют оплаты валютой.
По документации Bot API по умолчанию до 30 сообщений в секунду. Лимит поднимается до 1000 включением платных рассылок в BotFather: каждое сообщение сверх бесплатного объёма стоит 0,1 Stars и требует баланса не меньше 10 000 Stars. Для личного или рабочего бота бесплатного лимита хватает с запасом.
По документации при загрузке через multipart фотографии ограничены 10 мегабайтами, остальные файлы 50 мегабайтами, а скачивание файла ботом через getFile ограничено 20 мегабайтами. Это важно, если бот задуман как приёмник документов: длинные PDF придётся резать или принимать ссылкой.
Хранить историю самому: Telegram память не предоставляет, модель видит только то, что вы передали в запросе. Практика простая: держите последние несколько сообщений по каждому пользователю, а более старое сворачивайте в короткое резюме. Иначе с ростом переписки растёт счёт за токены.
Да, это самый частый сценарий. Добавляется одно: бот должен отвечать по вашим материалам, а не по общим знаниям модели. Прайс, условия и частые вопросы складывают в базу, из которой перед ответом достаётся нужный кусок. Схема называется RAG и разобрана у нас отдельным гайдом.
Проверьте четыре вещи по порядку: запущена ли программа, верный ли токен, не стоят ли одновременно вебхук и опрос обновлений, не вернула ли модель ошибку. Больше половины случаев это второй и третий пункты: старый токен после перевыпуска или включённый вебхук, который забирает сообщения вместо getUpdates.
Платформа и сообщество, где я по шагам показываю, как поставить ИИ на рутину: контент, код, продажи, аналитика. Заходи и забирай рабочие связки, которыми пользуюсь сам.
Посмотреть, что внутриtelegram
Канал с полезными материалами про нейросети
Разборы, новые инструменты и приёмы по ИИ — то, чем пользуюсь сам, без воды. Подпишись, чтобы не потерять.