Как создать телеграм-бота: 2 пути для новичка с нуля

Что такое телеграм-бот и когда он вообще нужен

Телеграм-бот - это отдельный аккаунт без номера телефона, за которым стоит программа: человек пишет /start, программа решает, что ответить, и делает это за доли секунды. Официальная документация описывает это так: «Bots are small applications that run entirely within the Telegram app», и добавляет ключевое ограничение для новичка - «Bots can't start conversations with users. A user must either add them to a group or send them a message first»

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

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

Какой путь выбрать: конструктор или код?

Конструктор выигрывает скоростью: 10 минут на первый ответ бота против получаса на код, зато код выигрывает гибкостью и тем, что логика бота становится твоей, а не чужим сервисом с лимитами. У обоих путей общий первый шаг - BotFather, поэтому выбор ты делаешь только на этапе логики ответов, а не раньше

Для простого FAQ-бота без амбиций хватает конструктора. Если планируешь растить бота - подключать оплату, свою базу знаний, нейросеть под капотом - код с первого дня экономит месяцы переноса логики из чужого сервиса

Шаг 0: что нужно до старта

Для BotFather и конструктора хватает Telegram на телефоне или компьютере, ничего больше ставить не нужно. Для пути с кодом дополнительно нужно окно Claude Code - место, где ты словами пишешь ИИ задачу, а он сам пишет и запускает файлы за тебя

Во ВКонтакте набор дверей другой, и кнопки «включить бота» в настройках сообщества там нет вовсе: маршрут разобран отдельно в Чат-бот ВК: автоответчик в группе и 3 двери, две без кода

Если Claude Code ещё не стоит на компьютере, отдельная статья ведёт через установку по шагам: установка агента и первый запуск. Вернёшься сюда с готовым окном, дальше пойдёт быстро

Путь без кода вообще не требует этой строки в таблице - конструктор живёт в браузере, а код доступа от BotFather просто вставляется в форму. Заранее решать, какой путь брать, не обязательно: пока не дойдёшь до BotFather, ничего не установлено зря

Как завести бота через BotFather?

BotFather выдаёт код доступа любому боту ровно за две команды: /newbot, потом имя и username, и весь процесс занимает не больше пяти минут без единого рубля. Открой Telegram, найди в поиске @BotFather (проверь синюю галочку верификации рядом с именем - на 17.08.2026 у аккаунта 8 518 674 monthly users, это официальный сервис Telegram, не подделка), нажми Start

Username подчиняется жёсткому правилу, документация формулирует его дословно:

«Your bot's username must end in 'bot', like 'tetris_bot' or 'TetrisBot'»

Telegram, Bot features

Ограничение простое: 5-32 знака, латинские буквы и цифры, обязательное окончание на bot. Сменить username после создания нельзя, а вот отображаемое имя - можно в любой момент командой /setname

Строка, которая придёт в ответ, - это код доступа: набор цифр, двоеточие и ещё набор букв, всё вместе выглядит как один длинный пароль. Про него BotFather сразу предупреждает:

«Keep your token secure and store it safely, it can be used by anyone to control your bot»

Telegram, Bot features

Практический вывод: эту строку не публикуют в постах, не кладут в открытый проект на GitHub, не пересылают в общий чат - у кого она есть, тот управляет ботом. Дальше она идёт в конструктор (Путь 1) или в один запрос для Claude Code (Путь 2) - выбирай раздел ниже

Путь 1: как собрать бота в SendPulse без кода?

В SendPulse бот подключается вставкой кода доступа от BotFather в готовую форму, дальше сценарий собирается блоками на холсте. База знаний сервиса описывает подключение так: «Create a new bot with @BotFather by sending the /newbot command... Copy this token and add to your SendPulse account»

Порядок действий:

Дальше в визуальном редакторе добавляешь свои триггеры: блок Message отвечает текстом на ключевое слово, блок Button показывает кнопки выбора, блок Filter разводит сообщения по условию. До 10 ключевых слов на автоматический ответ - хватает с запасом на простой FAQ

Бесплатный тариф закрывает старт полностью:

Это не единственный сервис такого класса - похожую логику держат BotHelp, Aimylogic и Salebot, у всех есть платные тарифы с CRM и своей нейросетью внутри, но бесплатного входа без карты, как у SendPulse, стоит поискать отдельно под свою задачу

Путь 2: как Claude Code пишет бота за один запрос?

Claude Code пишет рабочий Python-файл по описанию логики словами, а дальше сам же его и запускает у тебя на компьютере - печатать команды руками не нужно, всё делается в том же окне, где ты пишешь запрос. Готовый набор кода, на котором держится бот, называется python-telegram-bot, актуальная версия 22.8 - официальная страница проекта показывает и версию, и число загрузок за месяц

Запрос Claude Code для этой статьи звучал так - открой Claude Code, вставь текст ниже целиком в поле внизу окна и нажми Enter:

