Создание простого телеграм-бота с использованием библиотеки python-telegram-bot

Шаг 1: Установка библиотеки

Первое, что нам нужно сделать, это установить библиотеку python-telegram-bot. Для этого откройте терминал и выполните следующую команду:

pip install python-telegram-bot

Шаг 2: Создание бота в Telegram

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

1. Откройте Telegram и найдите бота BotFather.
2. Отправьте команду /start, чтобы начать взаимодействие с BotFather.
3. Отправьте команду /newbot, чтобы создать нового бота.
4. Следуйте инструкциям, чтобы задать имя и юзернейм вашему боту.
5. В конце процесса вы получите токен доступа, который понадобится нам для работы с API.

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

Теперь, когда у нас есть токен доступа, мы можем перейти к написанию кода. Создайте новый файл, например bot.py, и напишите в него следующий код:

from telegram import Update
from telegram.ext import Updater, CommandHandler, MessageHandler, Filters, CallbackContext

# Замените 'YOUR_TOKEN_HERE' на токен вашего бота
TOKEN = 'YOUR_TOKEN_HERE'

def start(update: Update, context: CallbackContext) -> None:
    update.message.reply_text('Привет! Я ваш новый телеграм-бот. Как я могу помочь?')

def echo(update: Update, context: CallbackContext) -> None:
    update.message.reply_text(update.message.text)

def main():
    # Создаем экземпляр Updater и передаем ему токен вашего бота.
    updater = Updater(TOKEN)

    # Получаем диспетчера для регистрации обработчиков
    dispatcher = updater.dispatcher

    # Регистрируем обработчик команды /start
    dispatcher.add_handler(CommandHandler("start", start))

    # Регистрируем обработчик текстовых сообщений
    dispatcher.add_handler(MessageHandler(Filters.text & ~Filters.command, echo))

    # Запускаем бота
    updater.start_polling()

    # Останавливаем бота при завершении работы
    updater.idle()

if __name__ == '__main__':
    main()

Давайте разберем этот код более подробно.

Импорт необходимых модулей

from telegram import Update
from telegram.ext import Updater, CommandHandler, MessageHandler, Filters, CallbackContext

Мы импортируем необходимые модули из библиотеки python-telegram-bot.

Определение токена

TOKEN = 'YOUR_TOKEN_HERE'

Замените 'YOUR_TOKEN_HERE' на токен вашего бота, который вы получили от BotFather.

Обработчик команды /start

def start(update: Update, context: CallbackContext) -> None:
    update.message.reply_text('Привет! Я ваш новый телеграм-бот. Как я могу помочь?')

Этот обработчик будет отвечать на команду /start приветственным сообщением.

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

def echo(update: Update, context: CallbackContext) -> None:
    update.message.reply_text(update.message.text)

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

Основная функция

def main():
    # Создаем экземпляр Updater и передаем ему токен вашего бота.
    updater = Updater(TOKEN)

    # Получаем диспетчера для регистрации обработчиков
    dispatcher = updater.dispatcher

    # Регистрируем обработчик команды /start
    dispatcher.add_handler(CommandHandler("start", start))

    # Регистрируем обработчик текстовых сообщений
    dispatcher.add_handler(MessageHandler(Filters.text & ~Filters.command, echo))

    # Запускаем бота
    updater.start_polling()

    # Останавливаем бота при завершении работы
    updater.idle()

В этой функции мы создаем экземпляр Updater, регистрируем обработчики команд и сообщений, запускаем бота и ждем завершения работы.

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

Чтобы запустить вашего бота, выполните следующую команду в терминале:

python bot.py

Теперь ваш бот запущен и готов к работе! Вы можете открыть Telegram, найти вашего бота и отправить команду /start, чтобы протестировать его.

Заключение

Поздравляю! Теперь у вас есть простой телеграм-бот, который отвечает на команду /start и повторяет любые текстовые сообщения. Это только начало, и вы можете продолжать развивать вашего бота, добавляя новые команды и функции. Удачи в ваших начинаниях!