Урок 4. Webhook — уведомления в реальном времени#
Зачем это нужно#
Webhook — это способ получать уведомления от сервиса, когда что-то произошло. Например, когда клиент оплатил заказ, платёжная система отправляет webhook вашему боту.
Ключевая идея#
Webhook = "позвони мне, когда что-то случится"
Вместо того чтобы постоянно спрашивать "а заказ оплачен?", вы даёте сервису свой адрес, и он сам вам сообщит.
Как работает webhook (аналогия)#
Обычный способ (polling):
Вы каждые 5 минут звоните в магазин: "Мой заказ готов?"
→ Тратите время и нервы
Webhook:
Вы говорите магазину: "Когда заказ будет готов, позвони мне на этот номер"
→ Магазин сам вам звонит, когда готово
Пример webhook в интеграции#
Сценарий: оплата через Stripe → уведомление в Telegram
-
Клиент оплачивает заказ на сайте (через Stripe)
-
Stripe отправляет webhook на ваш сервер:
- "Заказ #123 оплачен, клиент — Иван, сумма — 5000 руб."
-
Ваш сервер получает webhook и отправляет уведомление менеджеру в Telegram
-
Менеджер видит: "Новая оплата! Заказ #123, Иван, 5000 руб."
Webhook vs API#
| Характеристика | API (запрос) | Webhook (уведомление) |
|---|---|---|
| Кто инициирует | Вы спрашиваете сервис | Сервис сообщает вам |
| Когда срабатывает | Когда вы отправляете запрос | Когда происходит событие |
| Пример | "Покажи список заказов" | "Новый заказ создан" |
Что нужно для webhook#
-
URL для получения — адрес, куда сервис будет отправлять уведомления
Пример:
https://your-bot.com/webhook -
Настройка в сервисе — указать, какие события отправлять
Пример: "Отправлять webhook при новом заказе, оплате, отмене"
-
Обработчик webhook — код или автоматизация, которая реагирует на уведомление
Примеры использования webhook#
В бизнесе:
-
Клиент оплатил → отправить чек и начать выполнение заказа
-
Новая заявка на сайте → создать лид в CRM
-
Товар закончился на складе → уведомить менеджера
В AI-агентах:
-
Клиент написал боту → webhook активирует агента
-
Агент собрал данные → webhook отправляет их в CRM
-
Лид квалифицирован → webhook уведомляет менеджера