Напиши телеграм-бота на python-telegram-bot. Логика: на /start - приветствие
с подсказкой трёх ключевых слов. На любое текстовое сообщение - если в нём
встречается слово "цена", "часы работы" или "как купить", ответить готовым
текстом из словаря FAQ. Иначе - повторить сообщение эхом с припиской
"Ты написал: ...". Код доступа бери из переменной окружения BOT_TOKEN.

Готовый файл получился коротким - меньше 50 строк без пустых, и это полный код целиком, ни одной строки не спрятано:

import os
import logging

from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, ContextTypes, filters

logging.basicConfig(level=logging.INFO, format="%(asctime)s %(levelname)s %(message)s")
log = logging.getLogger("echo_faq_bot")

FAQ = {
    "цена": "Тариф один - 990 рублей в месяц, без скрытых платежей.",
    "часы работы": "Работаем каждый день с 9:00 до 21:00 по Москве.",
    "как купить": "Жми /start, дальше кнопка «Оформить» - оплата картой прямо в Telegram.",
}

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    await update.message.reply_text(
  "Привет! Я тестовый бот. Спроси про «цена», «часы работы» или «как купить» - "
  "отвечу сразу. Любое другое сообщение я просто повторю."
    )

async def handle_text(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    text = (update.message.text or "").strip().lower()
    for keyword, answer in FAQ.items():
  if keyword in text:
      log.info("FAQ-совпадение: keyword=%r -> answer=%r", keyword, answer)
      await update.message.reply_text(answer)
      return
    echo = f"Ты написал: {update.message.text}"
    log.info("Эхо-ответ: %r", echo)
    await update.message.reply_text(echo)

def build_app() -> Application:
    token = os.environ.get("BOT_TOKEN", "")
    app = Application.builder().token(token or "dummy:token-not-set").build()
    app.add_handler(CommandHandler("start", start))
    app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, handle_text))
    return app

if __name__ == "__main__":
    token = os.environ.get("BOT_TOKEN")
    if not token:
  raise SystemExit("Задай BOT_TOKEN: export BOT_TOKEN=\"<код доступа от @BotFather>\"")
    application = build_app()
    log.info("Бот запущен, жду сообщений (Ctrl+C - остановить)")
    application.run_polling()

Дальше не нужно самому разбираться, как поставить нужный набор кода и запустить файл - это тоже одна фраза Claude Code, а он сам наберёт и выполнит всё нужное у себя за экраном, ты только смотришь на результат:

Если делать это своими руками, а не через агента, три команды выглядят вот так - Claude Code выполнит их за тебя сам, приводим для полноты картины и для тех, кто хочет разобраться в деталях:

python3 -m venv .venv
source .venv/bin/activate
pip install python-telegram-bot
export BOT_TOKEN="8123456789:твой-настоящий-код-доступа-от-BotFather"
python3 echo_faq_bot.py

Пока это окно с запущенным ботом открыто, он отвечает в Telegram. Остановить - фраза Claude Code «останови бота» или сочетание Ctrl+C. Закрыл окно - бот замолчал, это нормально для теста. Чтобы бот отвечал круглосуточно даже при выключенном компьютере, его переносят на отдельную постоянно включённую машину в интернете - это уже следующий шаг после теста, а не часть этой статьи

Как проверить, что бот действительно отвечает?

Проверка без живого кода доступа всё равно проходит через реальный код: те же функции start() и handle_text(), что уйдут в Telegram, можно прогнать локально на подставных сообщениях и увидеть настоящий ответ бота в том же окне Claude Code. Вот весь файл проверки, test_local.py, - попроси Claude Code сохранить его рядом с echo_faq_bot.py (так мы назвали файл бота выше) и запустить:

"""test_local.py - локальный прогон РЕАЛЬНОГО кода echo_faq_bot.py без сети.

Импортирует настоящие async-обработчики start()/handle_text() из бота и
прогоняет их через подставные объекты Update/Message (стандартный приём
проверки python-telegram-bot, без обращения к серверам Telegram).
Печатает то, что бот реально отправил бы пользователю - это и есть улика
код тот же, что в статье, ответ получен прогоном, а не
придуман.
"""
import asyncio
from unittest.mock import AsyncMock, MagicMock

from echo_faq_bot import start, handle_text

def make_update(text):
    update = MagicMock()
    update.message = MagicMock()
    update.message.text = text
    update.message.reply_text = AsyncMock()
    return update

async def run_case(handler, text, label):
    update = make_update(text)
    await handler(update, context=MagicMock())
    sent = update.message.reply_text.call_args.args[0]
    print(f"[{label}] вход: {text!r}")
    print(f"[{label}] бот ответил: {sent!r}")
    print()

async def main():
    await run_case(start, "/start", "start")
    for msg in ["Какая у вас цена?", "Часы работы какие", "Как купить доступ", "Просто случайный текст"]:
  await run_case(handle_text, msg, "text")

if __name__ == "__main__":
    asyncio.run(main())

Я прогнал этот файл для статьи 17.08.2026, вот дословный ответ, который показал Claude Code:

