Разработка Telegram-бота на Python 3: шаг за шагом

Разработка Telegram-бота на Python 3: шаг за шагом

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

Запуск в режиме поллинга :

Бот запущен и сообщает о том, что он работает в режиме поллинга. Это значит, что бот периодически проверяет сервер Telegram на наличие новых сообщений.

Вывод информации о боте

Переходим в бота:

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

А теперь нажимаем на «ЗАПУСТИТЬ» и смотрим, что у нас получилось:

Мы видим, что бот отреагировал на команду /start именно так, как мы это задумали. Теперь давайте попробуем выполнить команду /start_2 и /start_3:

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

Выводы

Сегодня мы изучили основы создания телеграм-ботов на aiogram 3.x, создали бота и настроили его для работы с командами.

Мы рассмотрели основные концепции и нововведения, которые делают работу с aiogram более удобной и эффективной.

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

Жду ваших отзывов и предложений по темам для будущих постов!

Связанные вопросы и ответы:

Что такое Telegram-бот

Телеграм-бот умеет выполнять в чате те же функции, которые мог бы делать живой человек. Ниже привели примеры полезных и интересных ботов:

Чат-боты по обработке простых запросов клиента — помогают снизить нагрузку на операторов поддержки в часы пик и дают им возможность сосредоточиться на более сложных обращениях. Это самый распространенный тип ботов в Telegram. Они способны отвечать на часто задаваемые вопросы клиентов, например, о настройке или подключении услуг, а еще помогают оформлять заказы, организовывать доставку товаров, бронировать билеты на самолет и многое другое.

Это чат-бот по поиску авиабилетов. Его фишка в том, что он выдает авиапредложения по узким, заданным пользователем параметрам.

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

Полезный бот от «Яндекса» — помогает переводить тексты, а еще его можно добавить в групповой чат для автоматического перевода.

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

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

Телеграм-боты для работы с фото- и видеоформатами — предоставляют пользователю ряд полезных функций и возможностей. Например, некоторые боты обеспечивают инструменты для редактирования фотографий и видео прямо в мессенджере. Другие могут стилизовать фотографии под комиксы и мультфильмы или накладывать звуковые эффекты на аудио.

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

ЧГК-бот использует базу вопросов игры «Что? Где? Когда?». Процесс игры представляет собой отправку ботом вопросов с последующей обработкой ответов по таймеру либо по запросу пользователя.

Какие возможности предоставляет Telegram-бот

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

1. python-telegram-bot

Одной из наиболее популярных и мощных библиотек для разработки телеграм ботов на Python является python-telegram-bot . Эта библиотека обеспечивает полный доступ к Telegram Bot API и предоставляет удобный интерфейс для создания обработчиков сообщений, команд и событий. Преимущества:

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

Пример использования:

from telegram.ext import Updater, CommandHandler, MessageHandler, Filters def start(update, context): update.message.reply_text('Привет, я ваш бот!') def echo(update, context): update.message.reply_text(update.message.text) updater = Updater(token='YOUR_BOT_TOKEN', use_context=True) dp = updater.dispatcher dp.add_handler(CommandHandler('start', start)) dp.add_handler(MessageHandler(Filters.text & ~Filters.command, echo)) updater.start_polling() updater.idle()

2. aiogram

aiogram — это асинхронный фреймворк для разработки ботов на базе asyncio. Он обеспечивает высокую производительность и позволяет создавать сложные боты с поддержкой состояний и клавиатур. Преимущества:

• Асинхронная работа для эффективного взаимодействия с API.
• Удобная обработка состояний, что позволяет создавать ботов с многошаговыми диалогами.
• Поддержка медиа-файлов и геолокации.
• Встроенная поддержка Webhooks для развертывания на серверах.

Пример использования:

import logging from aiogram import Bot, Dispatcher, types from aiogram.contrib.middlewares.logging import LoggingMiddleware API_TOKEN = 'YOUR_BOT_TOKEN' bot = Bot(token=API_TOKEN) dp = Dispatcher(bot) logging.basicConfig(level=logging.INFO) dp.middleware.setup(LoggingMiddleware()) @dp.message_handler(commands=) async def start_command(message: types.Message): await message.reply("Привет, я ваш бот!") @dp.message_handler() async def echo_message(msg: types.Message): await bot.send_message(msg.from_user.id, msg.text) if __name__ == '__main__': from aiogram import executor executor.start_polling(dp, skip_updates=True)

3. pyTelegramBotAPI

pyTelegramBotAPI — это еще одна популярная библиотека для создания телеграм ботов на Python. Она предоставляет простой и интуитивно понятный интерфейс для работы с Telegram API. Преимущества:

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

import telebot bot = telebot.TeleBot('YOUR_BOT_TOKEN') @bot.message_handler(commands=) def handle_start(message): bot.send_message(message.chat.id, 'Привет, я ваш бот!') @bot.message_handler(func=lambda message: True) def echo_all(message): bot.reply_to(message, message.text) bot.polling()

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

