Как работают getUpdates и setWebhook
Механизм long polling работает через метод getUpdates: приложение открывает исходящее HTTPS-соединение к серверам Telegram и ожидает появления новых событий. Так как приложение само выступает клиентом, серверу не требуются публичный IP-адрес, доменное имя или открытые входящие порты.
Вебхук настраивается с помощью метода setWebhook и меняет направление связи. При каждом действии пользователя Telegram выполняет входящий HTTPS POST-запрос на публичный эндпоинт вашего веб-сервера, передавая объект обновления в теле запроса.
Требования к сетевой инфраструктуре
Long polling прост в настройке для локальной разработки, тестирования и закрытых корпоративных контуров. Поскольку процессу требуются только исходящие сетевые вызовы, бот работает за межсетевыми экранами и NAT на рабочей станции без внешних туннелей и сертификатов.
Вебхук требует наличия доступного из интернета веб-сервера, доменного имени и валидного TLS-сертификата от доверенного центра сертификации либо сертификата, переданного при регистрации вебхука. Поддержание такой инфраструктуры требует контроля портов и своевременного обновления сертификатов.
Масштабирование и параллельная обработка
Горизонтальное масштабирование long polling требует координации процессов. Если несколько экземпляров бота с одним токеном попытаются одновременно опрашивать сервер, Telegram вернёт ошибку конфликта. Для распределения нагрузки обычно выделяют один процесс получения данных, который передаёт события во внутреннюю очередь воркеров.
Вебхуки естественно встраиваются в архитектуру веб-приложений. Входящие запросы можно балансировать между несколькими бэкенд-серверами стандартным балансировщиком. При этом сервис должен быстро отвечать на запросы или переносить обработку в асинхронную очередь, чтобы избежать задержек в очереди доставки.
Отказоустойчивость и потеря обновлений
В режиме long polling обновления остаются в очереди серверов Telegram до тех пор, пока бот явно не подтвердит их получение смещением идентификатора в следующем запросе. При сбое или перезапуске сервиса необработанные события сохраняются и запрашиваются повторно.
В случае вебхука сервер обязан подтвердить успешный приём входящего запроса. Если сервер недоступен или возвращает ошибку, Telegram повторяет попытки отправки с увеличивающимися интервалами. Длительный простой сервера может привести к временной приостановке отправки обновлений. Это одна из причин, по которым обновления об оплате обрабатывают идемпотентно, как описано в статье оплата в Telegram-боте.
Безопасность эндпоинта и secret_token
Поскольку эндпоинт вебхука открыт для внешнего интернета, сторонний отправитель может направить поддельный запрос, имитирующий событие Telegram. Ограничение по диапазонам IP-адресов серверов платформы не всегда надёжно, так как сетевые маршруты могут меняться.
При регистрации вебхука через setWebhook следует передавать параметр secret_token. Telegram отправляет этот токен в заголовке X-Telegram-Bot-Api-Secret-Token каждого запроса. Обработчик приложения должен проверять значение заголовка до анализа содержимого и отклонять неавторизованные вызовы. Проверку подписей вебхуков других сервисов разбираем в статье безопасность вебхуков.
Критерии выбора подходящего подхода
Оба метода полностью поддерживаются платформой, и выбор зависит от условий развёртывания и архитектурных ограничений: Когда транспорт выбран, следующий вопрос проектирования — состояние диалога; общая картина описана в статье Telegram-бот для бизнеса, а таких ботов мы разрабатываем и сопровождаем в рамках услуги разработка Telegram-ботов.
- Используйте long polling для этапа разработки, локальной отладки, служебных утилит и приложений в закрытых сетевых контурах без выделенного веб-сервера.
- Используйте вебхуки для сервисов с высокой плотностью входящих событий, бессерверных платформ и архитектур, интегрированных в готовый кластер веб-приложений.
- Разделяйте получение событий и выполнение бизнес-логики независимо от выбранного метода, сразу подтверждая доставку и передавая ресурсоёмкие задачи в фоновые процессы.