Лимиты

Количество ботов

По умолчанию пользователь может создать до 25 ботов. Лимит может быть увеличен администратором; значение 0 означает отсутствие ограничения.

Поля и сетки

display_name — до 80 символов, описание — до 1000, приветствие и action data — до 4000, текст кнопки и команда — до 255. Меню: до 9 строк и 10 кнопок в строке.

Медиа и webhook

Один upload — до 200 МБ. Webhook должен ответить за 5 секунд. Используйте очередь и отвечайте 2xx до выполнения долгой задачи.

Пагинация

Списки собственных и добавленных ботов используют независимую курсорную пагинацию, по 10 элементов в интерфейсе. Не конструируйте cursor вручную.

Практика с SDK

Проверяйте ограничения до отправки, но также обрабатывайте 413, 422 и 429 от сервера: лимиты могут меняться независимо от версии SDK.

При пагинации храните cursor как непрозрачную строку и не используйте его после изменения фильтров или владельца.

const rows = commands.slice(0, 9).map(row => row.slice(0, 10));
await bot.sendMessage({ chat_id: chatId, content: { text: 'Menu updated', menu: { rows } } });