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
- HTTPS-адрес с валидным сертификатом.
setWebhookсsecret_token, проверка заголовка в обработчике.- Ответ 200 сразу, тяжёлая работа — в очередь.
- Идемпотентность по
update_id. - Логи входящих запросов и мониторинг
getWebhookInfo. - Отдельный тестовый бот и туннель для разработки.
Мы собираем Telegram-ботов и ботов для MAX сразу на webhook'ах, с очередью и защитой от повторов.
Если ваш бот подвисает или теряет сообщения, напишите в Telegram или MAX, посмотрим, в чём дело.