На Voice можно строить ботов, сайты со входом через аккаунт Voice и интеграции, которые пишут в каналы. Всё работает через открытый REST API и шлюз событий на WebSocket — те же, которыми пользуется само приложение.
Первый ботПриложение, токен, приглашение и рабочий код на Node.js или Python.Войти через VoiceOAuth 2.0 и OpenID Connect с PKCE для вашего сайта.Шлюз событийWebSocket: сообщения, участники, команды — в реальном времени.ВебхукиУведомления в канал одним HTTP-запросом, формат как у Discord.
Адреса
| Что | Адрес |
|---|---|
| REST API | https://voice-chat.ru/api |
| Шлюз событий (WebSocket) | wss://voice-chat.ru/gateway |
| Экран входа Voice ID | https://voice-chat.ru/oauth2/authorize |
| OpenID Connect discovery | https://voice-chat.ru/.well-known/openid-configuration |
| Состояние API | https://voice-chat.ru/api/status |
Этот сайт — только документация и консоль приложений. Боты и ваши серверы обращаются к основному домену voice-chat.ru.
Три вида доступа
| Кто | Заголовок | Откуда |
|---|---|---|
| Бот | Authorization: Bot vbt_… | Консоль → приложение → «Бот» → «Создать бота». Подробнее |
| Сайт от имени пользователя | Authorization: Bearer vat_… | Обмен кода Voice ID на токен. Подробнее |
| Вебхук | токен в адресе | Настройки канала → «Интеграции». Подробнее |
Боты и сайты видят только свою часть API
Токену бота доступны сообщения, каналы, участники, команды и файлы для вложений; токену Voice ID — только то, что разрешил пользователь (профиль, почта, список серверов). Друзья, настройки, кошелёк, маркет и админка ботам и сайтам недоступны — такие запросы получают
403.С чего начать
- Быстрый старт — бот с командой «/ping» за 10 минут.
- Справочник API — все методы, доступные ботам и сайтам.
- События шлюза — что и когда присылает сервер.
- Мои приложения — консоль: приложения, токены, команды, статистика.