Вы когда-нибудь хотели создать бота, который сам отвечает на сообщения, присылает погоду по запросу или напоминает о важных делах? Telegram-боты — это не только удобно, но и отличный способ погрузиться в мир программирования на Python. И да, написать своего первого бота реально меньше чем за час. В этом руководстве я проведу вас через весь процесс — от регистрации бота у BotFather до запуска готового кода, который реагирует на команды и даже использует кнопки.
Что нужно для создания бота
Всё, что потребуется:
- Аккаунт в Telegram — разумеется, он у вас уже есть.
- Python версии 3.8 или выше — язык, на котором мы будем писать .
- Библиотека pyTelegramBotAPI (telebot) — самая простая и дружелюбная для новичков .
- Текстовый редактор — подойдёт любой: VS Code, PyCharm, даже обычный Блокнот.
Никаких сложных настроек сервера не потребуется. Бот будет работать на вашем компьютере через технологию Long Polling — это когда программа сама постоянно спрашивает Telegram: «Мне кто-нибудь написал?». Для первого бота этого более чем достаточно .
Регистрируем бота у BotFather
Первый шаг — создать самого бота в Telegram. Этим занимается специальный бот — BotFather.
- Откройте Telegram и найдите в поиске @BotFather.
- Нажмите «Запустить» (или отправьте команду
/start). - Отправьте команду
/newbot— BotFather попросит придумать имя для бота и его username .
- Имя может быть любым, например «Мой первый бот». Оно будет отображаться в чате.
- Username — уникальный идентификатор, который должен заканчиваться на
bot, напримерmy_first_test_bot.
- Если имя не занято, 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 и др.) есть в документации .
Что делать, если бот не отвечает?
- Проверьте, не запущен ли бот (терминал открыт?).
- Убедитесь, что токен правильный.
- Проверьте порядок обработчиков — универсальный
func=lambda message: Trueдолжен быть последним. - Посмотрите на ошибки в терминале — они часто указывают на проблему.
Безопасно ли хранить токен прямо в коде?
Нет. Для реальных проектов используйте переменные окружения. Создайте файл .env и библиотеку python-dotenv, чтобы токен не попадал в систему контроля версий .
Краткие выводы
За полчаса вы написали своего первого Telegram-бота на Python. Это отличный старт — теперь вы знаете основы, на которых можно строить что угодно: от бота-погоды до помощника по учёбе или интеграции с внешними API.
Что нужно запомнить:
- BotFather — ваш первый друг. Он создаёт ботов и выдаёт токены.
- Библиотека
pyTelegramBotAPI— самый простой способ начать. Установка одной командой:pip install pyTelegramBotAPI. - Декораторы
@bot.message_handler— сердце бота. Они определяют, на какие команды и сообщения реагировать. bot.infinity_polling()— запускает бота в режиме ожидания сообщений.register_next_step_handlerпозволяет создавать пошаговые диалоги.- Всегда обрабатывайте ошибки и добавляйте логирование — это сэкономит часы отладки.
Для углублённого изучения рекомендую наши статьи:
- «Языки программирования: какой выбрать новичку?» — если хотите разобраться, с какого языка начинать путь в IT.
- «Как создать свой сайт для бизнеса» — боты часто интегрируются с веб-сервисами, и понимание веб-разработки будет плюсом.
- «Основы JavaScript: добавление интерактивности на сайт» — полезно, если захотите добавить веб-интерфейс для вашего бота.
Теперь ваша очередь — запустите своего первого бота и подумайте, какую полезную функцию вы могли бы в него добавить. Удачи в кодинге!









