Telegram API ліміти — що це означає для вашого бота і як Leadmlyn з ними справляється

Уявіть: ви відкриваєте реєстрацію на популярний захід — і за 5 хвилин 40 людей пишуть боту одночасно. Що відбудеться? Чи витримає Telegram? Чи впаде бот? Чи втратяться повідомлення?

Це не гіпотетика. Такий сценарій — відкриття бронювань у квест-кімнаті або анонс нового тренінгу у фітнес-клубі — трапляється регулярно. І те, як бот його обробляє, залежить від того, наскільки добре інфраструктура враховує реальні ліміти Telegram API.

Які ліміти є у Telegram Bot API

Telegram публікує ліміти у офіційній документації. Основні, важливі для бізнес-бота:

Rate limits на відправку:

• 30 повідомлень на секунду до різних чатів — глобальний ліміт на бота
• 1 повідомлення на секунду в один конкретний чат
• При перевищенні Telegram повертає помилку 429 Too Many Requests з полем retry_after — через скільки секунд можна повторити

Розмір контенту:

• 4096 символів — максимальна довжина одного текстового повідомлення
• 1024 символи — для підписів до медіа (caption)
• 50 МБ — максимальний розмір файлу для завантаження через Bot API

Flood control:

• Якщо бот систематично перевищує ліміти, Telegram може тимчасово заблокувати його. Термін і умови не публікуються точно — це захисний механізм від spam-ботів.

Webhook і polling:

• 40 одночасних підключень до getUpdates (polling) — рідко актуально для webhook-архітектури
• Timeout webhook-запиту: 60 секунд

Для більшості leisure-ботів, які ведуть 1-20 розмов одночасно, жоден з цих лімітів у звичайний день не досягається. Проблема виникає в специфічних сценаріях.

Чи впливають ліміти на типовий SMB-бот

Для 90% day-to-day роботи — ні. Клієнти пишуть рівномірно протягом дня. Бот відповідає на одне повідомлення, потім наступне. Навіть у «гарячий» вечір п'ятниці, коли 5-7 людей пишуть одночасно, загальне навантаження далеко від ліміту 30 msg/sec.

Де ліміти стають реальними:

Масові розсилки. Якщо ви хочете надіслати нагадування 500 клієнтам про акцію — 500 повідомлень підряд. Навіть якщо відправляти по одному в секунду (нижче глобального ліміту 30/сек), Telegram може розцінити це як спам-активність. Правильно — розбивати на партії по 30-50 і розтягувати на кілька хвилин.

Burst при відкритті бронювань. Оголошення в соцмережах «записуємось з 10:00» — і в 10:00:05 приходить 40 запитів. Це вже близько до ліміту. Без черги повідомлень частина запитів отримає і або зависне, або буде відхилена.