[start] вход: '/start'
[start] бот ответил: 'Привет! Я тестовый бот. Спроси про «цена», «часы работы» или «как купить» - отвечу сразу. Любое другое сообщение я просто повторю.'

[text] вход: 'Какая у вас цена?'
[text] бот ответил: 'Тариф один - 990 рублей в месяц, без скрытых платежей.'

[text] вход: 'Часы работы какие'
[text] бот ответил: 'Работаем каждый день с 9:00 до 21:00 по Москве.'

[text] вход: 'Как купить доступ'
[text] бот ответил: 'Жми /start, дальше кнопка «Оформить» - оплата картой прямо в Telegram.'

[text] вход: 'Просто случайный текст'
[text] бот ответил: 'Ты написал: Просто случайный текст'

Пять из пяти сообщений получили правильный ответ: три попали в FAQ по ключевому слову, одно ушло эхом, приветствие сработало на /start. На живом боте с настоящим кодом доступа проверка ещё проще - написать /start самому себе в Telegram и одно сообщение с ключевым словом, свериться с тем, что должно прийти

Если бот молчит на живом коде доступа, первым делом спроси у Claude Code «почему бот не отвечает» - он читает тот же вывод, что видишь ты, и обычно сразу называет причину. Чаще всего это опечатка в коде доступа или незапущенный процесс - в отличие от локальной проверки выше, живой бот работает, только пока запущен файл echo_faq_bot.py

Как донастроить бота командами BotFather?

Донастройка бота - это ещё несколько команд тому же BotFather вроде /setdescription и /setcommands, без единой строчки кода за пределами чата. Полный список того, что он умеет кроме /newbot:

Самое частое, что стоит сделать сразу после /newbot, - это /setdescription и /setcommands. Первое человек видит до того, как нажмёт Start, второе экономит ему секунды на каждый запрос к боту

Какие грабли ждут новичка?

Три ошибки ловят почти всех на первом боте, и каждая лечится одной командой вроде /start или заменой одного слова в username:

Четвёртая грабля - чисто денежная: бесплатный лимит конструктора (10 000 сообщений в месяц у SendPulse) кажется огромным, пока бот не начинает рассылать уведомления каждому подписчику разом. Один такой пуск на пару тысяч человек съедает лимит за один день

Сколько это стоит на самом деле?

Первый бот на любом из двух путей стоит 0 рублей: BotFather бесплатен всегда, у SendPulse и у python-telegram-bot есть бесплатный вход без карты. Деньги появляются там, где бот начинает расти

Для теста из этой статьи не потрачено ни рубля: бот написан и проверен реальным запуском локально без единого платного вызова

Что бот не умеет из коробки?

Из коробки бот умеет ровно то, что ты вписал в FAQ: отвечать готовым текстом на 3-5 заготовленных слов, не больше. Он не помнит контекст между сообщениями дальше того, что явно сохранено в коде, не понимает синонимы («стоимость» вместо «цена» без отдельной строки в словаре не сработает), не проверяет оплату сам

Дальше начинается настройка под конкретную задачу: подключить нейросеть, чтобы бот понимал вопрос своими словами, а не только точное совпадение слова; завести приём оплаты прямо в чате; научить бота писать заявки в таблицу или CRM. Каждый из этих кусков - отдельная тема, и именно они превращают демо-бота в рабочий инструмент бизнеса

Про то, чем агент отличается от такого бота и когда нужен именно он, - отдельный разбор: ИИ-агенты простыми словами. Если задача - бот, который отвечает по твоей базе знаний, а не по жёсткому словарю, это уже другая механика: Нейрокуратор - бот, который отвечает по твоей базе знаний

Источники

• Шаги /newbot, требования к username, формат и предупреждение о токене - Telegram, Bot features
• «10 million bots», правило «бот не пишет первым» - Telegram, Bots overview
• Публичный профиль и живой счётчик пользователей BotFather - t.me/botfather
• Версия python-telegram-bot 22.8, лицензия LGPL-3.0 - PyPI, python-telegram-bot
• Бесплатный тариф и шаги подключения бота - SendPulse, Chatbot for Telegram
• Точный порядок кнопок при подключении токена - SendPulse, база знаний
• Собственный код и прогон echo/FAQ-бота - оба файла опубликованы в статье целиком (листинги выше), ответ проверки показан дословно в разделе про локальный тест

Памятка: создать телеграм-бота с нуля

Пройди по строкам, прежде чем звать первого живого пользователя

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

Читайте также

Нейрокуратор: ИИ-бот, который отвечает по твоей базе знаний

Бот, который отвечает по твоей базе знаний, а не по жёсткому словарю ключевых слов

ИИ-агенты: что это простыми словами и как собрать своего

Чем агент отличается от бота с жёсткими правилами и когда он нужен вместо него

Claude Code установка из России: скачать, оплатить подписку Pro и Max

Пререквизит для пути с кодом - вход, тариф и первый запуск команды