События

Событие (event) - действие, связанное с ботом.

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

Для бота эти уведомлений представляют собой исчерпывающую информацию о произошедшем действии. Вот пара примеров:

Когда пользователь заходит на сервере, отправляется объект пользователя.
Когда отправляется новое сообщение, отправляется объект сообщения.
При обновлении голосового состояниЯ, отправляется новое состояние.

Как вы можете заметить, при изменения Discord часто отправляет объекты, с которым эти изменения связаны. Для сообщений это сообщения, для участников это участники.

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

Обработчик - функция. вызываемая в ответ на событие для его обработки.

Типовая функция-обработчик выглядит подобным образом. Принимает она в себя событие и ничего не возвращает в ответ.

async def handle_event(event: Event) -> None: ...