Гайды / Webhook: что это и как передать заявку с сайта

Webhook: что это и как передать заявку с сайта

Простыми словами: что такое webhook, когда он нужен, какие данные отправлять и как принимать события безопасно.

Что такое webhook

Webhook — это «обратный вызов»: когда происходит событие (например, отправка формы), сервис сам отправляет данные на ваш URL.

Это удобно, когда нет готовой интеграции или нужна своя логика обработки лидов.

Когда webhook нужен чаще всего

  • Кастомная CRM/таблица
  • Сложная маршрутизация лидов
  • Нужны дополнительные действия после заявки
  • Интеграции через промежуточный сервис

Какие данные стоит передавать

  • Контакт (телефон/email)
  • Страница и источник (UTM)
  • Сценарий/виджет
  • Комментарий/ответы квиза (если есть)

Как подключить (общая логика)

  • Подготовить URL приёмника (куда отправлять)
  • Настроить отправку в кабинете
  • Проверить тестовой заявкой
  • Добавить обработку ошибок/повторов

Безопасность

  • Секретный токен/подпись запроса
  • Проверка источника
  • Логи и контроль ошибок

FAQ

Нужен ли разработчик, чтобы принять webhook?

Если у вас уже есть система приёма (например, n8n/Make/сервер) — можно настроить без кода. Для собственной обработки иногда нужен разработчик.

Чем webhook отличается от API?

API вы вызываете сами, чтобы получить/отправить данные. Webhook приходит к вам автоматически при событии.

Что делать, если ваш сервер недоступен?

Нужны повторы, логирование и понятный мониторинг ошибок. Минимум — фиксировать ошибки и обрабатывать вручную.