Bot¶

Bot — основной класс. FastVK расширяет его методом run_polling().

Конструктор¶

Bot(
    token: str,
    group_id: int,
    *,
    storage: BaseStorage | None = None,
    lifespan: AsyncContextManager | None = None,
    api_version: str = "5.199",
)

Параметр	Тип	Описание
`token`	`str`	Токен VK сообщества
`group_id`	`int`	ID VK сообщества
`storage`	`BaseStorage`	FSM хранилище. По умолчанию: `MemoryStorage()`
`lifespan`	async context manager	Хук запуска/остановки
`api_version`	`str`	Версия VK API. По умолчанию: `"5.199"`

Методы¶

start_polling¶

async def start_polling(self, *, skip_updates: bool = False) -> None

Запустить цикл long-polling. Блокирует до вызова stop() или прерывания процесса.

skip_updates=True — выбросить накопившиеся апдейты перед стартом.

stop¶

async def stop(self) -> None

Мягко остановить цикл polling.

get_me¶

async def get_me(self) -> Group

Вернуть информацию о сообществе бота (вызывает groups.getById).

get_user¶

async def get_user(self, user_id: int, fields: str = "") -> User

Вернуть информацию о пользователе (вызывает users.get).

user = await bot.get_user(123456)
user = await bot.get_user(123456, fields="photo_200,city")

_call¶

async def _call(self, method: str, **params) -> Any

Низкоуровневый API вызов. Вызывает VKAPIError при ответе с ошибкой.

API пространства имён¶

bot.messages   # MessagesNamespace
bot.users      # UsersNamespace
bot.groups     # GroupsNamespace
bot.wall       # WallNamespace
bot.photos     # PhotosNamespace
bot.docs       # DocsNamespace

Каждое пространство имён имеет типизированные методы, возвращающие разобранные модели. Пример:

msg_id = await bot.messages.send(peer_id=123, message="Привет", random_id=0)
# msg_id: int

user_list = await bot.users.get(user_ids=123456)
# user_list: list[dict]