Telegram-бот на Python и aiogram: быстрый старт

Базовый скелет

Создайте файл my_credentials.py в папке проекта и добавьте следующий код:

API_TOKEN = "ВАШ_ТОКЕН"

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

import asyncio
import logging
import sys

from aiogram import Bot, Dispatcher
from aiogram.client.default import DefaultBotProperties
from aiogram.enums import ParseMode
from aiogram.filters import CommandStart
from aiogram.types import Message

from my_credentials import API_TOKEN


dp = Dispatcher()


async def main() -> None:
    bot = Bot(token=API_TOKEN, default=DefaultBotProperties(parse_mode=ParseMode.HTML))
    await dp.start_polling(bot)


if __name__ == "__main__":
    logging.basicConfig(level=logging.INFO, stream=sys.stdout)
    asyncio.run(main())

Почему мы добавили дополнительный файл с единственной целью - объявить token?

Потому что так проще управлять секретными переменными. Например, теперь можно (если вы используете git) добавить файл в .gitignore; или просто, если Вы будете делиться кодом бота, можете просто не добавлять этот файл в архив, вместо того, чтобы удалять переменные из главного файла.

Первая команда бота

Добавим обработчик команды /start (это самая первая команда, которую отправляет каждый пользователь при первом запуске бота):

@dp.message(CommandStart())
async def send_welcome(message: Message) -> None:
    await message.reply("Привет! Я ваш первый Telegram-бот.")

Декоратор dp.message заставляет функцию выполняться при получении ботом сообщения от пользователя.

Аргумент CommandStart() указывает на то, что эта функция будет вызываться только при получении ботом (от любого пользователя) команды start (то есть пользователь вводит /start, а конкретно эта команда также отправляется автоматически по кнопке Start bot в Telegram).

Реализация эхо-бота

Реализуем обработку всех текстовых сообщений:

@dp.message()
async def echo(message: Message) -> None:
    await message.answer(message.text)

dp.message без аргументов заставляет функцию выполняться при получении ботом любого сообщения от пользователя.

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

Полный код будет выглядеть так:

import asyncio
import logging
import sys

from aiogram import Bot, Dispatcher
from aiogram.client.default import DefaultBotProperties
from aiogram.enums import ParseMode
from aiogram.filters import CommandStart
from aiogram.types import Message

from my_credentials import API_TOKEN


dp = Dispatcher()


@dp.message(CommandStart())
async def send_welcome(message: Message) -> None:
    await message.reply("Привет! Я ваш первый Telegram-бот.")


@dp.message()
async def echo(message: Message) -> None:
    await message.answer(message.text)


async def main() -> None:
    bot = Bot(token=API_TOKEN, default=DefaultBotProperties(parse_mode=ParseMode.HTML))
    await dp.start_polling(bot)


if __name__ == "__main__":
    logging.basicConfig(level=logging.INFO, stream=sys.stdout)
    asyncio.run(main())