Как создать telegram бота на python

Telegram предоставляет мощный API для автоматизации общения и интеграции с внешними сервисами. Создание бота на Python – оптимальный выбор благодаря широкому набору библиотек, таких как python-telegram-bot и aiogram, которые упрощают взаимодействие с платформой и обеспечивают асинхронную обработку запросов.

В этом руководстве мы последовательно рассмотрим все этапы: от регистрации бота через BotFather и получения токена до написания скрипта с обработчиками команд и сообщений. Особое внимание уделим структуре проекта и настройке среды разработки для обеспечения стабильной работы и масштабируемости.

Практические примеры помогут быстро понять, как обрабатывать входящие сообщения, отправлять ответы и работать с дополнительными функциями API, такими как клавиатуры и мультимедиа. В конце вы получите готовый к запуску бот с базовым функционалом и инструкциями по дальнейшему развитию.

Выбор и установка библиотеки для создания Telegram бота на Python

Для разработки Telegram бота на Python оптимально использовать специализированные библиотеки, которые упрощают работу с Telegram Bot API. Наиболее популярные и проверенные варианты:

• python-telegram-bot – полнофункциональная библиотека с поддержкой асинхронности, регулярно обновляется, подходит для проектов любого уровня сложности.
• aiogram – полностью асинхронная библиотека на основе asyncio, ориентирована на высокую производительность и масштабируемость.
• telebot (pyTelegramBotAPI) – простой и интуитивный интерфейс, хорошо подходит для быстрого старта и небольших проектов.

Рекомендуется выбирать библиотеку, ориентируясь на задачи и масштаб проекта. Для новичков и стандартных ботов подойдет python-telegram-bot, для асинхронных и ресурсоёмких решений – aiogram.

Установка любой из перечисленных библиотек производится через pip:

1. Откройте терминал или командную строку.
2. Введите команду для установки, например, для python-telegram-bot:

   pip install python-telegram-bot

3. Для aiogram команда будет:

   pip install aiogram

4. Для telebot используйте:

   pip install pyTelegramBotAPI

После установки стоит проверить версию библиотеки командой pip show [имя_библиотеки] и убедиться, что она соответствует последней стабильной версии на официальном PyPI.

Для обеспечения совместимости рекомендуется использовать виртуальное окружение Python (venv или conda), чтобы изолировать зависимости проекта и избежать конфликтов с другими пакетами.

Регистрация бота через BotFather и получение токена

Введите команду /newbot. BotFather запросит указать имя вашего бота – оно будет отображаться в списках чатов. Затем потребуется выбрать уникальное имя пользователя, оканчивающееся на bot (например, my_sample_bot). Если имя занято, BotFather сразу сообщит об ошибке, предложив альтернативы.

После успешного выбора имени BotFather сгенерирует токен доступа – строку из букв и цифр, которая служит ключом для взаимодействия с API Telegram. Скопируйте этот токен и сохраните в безопасном месте. Использовать токен следует строго конфиденциально, чтобы предотвратить несанкционированный доступ к вашему боту.

Токен понадобится для настройки кода на Python: он позволяет отправлять и получать сообщения через API Telegram. При потере или компрометации токена его можно обновить в диалоге с BotFather с помощью команды /revoke или /token.

Настройка базового скрипта для приема и обработки сообщений

Для начала установите библиотеку python-telegram-bot командой pip install python-telegram-bot. Создайте файл bot.py и импортируйте необходимые модули:

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

Инициализируйте объект приложения с токеном вашего бота, который можно получить у BotFather:

app = ApplicationBuilder().token('ВАШ_ТОКЕН').build()

Определите асинхронную функцию для обработки входящих сообщений. Например, функция, которая отвечает эхо-сообщением:

async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text(update.message.text)

Добавьте обработчик сообщений, чтобы ловить любые текстовые сообщения:

app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))

Запустите бота методом app.run_polling(), который будет постоянно опрашивать сервер Telegram для получения новых обновлений.

В итоге структура базового скрипта выглядит так:

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

app.run_polling()

Обратите внимание, что обработчики можно добавлять для различных типов обновлений, что позволяет расширять функциональность бота. Использование асинхронных функций обеспечивает быструю обработку сообщений без блокировки.

