Телеграм бот на Python: обзор основных библиотек

Как создать телеграм бота практически с неограниченным функционалом. Если вы знаете Python — то это будет несложно!

Содержание

Какую библиотеку выбрать?

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

Если вам нужно что-то простое с несколькими хэндлерами и вы не хотите тратить много времени на изучение, то можно использовать библиотеку python-telegram-bot. У нее есть подробная документация, сниппеты кода и она поддерживает асинхронность с помощью декоратора @run_async.

Вы также можете запустить сервер без сервера на платформах Azure, Google, AWS или Yandex Functions с бесплатным лимитом в 1 000 000 обращений в месяц.

Также стоит обратить внимание на библиотеку telethon, если вам требуется делать то, что может только клиент Telegram, например, загружать файлы размером более 40 МБ. Она асинхронная и общается с серверами Telegram по протоколу MTProto. Одна из реализаций telethon, подходящая для создания ботов — Garnet.

Исходя из этой информации, можно сделать следующие выводы:

Если вам нужна библиотека с высокой производительностью и поддержкой, но вы готовы справляться с возможными трудностями в документации, выбирайте aiogram.
Если вам нужно что-то простое и хотите подробную документацию и сниппеты кода, обратите внимание на python-telegram-bot.
Если вам нужно делать то, что может только клиент Telegram, рассмотрите библиотеку telethon.

Порядок создания нового телеграм бота

Действия в телеграм

Создайте новый бот в Telegram через BotFather:
Откройте Telegram и найдите BotFather.
Начните диалог с BotFather и нажмите «/start».
Следуйте инструкциям BotFather для создания нового бота:
1. Введите имя бота (может быть любое, затем можно отредактировать)
2. Введите логин бота (должен быть уникальным и заканчиваться на _bot)
Скопируйте токен вашего бота (под строчкой Use this token to access the HTTP API:).

Установка библиотеки

Установите и настройте необходимую библиотеку Python для работы с телеграм, например aiogram или python-telegram-bot.

Установка aiogram

Запустите командный интерпретатор (в Windows — cmd.exe)

Наберите команду:

pip install aiogram

Как установить библиотеку Python Telegram Bot в Windows, Linux и MacOS:

Windows:
- Откройте командную строку или PowerShell.
- Установите библиотеку с помощью команды: pip install python-telegram-bot
- Подождите, пока процесс установки завершится.
Linux:
- Откройте терминал.
- Установите библиотеку с помощью команды: pip install python-telegram-bot.
- Подождите, пока процесс установки завершится.
MacOS:
- Откройте терминал.
- Установите библиотеку с помощью команды: pip install python-telegram-bot
- Подождите, пока процесс установки завершится.

После завершения установки библиотеки Python Telegram Bot вы можете использовать ее в своих проектах для создания телеграм-ботов.

Как установить библиотеку telethon

Windows:

Откройте командную строку или PowerShell.
Введите команду: pip install telethon.
Нажмите клавишу Enter и дождитесь завершения установки.

Linux:

Откройте терминал.
Введите команду: pip install telethon.
Нажмите клавишу Enter и дождитесь завершения установки.

MacOS:

Откройте терминал.
Введите команду: pip install telethon.
Нажмите клавишу Enter и дождитесь завершения установки.

После завершения установки вы сможете использовать библиотеку Telethon в своих проектах для взаимодействия с API Telegram.

Обратите внимание, что для успешной установки библиотеки Telethon вам может потребоваться наличие Python и pip на вашей системе. Если они не установлены, вам следует установить их перед установкой библиотеки Telethon.

Реализация простого бота в aiogram

Импортируйте необходимые модули и классы из выбранной библиотеки.

Создайте экземпляр класса бота и передайте ему токен вашего бота:

import aiogram  # Импортируйте модуль из выбранной библиотеки

bot = aiogram.Bot(token='YOUR_BOT_TOKEN')  # Создайте экземпляр класса бота и передайте токен вашего бота

Создайте экземпляр класса Dispatcher для обработки входящих сообщений и событий:

dispatcher = aiogram.Dispatcher(bot)  # Создайте экземпляр класса Dispatcher и передайте экземпляр класса бота

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

@dispatcher.message_handler()  # Обработчик для обычных сообщений
async def handle_message(message: aiogram.types.Message):
    # Ваш код для обработки сообщения
    
@dispatcher.callback_query_handler()  # Обработчик для inline-кнопок
async def handle_callback_query(callback_query: aiogram.types.CallbackQuery):
    # Ваш код для обработки inline-кнопки
    
# Добавьте другие обработчики по необходимости

Запустите бота и начните обработку входящих сообщений и событий:

async def main():
    await dispatcher.start_polling()  # Запустить бота для получения входящих сообщений и событий

