TechTrendForge
IT

Как написать свой первый Telegram-бот на Python за 30 минут

Как написать свой первый Telegram-бот на Python за 30 минут

Вы когда-нибудь хотели создать бота, который сам отвечает на сообщения, присылает погоду по запросу или напоминает о важных делах? Telegram-боты — это не только удобно, но и отличный способ погрузиться в мир программирования на Python. И да, написать своего первого бота реально меньше чем за час. В этом руководстве я проведу вас через весь процесс — от регистрации бота у BotFather до запуска готового кода, который реагирует на команды и даже использует кнопки.

Что нужно для создания бота

Всё, что потребуется:

  • Аккаунт в Telegram — разумеется, он у вас уже есть.
  • Python версии 3.8 или выше — язык, на котором мы будем писать .
  • Библиотека pyTelegramBotAPI (telebot) — самая простая и дружелюбная для новичков .
  • Текстовый редактор — подойдёт любой: VS Code, PyCharm, даже обычный Блокнот.

Никаких сложных настроек сервера не потребуется. Бот будет работать на вашем компьютере через технологию Long Polling — это когда программа сама постоянно спрашивает Telegram: «Мне кто-нибудь написал?». Для первого бота этого более чем достаточно .

Регистрируем бота у BotFather

Первый шаг — создать самого бота в Telegram. Этим занимается специальный бот — BotFather.

  1. Откройте Telegram и найдите в поиске @BotFather.
  2. Нажмите «Запустить» (или отправьте команду /start).
  3. Отправьте команду /newbot — BotFather попросит придумать имя для бота и его username .
  • Имя может быть любым, например «Мой первый бот». Оно будет отображаться в чате.
  • Username — уникальный идентификатор, который должен заканчиваться на bot, например my_first_test_bot.
  1. Если имя не занято, BotFather поздравит вас и пришлёт токен — длинную строку, похожую на 1234567890:ABCdefGHIjklmNOPqrsTUVwxyz. Сохраните его. Это ключ доступа к вашему боту, никому его не отдавайте .

Поздравляю! Бот создан. Сейчас он существует, но пока не умеет отвечать. Исправим это.

Готовим окружение: Python и библиотека

Если Python ещё не установлен, скачайте его с официального сайта python.org. При установке обязательно отметьте галочку «Add Python to PATH» — это важно для работы из командной строки.

Теперь установим библиотеку pyTelegramBotAPI. Откройте терминал (командную строку) и выполните:

pip install pyTelegramBotAPI

Если вы работаете на Linux или macOS, может потребоваться pip3. Готово — библиотека установлена .

Пишем первого бота: эхо-бот

Создайте файл с расширением .py, например my_first_bot.py, и откройте его в редакторе.

Шаг 1. Импортируем библиотеку и подключаем токен

import telebot

TOKEN = 'ВАШ_ТОКЕН_СЮДА'
bot = telebot.TeleBot(TOKEN)

Вставьте токен, который вы получили от BotFather, вместо ВАШ_ТОКЕН_СЮДА .

Шаг 2. Пишем обработчик команд

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

@bot.message_handler(commands=['start'])
def send_welcome(message):
bot.reply_to(message, "Привет! Я твой первый бот. Просто напиши мне что-нибудь.")

Декоратор @bot.message_handler(commands=['start']) говорит: «Эту функцию вызывать, когда придёт команда /start».

Шаг 3. Пишем обработчик для любых текстовых сообщений (эхо)

Добавим функцию, которая будет отвечать тем же текстом, что и пользователь:

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

Здесь func=lambda message: True означает, что функция будет обрабатывать все текстовые сообщения без исключений .

Шаг 4. Запускаем бота

В конце файла добавьте строку для запуска:

bot.infinity_polling()

infinity_polling() — это метод, который постоянно опрашивает серверы Telegram на наличие новых сообщений. Как только что-то приходит, он передаёт это нашим обработчикам .

Весь код целиком:

import telebot

TOKEN = 'ВАШ_ТОКЕН_СЮДА'
bot = telebot.TeleBot(TOKEN)

@bot.message_handler(commands=['start'])
def send_welcome(message):
bot.reply_to(message, "Привет! Я твой первый бот. Просто напиши мне что-нибудь.")

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

