Представьте, что вы ждёте посылку. Можно каждый час звонить в службу доставки и спрашивать, где она, — это опрос через API. А можно дождаться сообщения о том, что посылка приехала, — это вебхук.
Вебхук и API
| API | Вебхук | |
|---|---|---|
| Кто начинает | Ваша программа спрашивает | Сервис сам сообщает |
| Когда | По расписанию или по требованию | Сразу в момент события |
| Пример | Раз в час забрать новые заказы | Оплата прошла — заказ отмечен оплаченным |
На практике их используют вместе: вебхук сообщает о событии, а подробности программа забирает через API. Что такое API — в статье что такое API простыми словами.
Где вебхуки встречаются в бизнесе
- Платёжный сервис сообщает сайту об оплате — заказ меняет статус, клиенту уходит чек.
- Форма на сайте отправляет заявку в CRM и в мессенджер ответственного.
- CRM сообщает другой системе, что сделка перешла на новый этап.
- Служба доставки присылает изменения статуса отправления.
- Мессенджер передаёт боту новое сообщение клиента.
Что важно при настройке
- Проверка отправителя. Вебхук приходит на адрес вашей программы — нужно убедиться, что его прислал именно сервис, а не посторонний. Для этого используют секретный ключ или подпись.
- Повторы. Если ваша программа не ответила, сервис обычно отправляет уведомление снова. Программа должна понимать, что это то же событие, и не создавать дубль заказа.
- Недоступность. Если сервер лежал, часть уведомлений может потеряться — нужна сверка через API.
- Журнал. Сохраняйте полученные уведомления: так проще разобраться, почему что-то не сработало.
Нужно ли разбираться в этом владельцу бизнеса
Настраивают вебхуки разработчики, но заказчику полезно знать, что они есть. Выбирая платёжный сервис, CRM или службу доставки, спрашивайте, какие события она умеет отправлять вебхуками: от этого зависит, будут ли данные обновляться сами или вручную.
Интеграции между сайтом, CRM, оплатой и мессенджерами делаем в рамках направлений разработка и аналитика и CRM. Как это выглядит на примере оплаты — в статье как подключить оплату на сайте.
Частые вопросы
Вебхук — это программа?
Нет, это способ связи: сервис отправляет данные о событии на адрес, который вы указали.
Безопасны ли вебхуки?
Да, если программа проверяет подпись или секретный ключ отправителя и не доверяет любым входящим запросам.
Что делать, если вебхук не приходит?
Проверить адрес и доступность сервера, журнал отправки в сервисе и сертификат сайта. Потерянные события можно восстановить через API.
Нужна такая же реклама для вашего бизнеса?
Разберу нишу, посчитаю бюджет и покажу, из чего сложится цена заявки.