Какие библиотеки используются для разработки Telegram-бота на Python 3

Одной из лучших библиотек 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-бота на Python 3

Начнём с того, что для того, чтобы пользователю запустить бота, нам необходимо прописать команды для старта они могут быть разными, например,/startили/goи вообще любыми, какие Вы сочтёте нужными.Для обработки команд нам потребуетсяmessage_handler, с помощью которого и будет реализован весь функционал обработки команд для старта и завершения, если Вы сочтёте нужным добавить завершение. Как только придёт команда/goили/start,message_handlerс соответствующими командами сравнит, совпадают ли строки и если совпадают, то обработает соответствующей функцией.Каждая функция, как и в примере сейчас, должна принимать один параметр — сообщение от пользователя, которое будет обработано соответствующей функции «в обёртке» декоратора. А также, каждая функция (или связка функций) должна возвращать соответсвующее сообщение от бота.Итак:

@bot.message_handler(commands=)  # Обработка команды для старта def welcome(message):     sti = open(path+'stiker.tgs', 'rb')     bot.send_sticker(message.chat.id, sti)     markup = types.ReplyKeyboardMarkup(resize_keyboard=True)     item3 = types.KeyboardButton("Приложения")     item2 = types.KeyboardButton("Мероприятия")     item1 = types.KeyboardButton('О нас')     markup.add(item1, item2, item3)     bot.send_message(message.chat.id,                      "Добро пожаловать, {0.first_name}!\\n\\nЯ - {1.first_name}, бот команды Projector в НГТУ, "                      "создан для того, "                      "чтобы помочь Вам влиться в нашу команду,"                      "просто узнать что-то о нас или же просто пообщаться и весело провести время.\\n\\n"                      "Have a nice time".format(                          message.from_user, bot.get_me()),                      parse_mode='html', reply_markup=markup)

В этой функции реализовано сразу два действия: отправка приветственного сообщения и создание встроенной клавиатуры —ReplyKeyboardMarkup, которая будет открыта, пока мы не завершим выполнения бота соответсвующей командой. Об этом будет сказано ниже.Итак, пройдёмся по строчкам:В строках 20-21: открывается стикер по тому пути к директории, в которой я его сохранил, после чего отправляется.Строки 22-28: создаем встроенную клавиатуру, добавляя туда три элемента.Строки 30-37: описано создание и отправка приветственного сообщенияКак вы можете заметить, методsend_messageв строке 30, позволяет использовать HTML, для форматирования текста.Строками ниже, добавим запуск самого бота, который будет хоститься, пока не случится ошибка или же, пока мы Сами его не закроем.

Как создать базовый Telegram-бот на Python 3

С Inline клавиатурами всё немного посложнее, потому что мы будем обрабатывать не текстовые сообщения, а callback_data.

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

otvet = types.InlineKeyboardMarkup(row_width=2)

Параметры у Inline клавиатуры точно такие-же, как и у Reply клавиатуры.

Теперь давайте добавим кнопки в нашу Inline клавиатуру.

button1 = types.InlineKeyboardButton(" Хорошо", callback_data='good') button2 = types.InlineKeyboardButton(" Плохо", callback_data='bad')

Здесь мы пропишем название нашей кнопки и сам callback_data, который мы будем обрабатывать.

Далее добавляем наши кнопки в клавиатуру с помощью строки:

otvet.add(button1,button2)

И теперь прикрепляем нашу клавиатуру к сообщению как в случае с Reply клавиатурой:

reply_markup=otvet

У вас должна выйти примерно вот такая строка.

Теперь включаем бота и проверяем нашу клавиатуру:

Как мы видим - клавиатура прикрепилась к сообщению.

Теперь нам нужно добавить обработчик callback_data с помощью данных строк:

@bot.callback_query_handler(func=lambda call: True) def callback_inline(call): try: if call.message: if call.data == "good": bot.send_message(call.message.chat.id, "Круто!") if call.data == "bad": bot.send_message(call.message.chat.id, "Ничего, все наладится!") except Exception as e: print(repr(e))

Теперь при нажатии на кнопку "Хорошо" бот будет отвечать "Круто!", а при нажатии на "Плохо" будет отвечать "Ничего, все наладится!"

Проверим, отвечает ли бот при нажатии на кнопки в клавиатуре:

Как мы видим - бот отвечает нам при нажатии на кнопки клавиатуры.

Как добавить функцию отправки сообщений в Telegram-бот на Python 3

О том, как создаются Telegram-боты, можно посмотреть здесь . Начнем с нашего интерфейса.

Возьмем первую библиотеку для Python: Python-telegram-bot .

Чтобы не захламлять компьютер чем-то лишним, будем использовать питоновскую виртуальную среду (venv). Это похоже на изолированный контейнер, в котором можно проводить любые опыты, и доступно это только внутри этой папки.

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

