Webhook vs Long Polling: архитектура Telegram бота — код и рекомендации

Webhook — лучше для продакшена. Long Polling — для разработки и тестирования. Выбор зависит от этапа проекта и требований к производительности.

Моя рекомендация: Long Polling для разработки, Webhook для продакшена. Переключение — одна строчка кода.

Как работает Webhook

1. 1.Вы регистрируете URL вашего сервера в Telegram API
2. 2.Когда пользователь отправляет сообщение — Telegram отправляет HTTP POST на ваш URL
3. 3.Ваш сервер обрабатывает сообщение и отвечает

Преимущества Webhook

Недостатки Webhook

Пример настройки Webhook (aiogram)

 1from aiogram import Bot, Dispatcher
 2from aiogram.webhook.aiohttp_server import SimpleRequestHandler
 3
 4bot = Bot(token="TOKEN")
 5dp = Dispatcher()
 6
 7# Установка webhook
 8await bot.set_webhook(
 9    url="https://your-domain.com/webhook",
10    allowed_updates=["message", "callback_query"]
11)

Когда использовать Webhook

• ›Продакшен (всегда)
• ›Высокая нагрузка (100+ пользователей)
• ›Нужна мгновенная доставка
• ›Бот работает 24/7

Как работает Long Polling

1. 1.Бот отправляет запрос Telegram: «Есть новые сообщения?»
2. 2.Telegram удерживает соединение открытым до 50 секунд
3. 3.Если появилось сообщение — Telegram сразу отвечает
4. 4.Бот обрабатывает сообщение и снова спрашивает

Преимущества Long Polling

Недостатки Long Polling

Пример Long Polling (aiogram)

 1from aiogram import Bot, Dispatcher
 2
 3bot = Bot(token="TOKEN")
 4dp = Dispatcher()
 5
 6# Запуск long polling
 7await dp.start_polling(bot)

Когда использовать Long Polling

• ›Локальная разработка
• ›Тестирование
• ›Быстрый прототип
• ›Бот для себя (1-5 пользователей)

Формула выбора:

Переключение с Long Polling на Webhook — одна строчка кода. Не нужно переписывать логику бота.

Статьи по теме: - Telegram бот на Python — руководство - Aiogram vs Telebot vs python-telegram-bot — выбор фреймворка - Стоимость Telegram бота — 7 факторов

Варианты хостинга для Telegram бота

Стоимость разработки и деплоя

Как настроить Webhook с SSL (пошагово)

Webhook: типичные ошибки

Long Polling: типичные ошибки

Мониторинг бота в продакшене

В моей практике был случай, когда выбор между Webhook и Long Polling стоил клиенту 200 000 ₽. Бот для интернет-магазина одежды работал на Long Polling в продакшене 3 месяца. При нагрузке 20-30 пользователей в день всё было отлично. Но в пятницу запустили рекламную кампанию в Telegram Ads. Приток — 500 пользователей за 2 часа.

Long Polling не справился. Бот начал пропускать сообщения: клиент нажимал «Заказать», а бот молчал. Другой клиент отправлял фото товара для уточнения — ответ приходил через 45 секунд. Третий не мог оплатить, потому что callback_query утерялся. Итог за вечер: 47 потенциальных заказов потеряно, 12 жалоб в чат, 3 негативных отзыва. Упущенная выручка — примерно 200 000 ₽.

На следующий день переключили бота на Webhook. Заняло 2 часа: настройка nginx, SSL, деплой. После переключения те же 500 пользователей обрабатывались без задержек. Среднее время ответа — 80 мс. Никаких потерь сообщений. Клиент сказал: «Почему сразу не на Webhook?». Честный ответ: Long Polling проще в настройке, и для MVP он подходит. Но продакшен без Webhook — это лотерея.

Урок: если бот приносит деньги — используйте Webhook. Если это прототип или учебный проект — Long Polling. Но как только бот начинает обрабатывать реальные заказы — немедленно переходите на Webhook. Стоимость миграции — 3 000-5 000 ₽. Стоимость потерь от Long Polling в продакшене — от 50 000 ₽.

Ещё одна важная деталь: Webhook экономит ресурсы сервера. Long Polling держит соединение открытым 24/7, даже если никто не пишет. Webhook — только когда есть сообщение. На VPS за 300 ₽/мес это не критично, но на масштабе 10 000+ пользователей разница в потреблении CPU и RAM становится заметной. Webhook использует ресурсы на 60-70% эффективнее.

