Bot Platform

Reason Space Bot Platform — это API и SDK для разработки ботов. Бот — это User с пометкой is_bot=true, который:

• Читает chat-сообщения через REST (GET messages) и отвечает в allowed_channels
• Публикует аудио в voice-канал (без подписки на чужой voice)
• Получает события через HMAC-подписанные webhooks (эхо собственных отправок, удаления, kick, slash-команды)
• Добавляется в Space по приглашению админа (static Bot-токен, скоупы назначаются при invite)

Quick start

Echo-бот за 5 минут.

SDK Python

pip install reasonspace-bot

Scopes

Описание разрешений.

Voice playback

Публикация аудио в voice-комнаты.

Сценарии использования

• Music — команда /play <track> запускает воспроизведение в voice
• Moderation — автоматическая реакция на спам, авто-kick нарушителей
• Productivity — daily-standup напоминания, интеграции с трекерами
• Fun — quote-of-the-day, dice-rolls, статистика space'а

Privacy first

Бот никогда не модератор voice-комнаты, не получает аудио других участников (гарантия на уровне сервера), не читает E2E-encrypted chat-сообщения, не имеет доступа к DM. Эти ограничения — не настройка scope'а, а константы платформы. Подробнее: Privacy.

Состояние

Bot Platform — public beta. Готов static-tokens flow, SDK Python публикуется на pypi. OAuth2 (1-click install), marketplace и расширенный voice API — в следующей фазе (см. OAuth2 — roadmap).

Все эндпоинты живут под /api/*. Изменение scope-конвенций (добавление/удаление/переименование) — breaking change: перед removal/rename действует deprecation-цикл ≥ 90 дней с warning'ами в audit_log.