Как сделать Telegram-бота: пошаговая инструкция для подростка

Свой Telegram-бот — один из лучших первых проектов в программировании. Он работает в настоящем мессенджере, им можно сразу похвастаться друзьям, а первую версию можно сделать за вечер. Ниже — пошаговая инструкция, которую подросток может пройти сам (а родитель — вместе с ним).

Что понадобится

• аккаунт в Telegram;
• компьютер на Windows или macOS;
• Python (бесплатно, python.org) и редактор кода VS Code;
• 1–2 часа на первую версию.

Шаг 1. Создайте бота у BotFather

В Telegram есть официальный бот для создания ботов — @BotFather.

1. Найдите @BotFather и нажмите «Start».
2. Отправьте команду /newbot.
3. Придумайте имя (как бот будет называться в чате) и username — он должен заканчиваться на bot, например kotik_helper_bot.
4. BotFather пришлёт токен — длинную строку вида 123456789:AA…. Это ключ от вашего бота.

Важно: токен — как пароль. Кто его знает, тот управляет ботом. Не отправляйте его друзьям, не выкладывайте скриншот с ним и не публикуйте код с токеном внутри.

Шаг 2. Подготовьте проект

Создайте папку my-bot, откройте её в VS Code и установите библиотеку для ботов. В терминале VS Code:

pip install pyTelegramBotAPI python-dotenv

Токен положите в отдельный файл .env (строка BOT_TOKEN=ваш_токен), а не прямо в код. Так его не получится случайно опубликовать вместе с проектом.

Шаг 3. Самый простой бот

Вот бот, который здоровается на /start и повторяет всё, что ему пишут:

import os
import telebot
from dotenv import load_dotenv

load_dotenv()  # читает BOT_TOKEN из файла .env рядом с кодом
bot = telebot.TeleBot(os.environ["BOT_TOKEN"])

@bot.message_handler(commands=["start"])
def start(message):
    bot.reply_to(message, "Привет! Я твой первый бот 🤖")

@bot.message_handler(func=lambda message: True)
def echo(message):
    bot.reply_to(message, message.text)

bot.infinity_polling()

Запустите файл, напишите своему боту в Telegram — он ответит. Поздравляем, бот работает! Пока окно с программой открыто, бот отвечает; закрыли — бот «уснул».

Шаг 4. Сделайте бота своим — с ИИ-помощником

Дальше начинается самое интересное — придумать, что будет уметь ваш бот. Здесь сильно помогает ИИ-помощник в редакторе кода: вы описываете словами, что нужно, он пишет код, вы проверяете. Такой подход называется вайбкодинг.

Идеи для первых функций:

• кнопки вместо команд («Расскажи анекдот», «Подбрось монетку»);
• бот запоминает имя собеседника;
• викторина по любимой игре или сериалу;
• бот-напоминалка о домашке.

Пример задачи помощнику: «Добавь кнопку "Подбрось монетку" — бот отвечает "Орёл" или "Решка" случайно. Токен не трогай, он в .env». После каждого изменения запускайте бота и проверяйте, что старое тоже работает.

Частые ошибки

Бот молчит? Проверьте, что программа запущена и в терминале нет красных ошибок. Частая причина — неверный токен или лишний пробел в нём в файле .env.

Ошибка «409 Conflict»? Бот запущен в двух местах одновременно (например, в двух окнах терминала). Оставьте один.

Токен случайно попал в интернет? Зайдите в @BotFather → /mybots → ваш бот → «API Token» → «Revoke current token». Старый токен перестанет работать, вставьте в .env новый.

Что дальше

Когда первый бот готов, можно научить его «думать» — подключить к нему ИИ, чтобы он отвечал на любые вопросы в своём характере, хранил историю и сам решал, что сделать. Этому посвящены наши треки «Telegram-боты: старт» и «Telegram-боты 2: бот с ИИ».

А если хочется начать с чего-то совсем простого и бесплатного — попробуйте трек «Мультики: первый шаг»: 4 задания с ИИ-напарником, установка по шагам. Подробнее о первых шагах — в статье «Программирование для детей: с чего начать».