Вебхук — це HTTP-ендпоінт, який Telegram викликає автоматично при виникненні події: нове повідомлення боту, запит на вступ або підтвердження оплати. Замість того щоб ваш сервер постійно опитував Telegram API, Telegram надсилає оновлення на ваш ендпоінт у реальному часі. Autogram реєструє вебхук у Telegram, щоб отримувати оновлення, які запускають автоматизацію, обробляють коди верифікації та опрацьовують події каналу без накладних витрат на опитування.
Telegram доставляє оновлення лише на HTTPS-адресу і лише на короткий перелік дозволених портів. Одночасно можна зареєструвати секретний токен: Telegram повертає його в заголовку кожного запиту, і саме так отримувач відрізняє справжнє оновлення від підробленого POST на публічну адресу. Активним може бути тільки один спосіб доставки, тож щойно вебхук встановлено, довге опитування більше не повертає оновлень.
Telegram очікує відповідь 2xx. Будь-яка інша призводить до обмеженої кількості повторів, після чого оновлення відкидається — тож обробник, що падає на некоректному вмісті запиту, може втратити його назавжди. Оскільки оновлення надходять примусово, а не у відповідь на ваш запит, повільний обробник перетворюється на чергу: стандартне рішення — миттєво підтвердити прийом і одразу виконувати реальну роботу у фоновому воркері.
Вебхук можна звузити до конкретних типів оновлень, причому типовий набір навмисно пропускає кілька «галасливих» типів, які треба запитувати окремо. Звуження помітно зменшує трафік, але тихо приховує події, про які ви забули попросити. Коли автоматизація замовкає, першим ділом варто прочитати статус вебхука, який повертає API: він показує, скільки оновлень чекає на доставку, і текст останньої помилки.
Автоматизуйте публікацію в Telegram за допомогою ШІ-контенту, оцінки якості та розумного планування.