Время ответа поддержки: по будням с 10:00 до 19:00 по Москве

Написать в поддержку ›

Webhooks — что это, как работают и где создать

Оглавление

На любом сайте, особенно с хорошим, активным трафиком, ежедневно происходит масса событий. Посетители регистрируются, закидывают товары в корзину, пишут отзывы, лайкают товары и т.д. Когда речь идет о собственном сервере, для отслеживания происходящего достаточно подключить систему мониторинга. Но в случае со сторонними сервисами этого сделать не получится. Никто не даст доступ к размещению скриптов, поэтому приходится пользоваться вебхуками.

Определение вебхука простыми словами

Сначала разберем, что означает термин. Технология Webhook – это метод отправки уведомлений пользователю онлайн-ресурса при условии, что на нем изменилась отслеживаемая информация. Например, появились новые отзывы или была скорректирована цена, остатки.

Заранее настроенная система создаст HTTP-вызов и отправит сведения заданному получателю через вебхук. Внутри сообщения обязательно присутствует тип события и ссылка на объект. Принимают их обычно автоматизировано, например, товарно-учетной системой.

Как работает webhook: принцип действия и примеры

Технически вебхук представляет собой программный код, состоящий из переменных и значений, им соответствующих. Глубоко вникать в принцип функционирования не требуется, настраиваются уведомления через удобный графический интерфейс.

Схема срабатывания веб-хука

Вот пример срабатывания вебхука, если пользователю нужно знать о новых комментариях:

  1. Посетитель ресурса публикует комментарий.
  2. Сообщение автоматически вносится в БД сервера.
  3. Хост обращается к URL настроенного вебхука.
  4. Клиенту отправляется уведомление о новой записи.

Все, что от него требуется при настройке, это указать вид уведомления и свой адрес. Категории для отслеживания практически ничем не ограничены. Главное, чтобы они представляли собой объект, подлежащий количественному учету.

Отличия API от вебхуков: что выбрать

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

Чтобы получить информацию с сайта через этот интерфейс, нужно обратиться к нему. Вебхуки же действуют по принципу подписки. Стоит однажды настроить уведомления и пользователю будут поступать сообщения без его участия, «на автомате».

Преимущества вебхуков проявляется в снижении нагрузки на сервер по сравнению с тем же API, потому что отправка событий осуществляется только по их наступлению, нет постоянной проверки статуса и т.п. Еще эта система не требует постоянного коннекта с сервером.

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

Когда использовать API, а когда вебхук: критерии выбора

Еще на решение влияет то, что вебхук способен только уведомить об изменениях в отслеживаемой системе. Ничего скорректировать или удалить через него не удастся.

Типовые варианты применения webhook:

  1. Сформировать заказ, обновить его статус.
  2. Изменить цену на товар вслед за производителем.
  3. Обновить контакты партнеров, поставщиков.

В Mailganer самые популярные вебхуки — email_status, email_meta и mail_status. Они мгновенно оповещают об изменениях в статусе подписчика, данных о подписчике и статусе конкретного письма соответственно. Например, если вы изменили данные подписчика через форму или импорт, вебхук автоматически передаст обновлённые значения в CRM. Информация обновится в реальном времени, и вам не придётся вручную заносить данные в CRM.

Чтобы полноценно работать с базами, нужен интерфейс API. В нем поддерживаются необходимые функции вроде создания, изменения, удаления информации.

Примеры использования webhook в реальных сервисах

Никаких особых ограничений по применению вебхуков не существует. Отслеживать при помощи них можно практически любое количество событий, поэтому систему часто используют крупные сервисы, работающие на многотысячную аудиторию.

Примеры пользователей:

  1. Github. Это веб-ресурс для хостинга IT-проектов любого масштаба. На нем нередко ведут совместную разработку удаленными командами. Компания при помощи вебхуков отсылает пользователям сведения о появлении новых релизов программ, сообщениях от коллег и пр.
  2. Мой склад. Отечественная складская система, включая функционал управления торговлей. Через систему вебхуков в ней отправляются уведомления об изменении статуса заказа или обновлении стоимости товаров, контактов контрагентов и т.д.
  3. Callibri. Система коллтрекинга. Оповещает пользователей о поступивших звонках, письмах, сообщениях в онлайн-чате, установленном на сайте.

Многие поставщики услуг вебхуков разрабатывают удобные графические интерфейсы для быстрой настройки параметров. Например, у Callibri достаточно ввести отслеживаемый URL, выбрать тип события и проставить галочки на информации, какую следует включать в сообщение.

Пользователю остается лишь настроить, например, CRM на получение сведений, их распределение внутри карточки клиента и реагировать на входящие. Минимум ручного труда при максимальной эффективности.

Как создать и настроить вебхук онлайн

Чтобы убедиться в удобстве вебхуков, достаточно воспользоваться сервисом доступным по адресу https://webhook.site/. На этом ресурсе легко за пару минут создать тестовый образец запроса.

Инструкция по созданию хука

Последовательность действий:

  1. Зайдите на сайт. Система автоматом сгенерирует уникальную ссылку вебхука.
  2. Скопируйте URL кликом по кнопке, расположенной рядом (страницу не закрывайте).
  3. Зайдите в раздел настроек на интересующем вас сайте и выберите опцию «Вебхук».
  4. Внесите скопированную ссылку в строку для URL открывшейся формы.
  5. Задайте значение «application/json» в поле «Тип контента» (Content Type).
  6. Сохраните вебхук и вернитесь на вкладку с сайтом webhook.site.

