Вебхук
Также: webhook, уведомление по событию
Способ передать данные другой системе сразу после события: сайт получил заявку — и тут же отправил её содержимое по заданному адресу, например в CRM или в мессенджер.
В отличие от периодической выгрузки, вебхук срабатывает мгновенно и не требует, чтобы принимающая сторона о чём-то спрашивала. Это самый простой способ связать сайт с внешним сервисом.
Что обычно передают вместе с заявкой
- Имя, телефон, почту и комментарий — то, что человек заполнил.
- Источник перехода: UTM-метки, иначе окупаемость не посчитать.
- Адрес страницы, с которой пришла заявка.
- Дату и время, а также факт согласия на обработку данных.
Чем отличается от API
| Вебхук | API | |
|---|---|---|
| Кто начинает обмен | отправитель по событию | запрашивающая сторона |
| Когда происходит | сразу после события | когда понадобилось |
| Типичное применение | заявка ушла в CRM | сайт запросил свободное время записи |
Что происходит при сбое
Принимающая сторона иногда недоступна: сервис на обслуживании, сменился адрес, закончилась подписка. Вебхук в этот момент просто не доходит. Если сайт нигде не сохраняет заявку, она исчезает бесследно — человек нажал кнопку, увидел «спасибо» и ждёт звонка, которого не будет. Это самый неприятный вид поломки, потому что снаружи всё выглядит рабочим.
Поэтому у надёжной схемы два уровня. Заявка сначала сохраняется на стороне сайта, и только потом отправляется дальше. Хорошие реализации ещё и повторяют отправку несколько раз с нарастающей паузой, а при окончательной неудаче помечают обращение как недоставленное — чтобы его можно было перенести руками.
Как проверить, что он настроен
- Отправьте тестовую заявку с сайта.
- Посмотрите, появилась ли она в принимающей системе — обычно за секунды.
- Проверьте, дошли ли метки источника, а не только имя и телефон.
- Убедитесь, что заявка при этом сохранилась и на самом сайте.
Частые вопросы
Что делать, если вебхук не сработал?
Проверить, сохранилась ли заявка на сайте — она обязана там быть. Если да, обращение просто переносят вручную, а причину сбоя ищут в настройках принимающей стороны: чаще всего меняется адрес или истекает ключ доступа.
Нужен ли программист, чтобы настроить вебхук?
Обычно нет: в конструкторах и CRM это поле, куда вставляют адрес, выданный принимающим сервисом. Программист нужен, если та сторона ждёт данные в своём формате или требует подписи запроса.
Безопасно ли отправлять заявки вебхуком?
Да, если адрес работает по https и его никто не знает, кроме вас. Дополнительно применяют секретный ключ в запросе, чтобы принимающая сторона отличала ваши обращения от подделанных.
Можно ли отправлять один вебхук в несколько мест?
Обычно да — многие платформы позволяют указать несколько адресов. Так делают, когда заявка нужна и в CRM, и в мессенджере отдела продаж одновременно.