Лидпульт

Вебхук: что это

Вебхук — запрос, который система сама отправляет на заданный адрес, когда что-то произошло: пришла заявка, сменился статус. Вам не нужно постоянно спрашивать «есть ли новое».

Определение

Обычный обмен устроен как опрос: вы раз в минуту спрашиваете, нет ли новых данных. Вебхук работает наоборот: источник сам вызывает ваш адрес в момент события. Это быстрее и экономит ресурсы обеих сторон.

Пример из лидогенерации

В Лидпульте клиника указывает адрес вебхука своей CRM. Когда заявка принята и доставляется клинике, сеть отправляет туда данные. Если CRM не ответила или вернула ошибку 5xx, доставка повторяется до 8 раз с растущей паузой. Для проверки есть кнопка тестовой отправки и журнал отправок.

Нюансы

  • Адрес должен быть публичным: внутренние сети и localhost не принимаются, редиректы не выполняются.
  • Принимающая сторона должна отвечать быстро: тяжёлую обработку выносят в фон, иначе отправитель посчитает запрос неудачным.
  • Один и тот же вебхук может прийти повторно, поэтому обработчик должен быть идемпотентным.
  • Ответ 200 значит «получено», а не «обработано успешно».

Вебхук и постбэк

Для вебмастера аналогичный механизм называется постбэком: при приёме и смене статуса лида сеть вызывает адрес его трекера. По сути это тот же приём с другой целью.

Практический совет

Если вы сами принимаете вебхуки, держите обработчик простым: проверили данные, записали в очередь, ответили кодом 2xx. Всё тяжёлое делайте после ответа, иначе отправитель посчитает попытку неудачной и начнёт повторять.

Связанные понятия

Смотрите также повтор доставки, журнал отправок, идемпотентность и CRM-интеграцию. Общая схема — на странице «Как это работает».

Вопросы и ответы

Что делать, если CRM клиники не получает вебхуки?

Проверьте адрес, доступность из интернета и ответ сервера в журнале отправок. Потом отправьте тестовый запрос.

Чем вебхук отличается от API?

API вы вызываете сами, когда нужно. Вебхук вызывает вас система при наступлении события.