Начало работы с ботами

Боты позволяют автоматизировать действия на сервере: отвечать на сообщения, обрабатывать слэш-команды и реагировать на события.

Регистрация бота

Отправьте POST-запрос на Object Server:

curl -X POST https://your-server:8082/servers/{serverId}/bots \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-bot", "webhookUrl": "https://your-bot.example.com/webhook"}'

webhookUrl — опционально. Если не указан, бот получает события через WebSocket.

Ответ

{
  "bot": {
    "id": "uuid-бота",
    "name": "my-bot",
    "ownerUserId": "ваш-user-id",
    "ownerFederation": "ваш-сервер",
    "webhookUrl": "https://your-bot.example.com/webhook"
  },
  "token": "bot-token-сохраните-его"
}

Важно: токен показывается только один раз. Сохраните его — он понадобится для подключения по WebSocket.

Что дальше

Bot HTTP API — управление ботами и слэш-командами
WebSocket — подключение и получение событий в реальном времени
Примеры — готовые примеры ботов на Python и JavaScript

examples

setup