Отправка и чтение сообщений, реакции, редактирование собственных сообщений и модерация при наличии прав.
Бот, который работает внутри твоего сервера
Создай приложение в портале разработчика, выпусти Bot Token, установи бота на сервер и выдай только те права, которые ему действительно нужны.
POST /api/v1/bot/messages
Authorization: Bot clb_••••
{
"channel_id": 142,
"content": "Матч начнётся через 10 минут"
}За что отвечают боты
Бот действует как отдельный участник сервера. Его возможности одновременно ограничены токеном, установленным сервером и ролью CyberLink.
Получение структуры сервера, создание каналов, работа с ролями и назначениями в пределах выданных scopes.
Warn, mute, kick и ban доступны только когда это разрешено scope токена и ролью бота на конкретном сервере.
Связывай игровые панели, сайты, CI, мониторинг и внутренние сервисы с каналами CyberLink.
От идеи до работающего бота
- Создай приложение
Открой «Для разработчиков», задай имя и описание приложения. Внутри приложения создаётся bot identity.
- Выбери scopes
Разреши только необходимые категории API: каналы, сообщения, участники, роли, модерация, статистика или музыка.
- Выпусти токен
Полный token показывается один раз. На сервере хранится только его хеш, поэтому секрет нужно сохранить у себя безопасно.
- Установи на сервер
Бот получает доступ только к тем серверам, куда его установили. Роль сервера дополнительно ограничивает реальные действия.
- Подключи код
Отправляй запросы к Bot API с заголовком Authorization. Для простых входящих уведомлений можно использовать webhook без полноценного бота.
Когда нужен только входящий поток
Вебхук привязывается к конкретному приложению и каналу. Внешний сервис отправляет POST с секретом, CyberLink повторно проверяет установку приложения и право записи в канал, а затем публикует сообщение через общий realtime-путь.
Доступ не определяется клиентом
Bot Token определяет приложение, bot user и account_id на backend. Клиент не передаёт tenant authority. Каждый запрос дополнительно проверяет scopes, установку приложения, сервер и роль бота. Вебхуки используют отдельные отзываемые секреты.
