К содержимому
4 мин чтения

Webhook Telegram-бота: чем он отличается от long polling

Webhook Telegram-бота — это способ, при котором Telegram сам присылает новые сообщения на адрес вашего сервера, а не ждёт, пока бот за ними придёт. Второй способ — long polling: бот сам спрашивает Telegram, есть ли что-то новое. Оба варианта рабочие, но подходят для разных задач. Разберём, как они устроены, как настроить webhook, какие ошибки ломают бота и что выбрать для бизнеса.

Как Telegram-бот получает сообщения

Любое действие пользователя — сообщение, нажатие кнопки, оплата — Telegram превращает в объект update и кладёт в очередь вашего бота. Забрать очередь можно двумя способами: методом getUpdates (long polling) или методом setWebhook. Эти способы взаимоисключающие: пока установлен webhook, getUpdates возвращает ошибку, и наоборот.

Если бот временно недоступен, Telegram хранит необработанные обновления не дольше 24 часов. Простой сервера на сутки и больше означает потерянные сообщения и заявки клиентов, а для бизнеса это прямые убытки.

Long polling: когда он подходит

При long polling ваш код вызывает getUpdates с параметром timeout. Telegram держит соединение открытым, пока не появится новое сообщение или не истечёт время, затем отвечает, и бот сразу делает следующий запрос. Нужен только выход в интернет: ни домена, ни SSL-сертификата, ни открытых портов.

Поэтому polling удобен для разработки на ноутбуке, тестов и небольших внутренних ботов. Минусы: процесс должен работать постоянно; если запущены две копии бота, они конфликтуют и появляется ошибка 409 Conflict; при росте нагрузки один процесс разбирает обновления по очереди, и ответы замедляются.

Webhook Telegram-бота: как настроить по шагам

При webhook Telegram отправляет каждое обновление POST-запросом на ваш HTTPS-адрес. Нужны домен с действующим сертификатом, один из портов 443, 80, 88 или 8443 и обработчик, который быстро отвечает кодом 200.

Порядок такой. Первое: поднимите HTTPS-адрес, например /bot/webhook, и убедитесь, что он открывается снаружи. Второе: вызовите setWebhook с параметрами url и secret_token — случайной строкой. Третье: в обработчике сверяйте заголовок X-Telegram-Bot-Api-Secret-Token с вашим секретом и отбрасывайте чужие запросы. Четвёртое: отвечайте 200 сразу, а тяжёлую работу — запись в CRM, оплату, рассылку — выносите в очередь или фоновую задачу. Пятое: проверьте результат методом getWebhookInfo.

В ответе getWebhookInfo смотрите pending_update_count, last_error_date и last_error_message: они показывают, сколько обновлений ждёт и почему Telegram не смог доставить. При ошибках Telegram повторяет попытки, поэтому после починки сервера очередь разберётся сама. Параметр max_connections ограничивает число одновременных соединений, по умолчанию их 40.

Типичные ошибки и чек-лист перед запуском

Чаще всего бот ломается из-за одного из пяти пунктов: просрочен сертификат или не установлена цепочка промежуточных; webhook задан, а в коде запущен polling, и бот молчит или получает 409; обработчик отвечает слишком долго, потому что ждёт CRM или платёжную систему; секрет не проверяется, и на адрес может прийти поддельный запрос; файрвол или прокси блокирует запросы Telegram.

Чек-лист: домен открывается по HTTPS без предупреждений браузера; getWebhookInfo показывает пустой last_error_message; обработчик идемпотентен, то есть повторный update с тем же update_id не создаёт вторую заявку; входящие запросы логируются; токен бота лежит в переменных окружения, а не в репозитории; настроено оповещение, если pending_update_count растёт.

При возврате с webhook на polling сначала вызовите deleteWebhook. Параметр drop_pending_updates сбрасывает накопленную очередь, но используйте его осознанно: в очереди могут лежать сообщения живых клиентов.

Частые вопросы

Можно ли использовать webhook и polling одновременно? Нет. Пока webhook установлен, getUpdates не работает. Чтобы вернуться к polling, вызовите deleteWebhook.

Нужен ли свой домен? Telegram принимает и IP-адрес с самоподписанным сертификатом, который загружается вместе с setWebhook, но для рабочего бота проще домен с обычным сертификатом.

Что будет, если сервер упадёт? Telegram будет повторять доставку, но хранит необработанные обновления не дольше 24 часов. Если простой дольше, сообщения потеряются.

Какие порты разрешены? Для webhook это 443, 80, 88 и 8443.

Что надёжнее для рабочего бота? Для бота с клиентами обычно выбирают webhook за HTTPS с мониторингом, а polling оставляют для разработки и тестов.

Что выбрать и из чего складывается цена

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

Стоимость определяет не вызов setWebhook, он занимает минуты, а окружение: сервер или хостинг (ориентир — 50 000–300 000 сум в месяц для небольшого бота), домен и сертификат, очередь фоновых задач, логи и мониторинг, интеграции с CRM и оплатой. Отдельная настройка и проверка webhook-обработчика у частного разработчика — ориентир 500 000–1 500 000 сум. По срокам сам webhook поднимается за день, а с тестами и интеграциями — за несколько дней.

4 Digital разрабатывает Telegram-ботов в Ташкенте, стоимость — от 999 000 сум. Webhook, очередь и мониторинг закладываем в проект сразу, чтобы бот не терял заявки. Напишите нам, и мы подскажем, какой вариант подойдёт вашему бизнесу.

Нужен сайт или реклама? Обсудим ваш проект.

Разработка телеграм ботов · от 999000 сум

Ответим за 15 минут в рабочее время. Без спама.