01 Как работает
- В Telegram / Stripe / CRM регистрируете публичный URL вашего сервера.
- Когда событие — сервис делает HTTP POST на ваш URL с JSON-payload.
- Ваш сервер обрабатывает: создаёт задачу, отправляет в LLM, пишет в БД.
- Отвечаете 200 OK быстро (если нет — провайдер будет ретраить).
02 Примеры в AI-проектах
- Telegram bot. Сообщение от пользователя → webhook → LLM → ответ.
- Stripe. Оплата → webhook → обновить статус пользователя.
- Calendly. Бронь встречи → webhook → запись в CRM + Telegram-нотификация.
- GitHub. Push в main → webhook → деплой.
- Tally / Typeform. Новая форма → webhook → AI-обогащение лида → CRM.
03 Безопасность
- Verify signature. Большинство провайдеров подписывают webhook HMAC. Проверяйте подпись — иначе кто угодно подделает запрос.
- Идемпотентность. Один и тот же event может прийти дважды. Обрабатывайте без двойного эффекта.
- Rate limit. Защита от случайного шторма событий.
- Логирование. Сохраняйте все приходящие webhook — для отладки.
04 Локальная разработка
Для тестирования webhook на локальной машине нужен публичный URL. Стандарт — ngrok, cloudflared tunnel или localtunnel. Они пробрасывают локальный порт наружу через временный URL.