Миграция с Long Polling на Webhook — одна из самых простых процедур в разработке Telegram-ботов. Если вы используете aiogram, достаточно изменить 3-5 строк кода. Но есть нюансы, которые нужно учесть, чтобы не потерять сообщения в процессе перехода.

Первый шаг — подготовка сервера. Вам нужен VPS с публичным IP-адресом и доменом. Если у вас ещё нет VPS — DigitalOcean или Selectel предоставляют серверы от 300 ₽/мес. Домен можно привязать бесплатно через Cloudflare. Установите nginx как reverse-proxy — он будет принимать запросы от Telegram и передавать их вашему боту.

Второй шаг — получение SSL-сертификата. Telegram требует HTTPS для webhook. Используйте Let's Encrypt — бесплатные сертификаты с автоматическим продлением. Команда certbot --nginx всё сделает за вас. Если у вас уже есть Cloudflare — SSL включается одной галочкой в настройках.

Третий шаг — настройка webhook в коде бота. В aiogram это делается одной функцией: bot.set_webhook. После этого Telegram начнёт отправлять сообщения на ваш URL вместо того, чтобы ждать опроса. Важно: перед установкой webhook удалите старый polling, иначе будет конфликт.

Четвёртый шаг — тестирование. Отправьте боту сообщение с разных аккаунтов. Проверьте, что все кнопки работают, callback обрабатываются, сообщения не теряются. Если что-то не работает — проверьте логи nginx и бота. Чаще всего проблема в неправильном URL или истёкшем SSL.

Пятый шаг — мониторинг. Настройте healthcheck каждые 5 минут. Uptime Robot делает это бесплатно. Sentry покажет ошибки в коде. Весь процесс занимает 1-2 часа для опытного разработчика и 3-4 часа для новичка. Стоимость: VPS от 300 ₽/мес плюс домен от 200 ₽/год. Это ничтожная цена за стабильность продакшен-бота.

Когда ваш бот вырастет до сотен и тысяч пользователей в день, одного сервера может не хватить. Но масштабирование webhook — не сложная задача, если правильно спланировать архитектуру с самого начала.

Первый уровень масштабирования — горизонтальное. Запустите несколько экземпляров бота за балансировщиком нагрузки. Nginx умеет распределять запросы между серверами. Telegram будет отправлять webhook на один URL, а nginx будет направлять запросы на разные экземпляры бота. Главное — использовать общее хранилище состояний (Redis), чтобы FSM работала корректно независимо от того, какой экземпляр обработал запрос.

Второй уровень — очереди сообщений. Если бот обрабатывает тяжёлые операции (генерация PDF, отправка email, работа с внешними API) — вынесите их в фоновые задачи. Webhook принимает сообщение, кладёт в очередь (Redis, Celery, RabbitMQ), и сразу отвечает Telegram. Фоновый worker обрабатывает задачу асинхронно. Это позволяет webhook обрабатывать 1000 сообщений в секунду, даже если каждая задача занимает 30 секунд.

Третий уровень — серверлесс. AWS Lambda или Яндекс.Функции позволяют запускать код только когда есть запрос. Нет запроса — нет расходов. Для ботов с неравномерной нагрузкой (утром 100 сообщений, днём 5, вечером 200) серверлесс экономит до 70% на хостинге. Но есть ограничения: холодный старт 1-2 секунды, лимит времени выполнения 15 минут.

Четвёртый уровень — CDN и кэширование. Если бот отдаёт статический контент (каталог товаров, FAQ, инструкции) — кэшируйте его через CDN. Это снизит нагрузку на сервер в 3-5 раз. Клиент в Москве получает контент за 20 мс вместо 200 мс.

Практический совет: начинайте с одного сервера и webhook. Масштабируйтесь только когда появится реальная нагрузка. 90% ботов никогда не вырастут больше 1000 пользователей в день. Не тратьте время и деньги на архитектуру для миллиона пользователей, если у вас 50.

Статьи по теме: - Aiogram vs Telebot vs python-telegram-bot — выбор фреймворка - Telegram бот на Python — руководство с кодом - Стоимость Telegram бота — 7 факторов - Разработка бота под ключ — полный цикл