Боты

Бот — отдельный аккаунт приложения со значком «бот». Он заходит на серверы по приглашению, получает события через шлюз, отвечает на команды «/» и пишет сообщения с карточками и кнопками.

Жизненный цикл

1. Создание
   Консоль → приложение → «Бот» → «Создать бота». Имя и аватар бота берутся из названия и иконки приложения. Токен vbt_… показывается один раз.
2. Приглашение
   Ссылка /oauth2/authorize?client_id=…&scope=bot%20applications.commands&permissions=…. Добавить бота может участник с правом «Управлять сервером» (или администратор). Бот получает свою роль с выбранными правами и значком 🤖; выдать ему больше прав, чем есть у пригласившего, нельзя. Повторное приглашение на тот же сервер обновляет права роли.
3. Работа
   Пока бот подключён к шлюзу, он «в сети»: получает события всех серверов, каналов и личных бесед, которые может видеть, и отвечает на команды. Если бот не в сети, люди видят «… сейчас не в сети» вместо отправки команды.
4. Сброс токена и удаление
   Сброс токена сразу закрывает все подключения бота. Удаление приложения убирает бота со всех серверов; отменить нельзя.

Публичный и личный бот

По умолчанию бот публичный — пригласить его может любой администратор сервера. Выключите «Публичный бот» на вкладке «Бот», и добавлять его сможет только владелец приложения.

Что доступно боту

Токен бота открывает только методы из справочника: профиль, серверы, роли и каналы, сообщения и реакции, закрепления, личные сообщения, загрузка вложений, свои команды и ответы на взаимодействия. Остальное API (друзья, настройки, управление сервером, кошелёк, маркет) вернёт 403 с кодом 20001. Права на сервере проверяются как у обычного участника: без «Отправлять сообщения» бот не напишет в канал.

Каталог ботов

Публичного бота можно опубликовать в каталоге «Обзор ботов» внутри Voice: вкладка «Каталог» в консоли. Нужны иконка, короткое описание (от 10 символов) и категория; карточка проходит проверку. После правки описания карточка снова уходит на проверку. Пользователи ставят оценки и могут пожаловаться на бота.

Ограничения

• До 25 приложений на аккаунт и не больше 10 новых в час.
• 12 сообщений за 10 секунд от одного бота, до 12 одновременных подключений к шлюзу.
• Остальное — в разделе Лимиты.