Вебхук — это HTTP-эндпоинт, который Telegram вызывает автоматически при возникновении события: новое сообщение боту, запрос на вступление или подтверждение оплаты. Вместо того чтобы ваш сервер постоянно опрашивал Telegram API, Telegram доставляет обновления на ваш эндпоинт в реальном времени. Autogram регистрирует вебхук в Telegram, чтобы получать обновления, запускающие автоматизацию, обрабатывать коды верификации и обрабатывать события канала без накладных расходов на опрос.
Telegram доставляет обновления только на HTTPS-адрес и только на короткий перечень разрешённых портов. Одновременно можно зарегистрировать секретный токен: Telegram возвращает его в заголовке каждого запроса, и именно так получатель отличает настоящее обновление от поддельного POST на публичный адрес. Активным может быть только один способ доставки, поэтому как только вебхук установлен, длинный опрос больше не возвращает обновлений.
Telegram ожидает ответ 2xx. Любой другой ответ приводит к ограниченному числу повторов, после чего обновление отбрасывается — и обработчик, падающий на некорректном содержимом запроса, может потерять его навсегда. Поскольку обновления приходят принудительно, а не в ответ на ваш запрос, медленный обработчик превращается в очередь: стандартное решение — мгновенно подтвердить приём и сразу выполнять реальную работу в фоновом воркере.
Вебхук можно сузить до конкретных типов обновлений, причём набор по умолчанию намеренно пропускает несколько «шумных» типов, которые надо запрашивать отдельно. Сужение заметно уменьшает трафик, но тихо скрывает события, о которых вы забыли попросить. Когда автоматизация замолкает, первым делом стоит прочитать статус вебхука, который возвращает API: он показывает, сколько обновлений ждёт доставки, и текст последней ошибки.
Автоматизируйте публикацию в Telegram с помощью AI-контента, оценки качества и умного планирования.