Привет! Как-то захотел я сделать своего бота в телеграме. Ну, знаете. Есть свой канал, пара чатов, знаю Python. Но скажу честно, первые попытки были заброшены. Оказалось, что в разработке ботов не было единого подхода, а найти хороший фреймворк оказалось сложнее, чем казалось. Или я не особо внимательный. Но в начале 2021 я нашел свой идеал. Это AIOGram.
А теперь я решил совместить приятное с полезным, так что буду писать какие-то нововведения для бота параллельно документируя их для сайта. Такая себе коллаборация с самим собой для получения побочных продуктов)
AIOGram быстрый старт
Создаём простой проект в PyCharm, ждём завершения и открываем main.py. Его содержимое нас не интересует, так что удаляем. Вместо этого пишем:
|
1 |
from aiogram import Bot, Dispatcher, executor, types |
Дабы почувствовать всю прелесть разработки в PyCharm – используем Context Action для импорта фреймрворка. Ставим указатель на aiogram и нажимаем Alt + Enter, и выбираем Install Package.
Если что-то не получилось, то необходимые библиотеки можно установить через Python Packages.
В будущем мы создадим файлик requirements.txt, в котором будут прописаны все необходимые библиотеки для автоматической установки. А токен и другие важные переменные вынесем в .env файл. Но для простоты эти шаги пока опустим.
Далее пишем следующее:
|
1 2 3 4 5 6 7 |
API_TOKEN = 'BOT TOKEN HERE' bot = Bot(token=API_TOKEN) dp = Dispatcher(bot) if __name__ == '__main__': executor.start_polling(dp, skip_updates=True) |
Переменная с токеном должна содержать токен вашего бота, который можно получить в специальном боте @BotFather при создании своего.
Как вы могли заметить, мы создали объект бота, которому передали токен. Теперь сообщения отправленные боту будут приходить нашему боту на aiogram. Dispatcher это своего рода диспетчер, которые будет выполнять множество задач по взаимодействию с ботом. В т.ч. получение сообщений.
А polling не даст завершить работу бота пока приложение активно.
Запустить можно уже, но интереса никакого. Предлагаю добавить эхо функцию.
|
1 2 3 |
@dp.message_handler() async def echo(message: types.Message): await message.answer(message.text) |
Т.е. теперь dispatcher для любого полученного сообщения будет выполнять функцию echo. Если что-то не особо понятно, то полный код будет в конце статьи.
Проверим? Нажимаем Ctrl +Shift + F10 для запуска скрипта.
Расширяем функционал
Кстати, message_handler не только текст принимает. А любые сообщения, плюс мы можем указывать свои фильтры. Вроде сообщений от админа, личные, группа и т.д. Поддерживает он и команды. Например, эта функция будет срабатывать только при вводе команды /start. Только разместите её выше, чем echo, это важно. В ином случае сообщение перехватит эхо и до этой функции /start не дойдёт.
|
1 2 3 |
@dp.message_handler(commands=['start']) async def send_welcome(message: types.Message): await message.reply("Hello world!") |
Добавим ещё аналогичную help, но ради интереса пропишем её ниже, чем echo:
|
1 2 3 |
@dp.message_handler(commands=['help']) async def send_help(message: types.Message): await message.reply("Чем я могу помочь?") |
Как видите, старт так и срабатывает, а вот help нет. Как я и говорил. Обрабатывать мы можем только одну функцию за раз, и если какой-то обработчик соответствует, то дальнейшие будут отброшены.
Именно поэтому, когда мы пишем /start не срабатывает echo. И именно поэтому не сработал help. Потому что echo собирает все сообщения, которые не /start. Переместим help куда-то выше и попробуем снова.
Кстати, можно указать ещё и фильтр на тип сообщения. Стикер, аудио, файл. А можно даже прописывать особые состояния, благодаря которым бот будет ожидать от пользователя конкретных действий. И, конечно же, мы всё это попробуем дальше. А пока вы можете прописать набор каких-то команд и насладиться своим собственным ботом (пока активна IDE, как только выключите, то и бот отвечать перестанет)
На этом пока всё, но это только начало!
Полный код показанного сегодня:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 |
from aiogram import Bot, Dispatcher, executor, types API_TOKEN = 'TOKEN!' bot = Bot(token=API_TOKEN) dp = Dispatcher(bot) @dp.message_handler(commands=['start']) async def send_welcome(message: types.Message): await message.reply("Hello world!") @dp.message_handler(commands=['help']) async def send_welcome(message: types.Message): await message.reply("Чем я могу помочь?") @dp.message_handler() async def echo(message: types.Message): await message.answer(message.text) if __name__ == '__main__': executor.start_polling(dp, skip_updates=True) |
Кстати, ссылка на моего бота, который недавно получил новую жизнь 🤣
