О Voice

Voice — мессенджер с группами, каналами, голосовой связью и ботами. С точки зрения Bot API важны несколько вещей о том, как устроена платформа.

Группы и каналы

Пользователи объединяются в группы — в каждой группе есть текстовые и голосовые каналы, набор ролей и участников. Бот, добавленный в группу, видит её структуру и может на неё влиять (создавать каналы, управлять ролями) в пределах выданных ему прав — подробнее в разделе «Права и роли».

Реальное время

Сообщения, реакции, изменения в группе и голосовые события доставляются подписчикам сразу, через постоянное соединение (Gateway), а не через опрос (polling). Для бота это означает, что его библиотека должна поддерживать долгоживущее соединение, а не просто отправлять HTTP/gRPC-запросы — подробнее в разделе «Gateway».

Боты как часть платформы

Бот в Voice — не отдельная сущность API, а обычный участник платформы (подробнее — в «Обзоре»): у него есть токен вместо пароля, но во всём остальном (сообщения, упоминания, статус присутствия) он ведёт себя как пользователь.