Введение
Этот раздел документации описывает Bot API — набор протоколов и контрактов, по которым внешние программы («боты») подключаются к Voice и действуют в группах и каналах.
Что такое бот
Бот — это отдельный аккаунт на платформе Voice, которым управляет не человек за клавиатурой, а программа. Владелец создаёт бота через свой аккаунт, получает токен и дальше подключает к API уже свой код — подробнее в разделе «Быстрый старт». Для остальных участников бот выглядит и ведёт себя как обычный пользователь: у него есть профиль, он может писать сообщения, на него можно упомянуть — разница только в том, что вместо пароля он аутентифицируется токеном, а входящие события получает через постоянное соединение (Gateway), а не через интерфейс приложения.
Для чего используются боты
Модерация группы
Автоматическая проверка сообщений, выдача и снятие ролей, исключение и блокировка участников.
Интеграции
Уведомления из внешних систем (CI/CD, мониторинг, тикеты) прямо в каналы группы.
Управление структурой
Создание каналов и категорий, назначение ролей по сценарию — там, где выданы соответствующие права.
Интерактивные команды
Слэш-команды, кнопки и модальные окна, на которые бот отвечает через Interactions API.
Всё это — обычные вызовы BotsApi и события Gateway, описанные дальше в этом разделе:
аутентификация, intents,
права и роли, interactions и
компоненты сообщений.
Платформы SDK
Bot API не привязан к языку — это gRPC плюс SignalR-соединение для realtime-событий, так что библиотеку можно написать на чём угодно (подробнее — в разделе «Библиотеки для ботов»). Сейчас официально поддерживаются две платформы, остальные — в планах.
.NET / C#
Официальная библиотека Voice.Bot.Client.Net — полный стек: аутентификация, Gateway, фреймворк команд, билдеры компонентов.
JavaScript / TypeScript
Официальная SDK для Node.js и совместимых рантаймов.
Python
Пока не поддерживается официально.
Go
Пока не поддерживается официально.
Ruby
Пока не поддерживается официально.
Java / Kotlin
Пока не поддерживается официально.
Хотите реализовать библиотеку на другом языке сами? В разделе «Библиотеки для ботов» есть пошаговый план и структура для образца.