Хотите автоматизировать рутину, настроить уведомления или запустить простой сервис прямо в мессенджере? Всё это реально сделать самостоятельно. Написать Telegram-бот на Python можно даже без большого опыта в программировании: достаточно базового знания языка и чёткой последовательности шагов.
По данным Statista, Telegram насчитывает более 950 миллионов активных пользователей в месяц. Это делает платформу одной из самых привлекательных для разработки автоматизированных сервисов.
Это руководство для начинающих пригодится тем, кто осваивает Python и ищет практическую задачу для закрепления навыков, а также всем, кто хочет быстро получить рабочий инструмент в Telegram без погружения в сложные фреймворки.
Что такое Telegram Bot API и как он работает
Каждый бот в Telegram — это обычный аккаунт, которым управляет программа, а не человек. Между вашим скриптом и серверами мессенджера стоит официальный API: через него бот получает сообщения, отвечает и выполняет команды.
Взаимодействие происходит по одной из двух схем. Первая — Long Polling: ваш скрипт сам регулярно спрашивает у сервера «есть ли новые сообщения?» и получает ответ. Вторая — Webhook: сервер Telegram сам присылает уведомление на ваш адрес, как только пользователь что-то написал. Для начала удобнее Long Polling — он не требует публичного IP и SSL-сертификата.
Telegram Bot API бесплатен для любого использования: личного, образовательного, коммерческого. Документация доступна по адресу core.telegram.org/bots/api.
Каждый запрос к API отправляется по HTTPS на адрес вида https://api.telegram.org/bot/метод. Токен — уникальный идентификатор вашего бота, который выдаёт специальный сервис Telegram — BotFather.
Напрямую работать с HTTP-запросами трудоёмко: нужно вручную обрабатывать JSON и следить за форматом данных. Поэтому на практике используют библиотеку-обёртку, которая берёт рутину на себя.
Что нужно знать перед написанием кода
Прежде чем открывать редактор, стоит разобраться с несколькими понятиями. Это не займет много времени, но избавит вас от путаницы при чтении документации и чужого кода.
Бот в Telegram — не отдельное приложение и не сайт. Это аккаунт с особым статусом: он не может сам начинать переписку, не видит чужие сообщения в группе (если его туда не добавили) и всегда работает через официальный API. Пользователь пишет в чат — сервер Telegram фиксирует событие и передает его вашему скрипту.
Каждое такое событие называется Update. Внутри него может быть текстовое сообщение, нажатие кнопки, голосовое сообщение, платёж или системное уведомление. Ваш скрипт решает, как реагировать на каждый тип события — это и называется обработчиком.
Команды — это сообщения, начинающиеся с косой черты: /start, /help, /settings. Telegram выделяет их синим цветом и делает кликабельными. Именно с команды /start принято начинать диалог: она срабатывает при первом открытии бота или после нажатия кнопки «Запустить».
Чем чётче продумана логика до написания кода, тем меньше правок потребуется после. Набросайте на бумаге: какие команды поддерживает бот, что он делает с обычным текстом, как реагирует на неизвестный запрос.
Еще одно важное разграничение — синхронный и асинхронный код. Актуальная версия библиотеки python-telegram-bot работает на asyncio: функции-обработчики объявляются с ключевым словом async, а внутри используется await.
Это не усложняет логику, но требует понимания: обычный синхронный вызов внутри async-функции может заблокировать всего бота — он перестанет отвечать остальным пользователям, пока текущая операция не завершится. Поэтому любые «долгие» действия — запросы к внешним сервисам, работа с файлами — выполняются асинхронно или в отдельном потоке.
Выбор библиотеки для Python
Для разработки на Python существует несколько популярных инструментов. Выбор зависит от уровня опыта и задач: одни библиотеки проще в старте, другие лучше подходят для продакшена.
| Библиотека | Стиль работы | Когда выбрать |
|---|---|---|
| python-telegram-bot | Синхронный/асинхронный (v20+) | Первый проект, чистая документация, большое комьюнити |
| aiogram | Только асинхронный (asyncio) | Когда нужна производительность и поддержка сложной логики |
| pyTelegramBotAPI (telebot) | Синхронный | Простые боты, минимум зависимостей |
В этом руководстве используется python-telegram-bot версии 20+: она хорошо документирована, активно обновляется и работает как синхронно, так и асинхронно. Для начинающего это оптимальный выбор.
Не используйте версию python-telegram-bot ниже 20.x — там другой синтаксис, и примеры из старых статей не подойдут.
Регистрация бота через BotFather
Прежде чем писать код, нужно зарегистрировать бота в Telegram. За это отвечает официальный сервис — @BotFather. Процесс занимает меньше двух минут.
- Откройте Telegram и найдите @BotFather через строку поиска.
- Отправьте команду /newbot.
- Введите имя бота (отображается в чате, например «Мой первый бот»).
- Укажите username — латиницей, обязательно заканчивается на «bot» (например my_first_helper_bot).
- Сохраните токен, который пришлёт BotFather — он выглядит как «1234567890:ABCdef…». Никому не передавайте его.
Токен — это единственный ключ к вашему боту. Если он попадёт к посторонним, бот окажется под чужим контролем. Храните его в переменных окружения, а не в коде.
После регистрации бот уже существует в Telegram, но ни на что не реагирует — пока вы не запустите свой скрипт.
Как создать Telegram-бота на Python: пишем код
Это центральный раздел: здесь вы напишете первый рабочий бот с нуля. Все шаги последовательны — выполняйте их по порядку.
Установка окружения
Проверьте, установлен ли Python версии 3.10 или выше: откройте терминал и введите python --version. Затем создайте виртуальное окружение и установите библиотеку:
Виртуальное окружение изолирует зависимости проекта — это хорошая практика, которая спасает от конфликтов между пакетами.
Структура скрипта
Создайте файл bot.py. Базовый скрипт состоит из четырёх частей: импорт библиотеки, объявление токена, описание обработчиков и запуск поллинга.
Этот бот реагирует на команду /start приветствием и возвращает любое текстовое сообщение обратно. Именно с такого «эхо-бота» начинают большинство разработчиков.
Запуск и первая проверка
Задайте переменную окружения и запустите скрипт:
Откройте Telegram, найдите своего бота по username и отправьте /start. Если всё верно — он ответит сразу. Поздравляем: разработка первого бота завершена.
✅Бот работает, пока запущен скрипт. Закроете терминал — бот перестанет отвечать. Для постоянной работы нужен сервер (об этом — в следующем разделе).
Частые ошибки при первом запуске
Большинство проблем на старте связаны с несколькими типовыми причинами. Разберём их — это сэкономит час отладки.
-
Токен указан прямо в коде — если файл попадёт в публичный репозиторий, бот скомпрометирован. Всегда используйте переменные окружения или файл .env.
-
Версия python-telegram-bot ниже 20.x — синтаксис v13 и v20 несовместимы. Проверьте: pip show python-telegram-bot.
-
Запущено несколько экземпляров бота одновременно — возникает конфликт при получении обновлений. Перед повторным запуском убедитесь, что предыдущий процесс завершён.
-
Python 3.9 и ниже — библиотека в версии 20.x требует Python 3.10+. Обновите интерпретатор.
-
Бот не отвечает на сообщения — скорее всего, не добавлен MessageHandler или неверно указан фильтр. Перепроверьте, что обработчик зарегистрирован через app.add_handler().
Если бот молчит, но ошибок в терминале нет — включите логирование: добавьте logging.basicConfig(level=logging.DEBUG) в начало скрипта.
Ещё одна распространённая ситуация: в чате бот не реагирует на обычный текст, только на команды. Это значит, что MessageHandler не добавлен или в фильтре указано только filters.COMMAND. Добавьте отдельный обработчик для filters.TEXT.
Безопасность и хранение токена
Токен бота — это аналог пароля. Одна утечка означает, что посторонний получит полный контроль: сможет читать входящие сообщения, рассылать что угодно от имени бота и изменять его настройки. Это не теоретическая угроза: публичные репозитории на GitHub регулярно сканируются автоматическими системами именно в поисках токенов и ключей API.
Самый распространенный способ защиты — переменные окружения. Токен задается на уровне операционной системы или сервера, а скрипт считывает его через os.environ.get(). При этом токен не попадает в код и систему контроля версий.
Для локальной разработки удобнее использовать файл .env в корне проекта. В нём одна строка: TG_TOKEN=ваш_токен. Библиотека python-dotenv автоматически загружает этот файл при запуске. Главное — добавить .env в .gitignore сразу, до первого коммита.
❗Если токен все же попал в публичный репозиторий, немедленно отмените его. Откройте @BotFather, отправьте /revoke и выберите нужного бота. Старый токен перестанет работать, а новый нужно будет прописать в настройках.
Помимо хранения токена, стоит учесть еще два момента. Первый — фильтрация входящих данных. Пользователи могут отправлять что угодно: очень длинный текст, специальные символы, попытки передать команду в виде обычного сообщения. Задайте ограничения на длину и тип обрабатываемых данных еще на уровне обработчиков.
Второй момент — ограничение доступа. Если бот выполняет конфиденциальные действия (например, управляет сервером или отправляет уведомления с личными данными), проверяйте user_id отправителя и отвечайте только доверенным пользователям.
В программировании принято разделять конфигурацию и логику с самого начала работы над проектом — даже если бот пока только учебный. Эта привычка экономит время при переносе скрипта на сервер и защищает от случайных ошибок.
Что делать дальше: развитие бота
Базовый бот на Python — это отправная точка. Дальше разработка идёт в нескольких направлениях, и каждое открывает новые возможности в программировании.
Кнопки и клавиатуры
Telegram поддерживает два типа кнопок: InlineKeyboardButton (прикреплены к сообщению) и ReplyKeyboardMarkup (замещают стандартную клавиатуру).
Добавьте кнопку к ответу на /start — и бот станет интерактивным за 5 строк кода.
Работа с базой данных
Для хранения данных пользователей подойдёт SQLite через встроенный модуль sqlite3 или небольшая ORM — например, Peewee. Это позволяет боту помнить настройки и историю чата между сессиями.
Деплой на сервер
Чтобы бот работал круглосуточно без вашего компьютера, перенесите скрипт на VPS. Простейший вариант — запустить как systemd-службу в Linux. Для небольших проектов подойдёт бесплатный тариф на Railway или Fly.io.
Переходите к Webhook только когда у вас есть домен и SSL-сертификат. Для тестирования и несложных проектов Long Polling вполне достаточен.
Параллельно стоит изучить API сторонних сервисов — погоды, курсов валют, расписания — и интегрировать их через запросы к внешним источникам данных. Так бот из учебного упражнения превращается в полноценный инструмент.
Итог
Создать рабочий Telegram-бот на Python — реально за один вечер. Вы зарегистрировали его через BotFather, написали обработчики, запустили поллинг и получили первый ответ в чате. Это полноценный старт в разработке на Python с осязаемым результатом.
Дальнейший путь строится поэтапно: сначала кнопки и диалоги, потом работа с данными, затем деплой. Не пытайтесь сразу охватить всё — каждый новый функционал добавляйте постепенно и проверяйте в живом чате.
Главное руководство в программировании — работающий код. Вы его уже написали. Теперь — расширяйте.
Хотите попробовать работу фрилансером на дому или ищете, где заказать скрипты под свои задачи? На Work24 есть всё!
Комментарии