bot.infinity_polling()

Запускаем бота

Всё готово к запуску. В терминале (командной строке) перейдите в папку, где лежит ваш файл, и выполните:

python my_first_bot.py

или

python3 my_first_bot.py

Если всё сделано правильно, вы увидите… ничего. Программа просто запустится и будет ждать сообщений. Теперь откройте Telegram, найдите своего бота по username и напишите ему что-нибудь. Он должен ответить тем же текстом .

Для остановки бота нажмите Ctrl + C в терминале.

Добавляем команды /start и /help

Сделаем бота полезнее — добавим команду /help, которая будет рассказывать, что умеет бот, и доработаем /start.

import telebot

TOKEN = 'ВАШ_ТОКЕН_СЮДА'
bot = telebot.TeleBot(TOKEN)

@bot.message_handler(commands=['start'])
def send_welcome(message):
bot.reply_to(message, "Привет! Я бот-помощник. Используй /help, чтобы узнать, что я умею.")

@bot.message_handler(commands=['help'])
def send_help(message):
help_text = "Я умею:\n- Отвечать на команды /start и /help\n- Повторять за тобой (эхо)\n- Скоро научусь большему!"
bot.reply_to(message, help_text)

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

bot.infinity_polling()

Обратите внимание: порядок объявления обработчиков важен. Обработчик func=lambda message: True стоит последним, потому что он ловит все сообщения. Если бы мы поставили его первым, команды /start и /help никогда бы не сработали — их бы перехватил эхо-бот .

Создаём кнопки для удобного взаимодействия

Текстовые команды — это хорошо, но кнопки делают общение с ботом намного удобнее. Добавим клавиатуру с кнопками под сообщением.

Для начала импортируем types:

from telebot import types

Теперь добавим команду /menu, которая покажет кнопки:

@bot.message_handler(commands=['menu'])
def show_menu(message):
# Создаём клавиатуру
keyboard = types.InlineKeyboardMarkup()

# Создаём кнопки
btn_yes = types.InlineKeyboardButton(text='Да', callback_data='yes')
btn_no = types.InlineKeyboardButton(text='Нет', callback_data='no')

# Добавляем кнопки на клавиатуру
keyboard.add(btn_yes, btn_no)

bot.send_message(message.chat.id, "Вам нравится программировать?", reply_markup=keyboard)

Здесь callback_data — это данные, которые вернутся боту, когда пользователь нажмёт кнопку .

Теперь нужно обработать нажатие кнопки:

@bot.callback_query_handler(func=lambda call: True)
def handle_callback(call):
if call.data == 'yes':
bot.send_message(call.message.chat.id, "Отлично! Программирование - это здорово!")
elif call.data == 'no':
bot.send_message(call.message.chat.id, "Ничего страшного, у каждого свои увлечения.")

Метод callback_query_handler перехватывает нажатия на кнопки. func=lambda call: True означает, что мы обрабатываем все нажатия .

Машина состояний: пошаговые диалоги

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

Для таких сценариев используется машина состояний. В pyTelegramBotAPI за это отвечает метод register_next_step_handler. Он говорит: «После того как пользователь ответит на это сообщение, передай его ответ в указанную функцию».

Пример — опросник, который спрашивает имя, а потом возраст:

@bot.message_handler(commands=['survey'])
def start_survey(message):
msg = bot.send_message(message.chat.id, "Как тебя зовут?")
bot.register_next_step_handler(msg, ask_age)

def ask_age(message):
user_name = message.text
msg = bot.send_message(message.chat.id, f"Приятно познакомиться, {user_name}! Сколько тебе лет?")
bot.register_next_step_handler(msg, finish_survey, user_name)

def finish_survey(message, user_name):
try:
age = int(message.text)
bot.send_message(message.chat.id, f"Спасибо, {user_name}! Тебе {age} лет. Данные сохранены.")
except ValueError:
bot.send_message(message.chat.id, "Пожалуйста, введи возраст числом. Попробуй ещё раз через /survey.")

Здесь register_next_step_handler передаёт следующее сообщение пользователя в указанную функцию. А finish_survey получает дополнительный параметр user_name — это удобно для передачи данных между шагами .