Обработка команд и текстовых сообщений в боте

Пример подключения команды:

dispatcher.add_handler(CommandHandler("start", start_handler))

Функция start_handler принимает аргументы update и context, через которые осуществляется доступ к данным сообщения и отправка ответа.

Для обработки обычных текстовых сообщений используется MessageHandler с фильтром Filters.text. Это позволяет реагировать на любой текст, кроме команд. Внутри обработчика можно реализовать логику, например, поиск ключевых слов, вызов функций или отправку динамического ответа.

Регистрация обработчика текстовых сообщений:

dispatcher.add_handler(MessageHandler(Filters.text && ~Filters.command, text_handler))

Важный момент – разделение команд и текста. Команды обрабатываются отдельными функциями, а текст – универсальным обработчиком. Это упрощает поддержку и расширение функционала.

Рекомендуется в обработчиках команд проверять context.user_data для сохранения состояния пользователя и предотвращения повторных или конфликтующих действий.

Также полезно использовать метод update.message.reply_text() для отправки ответов, так как он автоматически привязывает сообщение к диалогу с пользователем.

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

Добавление клавиатуры и интерактивных кнопок в чат

Для создания удобного интерфейса в Telegram-боте применяют встроенные клавиатуры и inline-кнопки. В библиотеке python-telegram-bot это реализуется с помощью классов ReplyKeyboardMarkup и InlineKeyboardMarkup.

Чтобы добавить обычную клавиатуру, создайте список списков с текстовыми кнопками и передайте его в ReplyKeyboardMarkup. Например:

keyboard = [[“Да”, “Нет”], [“Помощь”]]
reply_markup = ReplyKeyboardMarkup(keyboard, resize_keyboard=True)

Параметр resize_keyboard=True автоматически уменьшит размер клавиатуры под размер экрана пользователя. Для отправки сообщения с клавиатурой используйте метод bot.send_message(chat_id, text, reply_markup=reply_markup).

Inline-кнопки создаются из объектов InlineKeyboardButton, которым можно задать текст и callback_data для обработки нажатий. Они формируются в строки и передаются в InlineKeyboardMarkup. Пример:

button = InlineKeyboardButton(“Подробнее”, callback_data=“details”)
inline_kb = InlineKeyboardMarkup([[button]])

Для обработки нажатий inline-кнопок необходимо зарегистрировать обработчик callback_query, который будет реагировать на callback_data. Это позволяет динамично обновлять сообщения или выполнять действия без отправки новых сообщений.

При проектировании интерфейса клавиатуры следует учитывать ограничение Telegram: максимум 100 кнопок в одном сообщении, а для inline-клавиатур – не более 8 строк и 5 столбцов.

Рекомендуется использовать понятные подписи кнопок и минимизировать количество вариантов, чтобы не перегружать пользователя. Комбинируйте Reply и Inline клавиатуры для более гибкого взаимодействия.

Работа с API Telegram: отправка фото, документов и медиа

Для отправки файлов через Telegram API используется метод sendPhoto, sendDocument или sendMediaGroup (для группы медиа). Важно правильно формировать запросы и учитывать ограничения платформы.

with open('path/to/photo.jpg', 'rb') as photo:
bot.send_photo(chat_id=chat_id, photo=photo)

bot.send_photo(chat_id=chat_id, photo='https://example.com/image.jpg')

media = [
InputMediaPhoto(open('img1.jpg', 'rb'), caption='Фото 1'),
InputMediaPhoto(open('img2.jpg', 'rb'))
]
bot.send_media_group(chat_id=chat_id, media=media)

[Unit]
Description=Telegram Bot Service
After=network.target
[Service]
User=ubuntu
WorkingDirectory=/home/ubuntu/bot
ExecStart=/home/ubuntu/bot/venv/bin/python bot.py
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl start telegrambot.service
sudo systemctl enable telegrambot.service

journalctl -u telegrambot.service -f

sudo systemctl restart telegrambot.service

0 3 * * * ubuntu tar czf /home/ubuntu/backups/bot_$(date +\%F).tar.gz /home/ubuntu/bot