Если процедура проведена корректно, поставщик сведений отправит ответ на отправленный запрос. Тогда слева увидите оповещение, а справа детализированный отчет.

Как проверить работу вебхука

Проверяют работоспособность настроенного вебхука через тот же сервис, webhook.site. Это проще, чем пытаться сначала создать систему «с нуля».

Основные шаги:

  1. Зайдите на сайт и скопируйте ссылку из строки, включающей подпись Your unique URL.
  2. Создайте вебхук и в теге URL укажите только что сгенерированную проверочную ссылку (сделали шагом выше).
  3. Создайте новое событие на своем ресурсе. Например, введите его через JSON API. В итоге система должна уведомить об изменениях.

Такими задачами обычно занимаются технические специалисты. Но понимать функционал стоит и тем же маркетологам, чтобы полноценно использовать для решения своих задач.

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

Безопасность вебхуков: как защитить URL и данные

При работе с вебхуками желательно учитывать, что сведения они передают через «открытые» URL, а это риски перехвата или даже подмены информации.

Чтобы минимизировать негативные моменты, стоит придерживаться правил:

  1. Работайте через протокол HTTPS. Он поддерживает шифрование.
  2. Создавайте ссылки с уникальными идентификаторами, избегайте типовых фраз.
  3. Сотрудничайте с поставщиками, поддерживающими коды идентификации (типа HMAC).

Еще нередко используют доступ к вебхуку по технологии HTTP Basic Authentication. Это позволяет защитить систему путем запроса имени пользователя и пароля.

Часто задаваемые вопросы о вебхуках

В чём главное отличие вебхука от API простыми словами?

Ключевое отличие — кто инициирует обмен данными.

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

Вебхук работает по принципу «уведомления». Как только происходит событие (например, новый заказ), сервер сам отправляет вам данные на заранее указанный URL. Это как если бы друг сам звонил вам только тогда, когда что-то случилось.

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

Что значит слово «webhook» и как оно переводится?

Слово «webhook» происходит от двух английских слов: «web» (сеть, интернет) и «hook» (крючок, ловушка).

Буквально это можно перевести как «веб-крючок» или «сетевой перехватчик». Смысл в том, что вы как бы цепляете «крючок» к определённому событию на сервере. И как только это событие происходит, «крючок» срабатывает и отправляет вам уведомление.

В профессиональной среде чаще всего используют транслитерацию «вебхук», реже — «вэбхук». Встречаются также варианты «веб-хук» и просто «хук».

Зачем нужны вебхуки в маркетинге и email-рассылках?

В маркетинге вебхуки — это мощный инструмент автоматизации. Они позволяют связать разные сервисы в единую цепочку.

В email-маркетинге вебхуки чаще всего используют для:

  • Мгновенного обновления CRM при изменении статуса подписчика (например, новый email или отписка).
  • Автоматической отправки писем при наступлении события на вашем сайте (брошенная корзина, регистрация, день рождения).
  • Синхронизации данных между вашим интернет-магазином, сервисом рассылок и системой аналитики без участия программиста.

Главная ценность — вы получаете реакцию в реальном времени и можете строить сложные сценарии общения с клиентами, которые запускаются автоматически.

Как создать тестовый вебхук для проверки?

Самый простой способ — воспользоваться бесплатным сервисом webhook.site. Это позволяет проверить работу без написания кода.

Пошаговая инструкция:

  1. Перейдите на сайт webhook.site. Сервис автоматически сгенерирует для вас уникальный URL-адрес.
  2. Скопируйте этот URL и вставьте его в поле для вебхука в том сервисе, который вы настраиваете (например, в Mailganer, CRM или интернет-магазине).
  3. В настройках выберите событие, которое должно активировать вебхук (например, «Новая заявка»).
  4. Сохраните настройки и создайте тестовое событие на сайте.
  5. Вернитесь на страницу webhook.site. Если всё сделано верно, вы увидите входящий HTTP-запрос со всеми данными о событии слева, а справа — детальный отчёт (заголовки, тело запроса, IP-адрес).

Это безопасный способ проверить, что ваш вебхук работает корректно и данные передаются в нужном формате.

Надежны ли вебхуки и как защитить свои данные?

Вебхуки — это удобный, но не самый надежный способ передачи данных, если не соблюдать правила безопасности. Основные риски — перехват данных и потеря уведомления при сбое.

Как защитить свои вебхуки (рекомендации экспертов Mailganer):

  • Всегда используйте HTTPS. Это шифрует данные и защищает их от перехвата.
  • Используйте секретный ключ (HMAC). Сервис подписывает запрос, а ваш сервер проверяет подпись. Это гарантирует, что запрос пришел именно от доверенного источника, а не от злоумышленника.
  • Создавайте уникальные, сложные URL-адреса для вебхуков. Например, вместо /webhook используйте /webhook/a7d8f9g0h1j2. Это сделает ваш эндпоинт практически невидимым для посторонних.
  • Настройте повторные попытки (retry). Если ваш сервер временно недоступен, сервис должен повторить отправку через некоторое время, чтобы вы не потеряли важное уведомление.

В сервисах, мы всегда рекомендуем использовать проверку подписи для критичных интеграций.

Лена Шумная
Редактор Mailganer

Понятно пишет о сложных вещах в разъяснительной Mailganer. Работает с лендингами и подсказками внутри продукта. Делает рассылки компании и отвечает за новости в Телеграм-канале.

Стать автором блога Mailganer ›

14.11.2024
дата публикации
07.06.2026
дата последнего обновления