Токен мы будем хранить в скрытых данных. За это в Python отвечает модуль dotenv, который также ставится внутри нашей виртуалки, и в сам файл уже переносим токен.

from bot.bot import start, list_files, upload_file, search_button, cython, pi_button, FIRST, SECOND from dotenv import load_dotenv from telegram.ext import ApplicationBuilder, CommandHandler, MessageHandler, filters, CallbackQueryHandler, ConversationHandler import os async def hello(update: Update, context: ContextTypes.DEFAULT_Type) ->Name: Name: await update.message.replay_text(f'Hello(update.effective_user.first_name)') load_dotenv() application = ApplicationBuilder().token(os.getenv('TOKEN')).build() app.add_handler(CommandHandler(“hello”, hello)) app.run.polling()

Чтобы подружить Telegram с Google Drive воспользуемся API /quickstart/python . Здесь нам нужно получить что-то вроде токена, как и в случае аутентификации с API Telegram, только в Google API это называется(Credentials). В main.py мы должны добавить и токен, и обработчик функции start.

По этой логике нужно написать еще одну функцию и добавить ее в еще один handler уже для сэмпла от Google Drive.

async list_files()

Добавляем еще один CommandHandler (обработчик команд или все, что мы пишем через слэш).

В Telegram, проверить работу функции можно командой /files, которую мы можем легко добавить в админке BotFather

По коду Google: мы достаем секретки и вытаскиваем все файлы, дальше выводим их в консоль. Можно сделать, чтобы ответ приходил не в консоль сервера, а сразу в бот на клиент.

Добавление функции отправки сообщений в Telegram-бот на Python 3

Чтобы добавить функцию отправки сообщений в Telegram-бот на Python 3, нам понадобится несколько шагов:

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

Сначала нам нужно установить библиотеку Python-telegram-bot. Это можно сделать с помощью pip:

pip install python-telegram-bot

Шаг 2: Создание виртуальной среды

Чтобы не захламлять компьютер чем-то лишним, мы будем использовать питоновскую виртуальную среду (venv). Это похоже на изолированный контейнер, в котором можно проводить любые опыты, и доступно это только внутри этой папки.

python -m venv myenv

Шаг 3: Получение токена от BotFather

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

Шаг 4: Хранение токена в скрытых данных

Токен мы будем хранить в скрытых данных. За это в Python отвечает модуль dotenv, который также ставится внутри нашей виртуалки, и в сам файл уже переносим токен.

pip install python-dotenv

Шаг 5: Подключение Google Drive API

Чтобы подружить Telegram с Google Drive воспользуемся API /quickstart/python. Здесь нам нужно получить что-то вроде токена, как и в случае аутентификации с API Telegram, только в Google API это называется(Credentials).

Шаг 6: Добавление функции отправки сообщений

В main.py мы должны добавить и токен, и обработчик функции start.

from telegram.ext import Updater, CommandHandler, MessageHandler import os import logging logging.basicConfig(level=logging.INFO) TOKEN = os.getenv('TOKEN') def start(update, context): context.bot.send_message(chat_id=update.effective_chat.id, text='Привет!') def main(): updater = Updater(TOKEN, use_context=True) dp = updater.dispatcher dp.add_handler(CommandHandler('start', start)) updater.start_polling() updater.idle() if __name__ == '__main__': main()

Шаг 7: Добавление функции отправки файлов из Google Drive

По этой логике нужно написать еще одну функцию и добавить ее в еще один handler уже для сэмпла от Google Drive.

from googleapiclient.discovery import build from google_auth_oauthlib.flow import InstalledAppFlow from google.auth.transport.requests import Request import pickle import os.path SCOPES = ['https://www.googleapis.com/auth/drive'] def list_files(): creds = None if os.path.exists('token.pickle'): with open('token.pickle', 'rb') as token: creds = pickle.load(token) if not creds or not creds.valid: if creds and creds.expired and creds.refresh_token: creds.refresh(Request()) else: flow = InstalledAppFlow.from_client_secrets_file( 'credentials.json', SCOPES) creds = flow.run_local_server(port=0) with open('token.pickle', 'wb') as token: pickle.dump(creds, token) service = build('drive', 'v3', credentials=creds) results = service.files().list( fields="nextPageToken, files(id, name)").execute() items = results.get('files', []) if not items: print("No files found.") else: print("Files:") for item in items: print(u"{0} ({1})".format(item['name'], item['id'])) def files(update, context): list_files() context.bot.send_message(chat_id=update.effective_chat.id, text='Файлы отправлены!') def main(): updater = Updater(TOKEN, use_context=True) dp = updater.dispatcher dp.add_handler(CommandHandler('start', start)) dp.add_handler(CommandHandler('files', files)) updater.start_polling() updater.idle() if __name__ == '__main__': main()

Теперь, когда мы добавили функцию отправки файлов из Google Drive, мы можем проверить ее работу командой /files в Telegram.