Webhook'и в Telegram-ботах — почему long-polling умер

getUpdates с polling всё ещё работает, но для проектов больше игрушки — это техдолг с первого дня. Объясняю почему.

У Telegram-бота есть два способа узнавать о новых сообщениях. Либо бот сам спрашивает Telegram «что нового?» через getUpdates, либо Telegram сам присылает каждое обновление POST-запросом на ваш адрес. Первое называется long polling, второе — webhook. Для учебного бота разницы почти нет. Для бота, которым пользуются клиенты, polling — техдолг с первого дня, и ниже объясню почему.

Как работает long polling

Бот отправляет запрос getUpdates с параметром timeout. Если обновлений нет, Telegram держит соединение открытым до конца таймаута, а как только приходит сообщение — сразу отвечает. Бот обрабатывает пачку, запоминает offset и снова встаёт в ожидание.

Частая ошибка — опрашивать без таймаута, раз в секунду, в цикле с sleep. Это уже не long polling, а обычный опрос: сотни пустых запросов в минуту и задержка до секунды на каждое сообщение. Правильно настроенный long polling отвечает быстро и почти не тратит процессор. Так что «polling жрёт ресурсы» — аргумент только против неправильного polling.

Настоящие минусы в другом:

  • Нужен процесс, который живёт всегда. Скрипт должен крутиться круглосуточно, его надо поднимать после падения и перезагрузки сервера, следить за памятью. Значит, systemd, supervisor или аналог, и кто-то, кто за этим смотрит.
  • Один получатель. Обновления может забирать только один процесс. Запустили второй экземпляр — они начинают конфликтовать. Масштабировать горизонтально неудобно.
  • Плохо ложится на PHP. Типичный PHP живёт по схеме «запрос пришёл — скрипт отработал — умер». Бесконечный цикл на PHP работает, но утечки памяти и зависшие соединения в нём всплывают быстрее, чем хотелось бы.
  • Одно медленное сообщение тормозит остальные. Если обработка идёт подряд, а на одном апдейте бот ждёт ответа внешнего API, остальные пользователи ждут вместе с ним.

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

Вы один раз вызываете setWebhook и передаёте HTTPS-адрес. С этого момента Telegram сам отправляет каждое обновление POST-запросом с JSON в теле. Ваш сервер отвечает кодом 200, и на этом всё. Пока событий нет, бот вообще ничего не делает.

Для PHP это родная модель: webhook — обычный HTTP-запрос, такой же, как открытие страницы сайта. Его обрабатывает тот же веб-сервер, никаких демонов. Нагрузка выросла — webhook масштабируется так же, как сайт. Один обработчик может обслуживать несколько ботов, если разводить их по адресам.

Что нужно для webhook'ов

  • HTTPS. Telegram шлёт обновления только на HTTPS и только на определённые порты, список есть в документации к setWebhook. Бесплатного сертификата Let's Encrypt достаточно.
  • Секретный токен. В setWebhook можно передать secret_token, и Telegram будет присылать его в заголовке X-Telegram-Bot-Api-Secret-Token. Проверяйте его на каждом запросе, иначе любой, кто узнал адрес, сможет слать вашему боту поддельные апдейты.
  • Быстрый ответ. Если сервер не ответил или вернул ошибку, Telegram попробует доставить обновление ещё раз, а новые будут копиться в очереди. Поэтому тяжёлую работу — запросы к CRM, генерацию файлов, обращения к нейросети — выносите в очередь и отвечайте 200 сразу.
  • Защита от повторов. Из-за повторной доставки одно обновление может прийти дважды. Запоминайте update_id и не обрабатывайте его второй раз, особенно если речь об оплате или создании заказа.

Для отладки есть getWebhookInfo: он показывает, сколько обновлений ждёт в очереди и текст последней ошибки доставки. Когда «бот перестал отвечать», это первое, что стоит проверить.

Локальная разработка

Главный аргумент за polling — удобство на ноутбуке: не нужен публичный адрес. Но это решается туннелем: ngrok, Cloudflare Tunnel или аналог дают временный HTTPS-адрес, который ведёт на локальную машину. Ещё проще — завести отдельного тестового бота и держать webhook только на нём, чтобы не трогать боевого.

Помните, что режимы взаимоисключающие: пока webhook установлен, getUpdates вернёт ошибку. Чтобы вернуться к polling, webhook надо удалить через deleteWebhook.

Когда polling всё-таки уместен

Умер он не совсем. Polling нормален для прототипа, который нужно показать сегодня, для бота на машине за NAT без публичного адреса и для внутреннего бота на пять человек, где упасть на полчаса не страшно. Если бот работает с клиентами, принимает заявки или деньги, выбирайте webhook с самого начала. Переезд потом стоит дороже, чем кажется: меняется не только способ получения апдейтов, но и вся схема запуска и обработки.

В ботах для MAX выбор тот же: у платформы свой Bot API, но и там есть подписка на webhook и опрос, и аргументы те же. Если ботов несколько или события приходят не только из мессенджеров, но и из CRM и платёжных систем, удобно поставить перед ними один webhooks-шлюз, который принимает, проверяет и раскладывает события по очередям.

Чек-лист перехода на webhook

  1. HTTPS-адрес с валидным сертификатом.
  2. setWebhook с secret_token, проверка заголовка в обработчике.
  3. Ответ 200 сразу, тяжёлая работа — в очередь.
  4. Идемпотентность по update_id.
  5. Логи входящих запросов и мониторинг getWebhookInfo.
  6. Отдельный тестовый бот и туннель для разработки.

Мы собираем Telegram-ботов и ботов для MAX сразу на webhook'ах, с очередью и защитой от повторов.

Если ваш бот подвисает или теряет сообщения, напишите в Telegram или MAX, посмотрим, в чём дело.

Telegram-бот
Услуга по теме — обсудим ваш проект.

Есть задача по теме? Напишите — вернёмся с оценкой и сроками.

Написать в Telegram → Написать в MAX