Вебхук: что это
Вебхук — запрос, который система сама отправляет на заданный адрес, когда что-то произошло: пришла заявка, сменился статус. Вам не нужно постоянно спрашивать «есть ли новое».
Определение
Обычный обмен устроен как опрос: вы раз в минуту спрашиваете, нет ли новых данных. Вебхук работает наоборот: источник сам вызывает ваш адрес в момент события. Это быстрее и экономит ресурсы обеих сторон.
Пример из лидогенерации
В Лидпульте клиника указывает адрес вебхука своей CRM. Когда заявка принята и доставляется клинике, сеть отправляет туда данные. Если CRM не ответила или вернула ошибку 5xx, доставка повторяется до 8 раз с растущей паузой. Для проверки есть кнопка тестовой отправки и журнал отправок.
Нюансы
- Адрес должен быть публичным: внутренние сети и localhost не принимаются, редиректы не выполняются.
- Принимающая сторона должна отвечать быстро: тяжёлую обработку выносят в фон, иначе отправитель посчитает запрос неудачным.
- Один и тот же вебхук может прийти повторно, поэтому обработчик должен быть идемпотентным.
- Ответ 200 значит «получено», а не «обработано успешно».
Вебхук и постбэк
Для вебмастера аналогичный механизм называется постбэком: при приёме и смене статуса лида сеть вызывает адрес его трекера. По сути это тот же приём с другой целью.
Практический совет
Если вы сами принимаете вебхуки, держите обработчик простым: проверили данные, записали в очередь, ответили кодом 2xx. Всё тяжёлое делайте после ответа, иначе отправитель посчитает попытку неудачной и начнёт повторять.
Связанные понятия
Смотрите также повтор доставки, журнал отправок, идемпотентность и CRM-интеграцию. Общая схема — на странице «Как это работает».
Вопросы и ответы
Что делать, если CRM клиники не получает вебхуки?
Проверьте адрес, доступность из интернета и ответ сервера в журнале отправок. Потом отправьте тестовый запрос.
Чем вебхук отличается от API?
API вы вызываете сами, когда нужно. Вебхук вызывает вас система при наступлении события.