Что такое вебхук и как он работает
Вебхук (webhook, обратный вызов по HTTP) — Вебхук это автоматическое сообщение, которое сервис отправляет на заданный адрес в момент события: пришла заявка, изменился этап сделки, прошла оплата.
Представьте, что вы ждёте посылку. Можно каждые полчаса проверять трекинг, это похоже на опрос через API. А можно получить SMS в момент доставки, это вебхук. Сервис сам сообщает о событии, и никому не нужно постоянно спрашивать.
Технически это HTTP-запрос с данными (обычно в формате JSON), который сервис отправляет на указанный вами адрес. На этом адресе работает обработчик: скрипт, бот или сервис-посредник, который принимает данные и что-то с ними делает.
Примеры в маркетинге и продажах:
- форма на сайте отправляет вебхук в CRM, и создаётся сделка;
- amoCRM при переходе сделки на этап «Оплачено» отправляет вебхук, и в Метрику уходит офлайн-конверсия;
- платёжная система сообщает об оплате, и клиенту приходит доступ к курсу;
- Telegram отправляет боту вебхук на каждое новое сообщение;
- Битрикс24 по вебхуку запускает робота во внешней системе.
Пример цепочки. Клиент оставил заявку в квизе. Квиз отправил вебхук в CRM с ответами и UTM-метками. CRM создала сделку и отправила вебхук в Telegram-чат отдела продаж: «Новая заявка, кухня 3 метра, бюджет до 300 000, источник Директ». Менеджер звонит через две минуты.
Что важно учесть. Адрес вебхука надо защищать: если он утечёт, кто угодно сможет слать туда фейковые данные. Хорошо, когда обработчик проверяет подпись или секретный ключ. Если обработчик недоступен, часть сервисов повторяет отправку, а часть нет, и событие теряется. Поэтому нужны логи и мониторинг.
Частые ошибки. Вебхук ведёт на старый адрес после переезда сервера. Нет обработки дублей, и одна оплата создаёт две сделки. Никто не знает, где настроен вебхук, потому что его делал подрядчик три года назад. При внедрении мы записываем все вебхуки в схему интеграций, которую отдаём клиенту.