Перейти к содержимому
CalabДокументация

Лимиты

Лимиты частоты для ботов и интеграций, размеры сообщений и кадров, лимиты тарифов и сроки жизни токенов.

Превышение лимита частоты даёт 429 ERROR_CODE_RATE_LIMITED с заголовком Retry-After (секунды); лимита тарифа — 409 с reason: "PLAN_LIMIT" и полями used / limit. Значения ниже — облака Calab и настроек по умолчанию; на своём сервере оператор может их изменить.

Частота запросов бота

ЧтоЛимит
Все запросы бота30 в секунду, всплеск 30 (BOT_RATE_PER_SEC)
Сообщения бота20 в минуту по всем комнатам и DM (BOT_MESSAGES_PER_MIN)
Сообщения в одну комнату5 за 5 секунд — общий лимит для всех
Новые DM10 сразу, 30 в час
Загрузка файлов30 сразу, 120 в час
Загрузка стикеров10 пакетов сразу, 60 в час
Приглашения письмом20 сразу, 30 в час; один адрес — не чаще раза в сутки
Создание и правка встреч30 сразу, 120 в час
Звуки в звонке1 раз в 2 с на бота, 5 за 10 с на комнату
Телефонные звонки20 в час на пространство
TYPING в gatewayраз в 3 с на комнату

Размеры

ЧтоПредел
Текст сообщения4000 символов
Вложений в сообщении20
nonce64 символа
История за запросlimit ≤ 100
Команды бота100; имя ≤ 32, описание ≤ 256 символов
Описание бота512 символов; имя — 1–64
Клавиатура под сообщением5 рядов × 5 кнопок; label ≤ 80 символов, data ≤ 512 байт, allowedUserIds ≤ 50
Реакции3 разных эмодзи одного участника на сообщение
СтикерWebP, стороны ≤ 512, ≤ 512 КБ (статичный) / ≤ 1 МБ (анимированный); до 50 за запрос, до 120 в паке
Картинка бейджаPNG / WebP / JPEG ≤ 128 КБ
Чек-листы10 на задачу, 100 пунктов в чек-листе
Вехи внутри задачи20 на задачу
Категории досок50 на пространство
Временные комнаты20 на пространство, 5 на создателя
Подписка SUBSCRIBE100 комнат

Gateway

ЧтоПредел
Сокетов на токен бота1
Входящий кадр64 КиБ
Очередь отправки256 кадров, переполнение — 4008
TYPING / SUBSCRIBE / PRESENCE_UPDATE10 подряд и 2 в секунду, лишние отбрасываются
Флудбольше 50 кадров в секунду устойчиво — 4008
Heartbeatоколо 41 с; без heartbeat 2 × интервал + 10 с — 4009
Буфер RESUMEоколо 5 минут или 1000 событий

Вебхуки

ЧтоЗначение
Ответлюбой 2xx за 10 с
Повторы1 мин, 2, 4 … до 1 часа между попытками
Жизнь доставкисутки
Отключениепосле суток ошибок подряд
Тело вебхука доскидо 256 КБ
Проверка вебхука доски (ping)раз в 10 с

Тарифы

ЛимитFreeTeamBusiness
Участников в пространстве (боты считаются, гости — нет)50100500
Ботов1520
Досок33050
Форм на доску—520
Хранилище файлов5 ГиБ300 ГиБ1 ТиБ
Человек в голосовой комнате51550
Стикерпаков / стикеров1 / 200без лимитабез лимита
Чек-листы—естьесть
Вебхук доски, телефония——есть
Автоматизации досок—естьесть

На своём сервере (Enterprise) лимиты задаёт оператор.

Сроки жизни токенов

ТокенСрок
Токен ботабессрочно, до перевыпуска или отзыва
Токен LiveKit из POST /api/rooms/{id}/join10 минут; подключиться нужно за 15 с
OAuth access-токен5 минут
OAuth authorization code1 минута
OAuth refresh-токен8 часов, или 30 минут без использования

Подробно — Форматы токенов и OAuth: токены и сроки.