Для сложных сценариев (больше 3-4 шагов) лучше использовать специальные библиотеки для FSM, такие как aiogram, но для простых опросов register_next_step_handler вполне достаточно.

Логирование и обработка ошибок

Когда бот работает, полезно видеть, что происходит внутри. Добавим простейшее логирование:

import logging

logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')
logger = logging.getLogger(__name__)

# В начале функции обработки:
logger.info(f"Получено сообщение от {message.from_user.id}: {message.text}")

Это поможет отслеживать, какие сообщения приходят, и при ошибках быстрее находить причину .

Также важно оборачивать потенциально опасные участки кода в try-except. Например, при парсинге чисел из сообщений:

try:
age = int(message.text)
except ValueError:
bot.send_message(message.chat.id, "Введи число, пожалуйста.")
return

Часто задаваемые вопросы (FAQ)

Какая библиотека лучше: telebot или aiogram?

Для первого бота и простых задач — однозначно telebot. Она проще, код короче, документация понятнее. aiogram мощнее и быстрее (асинхронный), но сложнее в освоении .

Можно ли запустить бота на хостинге, чтобы он работал 24/7?

Да. Самый простой способ для начала — бесплатные облачные серверы вроде Render.com, Railway.app или PythonAnywhere. Потребуется настроить вебхуки вместо Long Polling .

Как бот запоминает данные пользователей?

Для хранения данных можно использовать:

  • Словарь в памяти (проще всего, но при перезапуске бота данные теряются)
  • JSON-файл (подходит для небольших объёмов)
  • Базу данных (SQLite, PostgreSQL) — для серьёзных проектов

Как отправить боту фото или документ?

Тип сообщения определяется через message.content_type. Пример обработки фото:

@bot.message_handler(content_types=['photo'])
def handle_photo(message):
bot.reply_to(message, "Красивое фото!")

Список всех типов (text, audio, document, photo, sticker и др.) есть в документации .

Что делать, если бот не отвечает?

  1. Проверьте, не запущен ли бот (терминал открыт?).
  2. Убедитесь, что токен правильный.
  3. Проверьте порядок обработчиков — универсальный func=lambda message: True должен быть последним.
  4. Посмотрите на ошибки в терминале — они часто указывают на проблему.

Безопасно ли хранить токен прямо в коде?

Нет. Для реальных проектов используйте переменные окружения. Создайте файл .env и библиотеку python-dotenv, чтобы токен не попадал в систему контроля версий .

Краткие выводы

За полчаса вы написали своего первого Telegram-бота на Python. Это отличный старт — теперь вы знаете основы, на которых можно строить что угодно: от бота-погоды до помощника по учёбе или интеграции с внешними API.

Что нужно запомнить:

  1. BotFather — ваш первый друг. Он создаёт ботов и выдаёт токены.
  2. Библиотека pyTelegramBotAPI — самый простой способ начать. Установка одной командой: pip install pyTelegramBotAPI.
  3. Декораторы @bot.message_handler — сердце бота. Они определяют, на какие команды и сообщения реагировать.
  4. bot.infinity_polling() — запускает бота в режиме ожидания сообщений.
  5. register_next_step_handler позволяет создавать пошаговые диалоги.
  6. Всегда обрабатывайте ошибки и добавляйте логирование — это сэкономит часы отладки.

Для углублённого изучения рекомендую наши статьи:

Теперь ваша очередь — запустите своего первого бота и подумайте, какую полезную функцию вы могли бы в него добавить. Удачи в кодинге!


Популярное на сайте

  1. Как включить тёмную тему в Windows 11 и Windows 10 в 2026 году: все способы IT · 14 мин
  2. Как активировать Windows бесплатно: легальные способы и жизнь без активации Windows · 17 мин
  3. Лучшие сборки Windows в 2026 году: рейтинг, риски и честный обзор Windows · 11 мин
  4. Как очистить компьютер от мусора в Windows 11 и 10 без риска для файлов Оптимизация ПК · 15 мин
  5. Лучшие дистрибутивы Linux 2026: полный гид по выбору системы для любых задач Linux · 14 мин
  6. Как удалить вирусы на ПК: полное руководство по лечению Windows 10 и 11 в 2026 году ИТ-Безопасность · 14 мин