maxapi/wiki/events.md

3.5 KiB
Raw Permalink Blame History

Для обработки разных типов обновлений используются события (Event). Ниже перечислены основные события и их назначение.

Событие Описание
message_created Создание нового сообщения (пользователь отправил сообщение)
bot_added Бот добавлен в чат
bot_removed Бот удалён из чата
bot_started Пользователь запустил бота
bot_stopped Пользователь остановил бота
dialog_cleared Пользователь очистил историю диалога с ботом
dialog_muted Пользователь отключил оповещения от чата бота
dialog_unmuted Пользователь включил оповещения от чата бота
dialog_removed Пользователь удалил диалог с ботом
chat_title_changed Изменено название чата
message_callback Пользователь нажал на callback-кнопку (inline button)
message_chat_created Срабатывает когда пользователь нажал на кнопку с действием "Создать чат" (работает некорректно со стороны API MAX, ждем исправлений)
message_edited Сообщение было отредактировано
message_removed Сообщение было удалено
user_added Пользователь добавлен в чат
user_removed Пользователь удалён/вышел из чата
on_started Бот запущен (внутреннее событие библиотеки)

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

@dp.message_created()
async def on_message(event: MessageCreated):
    ...  # обработка нового сообщения

@dp.bot_added()
async def on_bot_added(event: BotAdded):
    ...  # логика при добавлении бота

@dp.message_callback()
async def on_callback(event: MessageCallback):
    ...  # обработка нажатия на callback-кнопку