if __name__ == '__main__':
    aiogram.executor.start_polling(dp, skip_updates=True)  # Запустить основной цикл выполнения бота

Запустите программу и ваш бот будет готов к работе.

import aiogram

bot = aiogram.Bot(token='YOUR_BOT_TOKEN')
dispatcher = aiogram.Dispatcher(bot)

@dispatcher.message_handler()
async def handle_message(message: aiogram.types.Message):
    # Ваш код для обработки сообщения
    
@dispatcher.callback_query_handler()
async def handle_callback_query(callback_query: aiogram.types.CallbackQuery):
    # Ваш код для обработки inline-кнопки
    
async def main():
    await dispatcher.start_polling()

if __name__ == '__main__':
    aiogram.executor.start_polling(dp, skip_updates=True)

Пример простейшего бота на aiogram

import logging
from aiogram import Bot, Dispatcher, types
from aiogram.contrib.fsm_storage.memory import MemoryStorage

# Установка уровня логов для отладки
logging.basicConfig(level=logging.INFO)

# Инициализация бота и диспетчера
bot = Bot(token="YOUR_TELEGRAM_BOT_TOKEN")
storage = MemoryStorage()
dp = Dispatcher(bot, storage=storage)

# Обработчик команды /start
@dp.message_handler(commands=['start'])
async def start_command(message: types.Message):
    # Отправка приветственного сообщения
    await message.answer("Привет! Я бот, который может отправить тебя на сайт Victor Komlev.")
    
    # Создание кнопки с ссылкой на сайт
    button = types.InlineKeyboardButton(text="Перейти на сайт", url="https://victor-komlev.ru")
    keyboard = types.InlineKeyboardMarkup().add(button)
    
    # Отправка кнопки пользователю
    await message.answer("Нажми на кнопку, чтобы перейти на сайт:", reply_markup=keyboard)

# Запуск бота
if __name__ == '__main__':
    from aiogram import executor
    executor.start_polling(dp, skip_updates=True)

После этого вы можете запустить бота, и он будет приветствовать пользователей и создавать кнопку, которая ссылается на указанный сайт.

Обратите внимание, что для работы этого кода необходима версия Python 3.7 или выше

Эхо-бот

Бот отвечает тем же сообщением, что и было отправлено. Кроме случая, когда отправлены слова cat, cats, puss. В этом случае, будет отправлена картинка, сохраненная в файле data\cats.jpg

TOKEN = "Ваш токен"

"""
This is a echo bot.
It echoes any incoming text messages.
"""

import logging

from aiogram import Bot, Dispatcher, executor, types


# Configure logging
logging.basicConfig(level=logging.INFO)

# Initialize bot and dispatcher
bot = Bot(token=TOKEN)
dp = Dispatcher(bot)


@dp.message_handler(commands=['start', 'help'])
async def send_welcome(message: types.Message):
    """
    This handler will be called when user sends `/start` or `/help` command
    """
    await message.reply("Hi!\nI'm EchoBot!\nPowered by aiogram.")


@dp.message_handler(regexp='(^cat[s]?$|puss)')
async def cats(message: types.Message):
    with open('data/cats.jpg', 'rb') as photo:
        '''
        # Old fashioned way:
        await bot.send_photo(
            message.chat.id,
            photo,
            caption='Cats are here ?',
            reply_to_message_id=message.message_id,
        )
        '''

        await message.reply_photo(photo, caption='Cats are here ?')


@dp.message_handler()
async def echo(message: types.Message):
    # old style:
    # await bot.send_message(message.chat.id, message.text)

    await message.answer(message.text)


if __name__ == '__main__':
    executor.start_polling(dp, skip_updates=True)

Индивидуальное и групповое обучение «Python Junior»
Если вы хотите научиться программировать на Python, могу помочь. Запишитесь на мой курс «Python Junior» и начните свой путь в мир ИТ уже сегодня!

Контакты
Для получения дополнительной информации и записи на курсы свяжитесь со мной:

Телеграм: https://t.me/Vvkomlev
Email: victor.komlev@mail.ru

Объясняю сложное простыми словами. Даже если вы никогда не работали с ИТ и далеки от программирования, теперь у вас точно все получится! Проверено десятками примеров моих учеников.

Гибкий график обучения. Я предлагаю занятия в мини-группах и индивидуально, что позволяет каждому заниматься в удобном темпе. Вы можете совмещать обучение с работой или учебой.

Практическая направленность. 80%: практики, 20% теории. У меня множество авторских заданий, которые фокусируются на практике. Вы не просто изучаете теорию, а сразу применяете знания в реальных проектах и задачах.

Разнообразие учебных материалов: Теория представлена в виде текстовых уроков с примерами и видео, что делает обучение максимально эффективным и удобным.

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