Создание бота в Telegram с использованием Python — это увлекательный и относительно простой процесс. В этом руководстве мы рассмотрим все этапы, от регистрации бота до написания базового функционала.

Шаг 1⁚ Регистрация бота в BotFather

Прежде всего, вам необходимо зарегистрировать своего бота в Telegram. Для этого найдите в Telegram бота BotFather и начните с ним диалог.

1. Введите команду /newbot.
2. BotFather попросит вас придумать имя для вашего бота (отображается пользователям). Выберите запоминающееся имя.
3. Затем BotFather попросит придумать username для вашего бота (уникальное имя, заканчивающееся на “bot”). Это имя будет использоваться в URL-адресе вашего бота (например, @my_super_bot).
4. После успешной регистрации BotFather предоставит вам токен API. Запомните этот токен! Он является ключом доступа к вашему боту, и его потеря может привести к невозможности управления ботом. Храните его в надежном месте, например, в файле .env.

Шаг 2⁚ Установка необходимых библиотек

Для работы с Telegram Bot API в Python используется библиотека python-telegram-bot. Установите ее с помощью pip⁚

pip install python-telegram-bot

Шаг 3⁚ Написание кода бота

Создайте файл bot.py и вставьте следующий код⁚

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

# Замените YOUR_BOT_TOKEN на ваш токен API
BOT_TOKEN = “YOUR_BOT_TOKEN”

logging.basicConfig(
format=%(asctime)s ⸺ %(name)s ⸺ %(levelname)s ⎯ %(message)s,
level=logging.INFO
)

async def start(update⁚ Update, context⁚ ContextTypes.DEFAULT_TYPE)⁚
await context.bot.send_message(chat_id=update.effective_chat.id, text=”Привет! Я бот.”)

async def echo(update⁚ Update, context⁚ ContextTypes.DEFAULT_TYPE)⁚
await context.bot.send_message(chat_id=update.effective_chat.id, text=update.message.text)

if __name__ == __main__⁚
application = ApplicationBuilder.token(BOT_TOKEN).build
start_handler = CommandHandler(start, start)
echo_handler = MessageHandler(filters.TEXT & (~filters.COMMAND), echo)
application.add_handler(start_handler)
application.add_handler(echo_handler)
application.run_polling

Этот код создает простого бота, который отвечает на команду /start и эхом повторяет все текстовые сообщения.

Шаг 4⁚ Запуск бота

Замените YOUR_BOT_TOKEN на ваш токен API и запустите скрипт⁚

python bot.py

Ваш бот теперь должен быть запущен и готов к работе. Попробуйте отправить ему команду /start и несколько текстовых сообщений.

Расширение функциональности

Этот базовый пример можно расширить, добавив обработчики для других команд, использование кнопок, работу с базами данных и многое другое. Библиотека python-telegram-bot предоставляет обширные возможности для создания сложных и функциональных ботов.

Создание Telegram-бота на Python — это доступный и увлекательный процесс. Начните с этого базового примера и постепенно добавляйте новые функции, чтобы создать бота, который будет соответствовать вашим потребностям.

Работа с обновлениями (Updates)

Сердцем любого Telegram-бота является обработка обновлений (Updates). Telegram отправляет боту обновления, когда происходит какое-либо событие, например, пользователь отправляет сообщение, нажимает кнопку или выполняет другое действие. Библиотека python-telegram-bot предоставляет удобный способ обработки этих обновлений.

В предыдущем примере мы использовали CommandHandler и MessageHandler для обработки команд и текстовых сообщений соответственно. Давайте рассмотрим более сложный пример, где мы будем обрабатывать различные типы обновлений⁚

python
import logging
from telegram import Update, ForceReply, InlineKeyboardButton, InlineKeyboardMarkup
from telegram.ext import ApplicationBuilder, ContextTypes, CommandHandler, MessageHandler, filters, CallbackQueryHandler
# … (токен и конфигурация логирования как в предыдущем примере) …

async def start(update⁚ Update, context⁚ ContextTypes.DEFAULT_TYPE)⁚
user = update.effective_user
await update.message.reply_html(
rf”Привет, {user.mention_html}! Выберите действие⁚”,
reply_markup=InlineKeyboardMarkup([
[InlineKeyboardButton(“Получить информацию”, callback_data=”info”)],
[InlineKeyboardButton(“Выполнить действие”, callback_data=”action”)]
])
)

async def button_handler(update⁚ Update, context⁚ ContextTypes.DEFAULT_TYPE)⁚
query = update.callback_query
await query.answer
if query.data == “info”⁚
await query.edit_message_text(text=”Это информация!”)
elif query.data == “action”⁚
await query.edit_message_text(text=”Действие выполнено!”)

async def unknown(update⁚ Update, context⁚ ContextTypes.DEFAULT_TYPE)⁚
await context.bot.send_message(chat_id=update.effective_chat.id, text=”Извините, я не понимаю эту команду.”)

if __name__ == __main__⁚
application = ApplicationBuilder.token(BOT_TOKEN).build
start_handler = CommandHandler(start, start)
button_handler = CallbackQueryHandler(button_handler)
unknown_handler = MessageHandler(filters.TEXT & (~filters.COMMAND), unknown)
application.add_handler(start_handler)
application.add_handler(button_handler)
application.add_handler(unknown_handler)
application.run_polling

Inline-кнопки и CallbackQueryHandler

В этом примере мы используем InlineKeyboardMarkup для создания inline-кнопок. CallbackQueryHandler обрабатывает нажатия на эти кнопки. Обратите внимание на использование callback_data для идентификации нажатой кнопки.

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

Функция unknown обрабатывает сообщения, которые не являються ни командами, ни нажатиями на кнопки. Это полезно для создания более отзывчивого бота.

Более продвинутые возможности

Это лишь базовый пример. Библиотека python-telegram-bot поддерживает множество других функций, включая⁚

• Отправку различных типов сообщений (фото, видео, аудио, документы и т.д.)
• Использование клавиатур (reply keyboards)
• Работа с группами и каналами
• Использование вебхуков для обработки обновлений
• Интеграцию с другими сервисами (например, базами данных)

Для более подробной информации обратитесь к официальной документации библиотеки python-telegram-bot.

Развертывание бота

После того, как вы написали и протестировали своего бота, вам потребуется развернуть его на сервере, чтобы он работал постоянно. Существует множество платформ для развертывания, таких как Heroku, PythonAnywhere, Google Cloud Platform и другие. Выбор платформы зависит от ваших потребностей и бюджета.