Top.Mail.Ru
Заказная разработка
SeedKit
Робототехника
Заказная разработка
SeedKit
Робототехника
Этот сайт использует cookie для хранения данных. Продолжая использовать сайт, Вы даете согласие на работу с этими файлами
давайте
обсудим ваш будущий
проект
18 Ноября, 2026

Вебхуки: что это такое и как они работают

В этой статье вы узнаете:

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

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

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

Наши популярные услуги

Как работает вебхук

Для работы вебхука нужны две стороны:
  • Источник — сервис, где происходит событие: например, платежная система или CRM.
  • Получатель — сайт или приложение, которое должно узнать о событии и обработать его.
Перед настройкой получатель предоставляет специальный URL — эндпоинт. Его указывают в настройках источника вместе с событиями, о которых нужно сообщать. Когда такое событие происходит, источник обычно отправляет на эндпоинт HTTP-запрос с данными.

Например, покупатель оплачивает заказ в интернет-магазине:
  1. Платежная система фиксирует успешную оплату.
  2. Она отправляет вебхук на адрес магазина.
  3. Сервер магазина проверяет отправителя и данные.
  4. Магазин обновляет статус заказа и может передать информацию в CRM.
  5. Сервер отвечает, что запрос принят.
Вебхук обычно передает информацию о событии в теле HTTP-запроса, часто в формате JSON. В запросе также могут быть заголовки с типом события, идентификатором доставки или подписью. Точный формат зависит от сервиса, который отправляет уведомление.

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

Вебхук и API: в чем разница

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

Способ

Кто начинает обмен

Когда подходит

API-запрос

Ваше приложение обращается к другому сервису

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

Опрос API (polling)

Ваше приложение регулярно проверяет, появились ли изменения

В сервисе нет вебхуков или допустима периодическая проверка

Вебхук

Сервис-источник сам отправляет уведомление при событии

Нужно автоматически узнавать о конкретных изменениях


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

Эти способы можно сочетать. Вебхук сообщает, что произошло событие, а затем приложение делает API-запрос, чтобы получить дополнительные сведения. Такой подход удобен, если в уведомлении передается только краткая информация.

Для чего нужны вебхуки

Вебхуки используют для автоматизации действий, которые должны происходить после события. Например:
  • передавать новую заявку с сайта в CRM;
  • обновлять в магазине статус заказа после оплаты;
  • сообщать складу о новом заказе или возврате;
  • запускать приветственное письмо после подписки;
  • уведомлять команду о новом коммите в репозитории;
  • передавать информацию о сбое или изменении статуса задачи;
  • синхронизировать данные между приложениями.
Вебхук не создает интеграцию сам по себе. В сервисе-источнике должна быть предусмотрена отправка вебхуков, а на стороне получателя должен работать обработчик — программа, которая принимает запрос, проверяет его и выполняет нужные действия.

Преимущества и ограничения вебхуков

Вебхук помогает получать уведомления по событию, а не тратить ресурсы на регулярные проверки. Это может ускорить реакцию связанных систем и убрать часть ручных операций.
У такого способа есть ограничения:
  • вебхук доступен только для событий, которые предусмотрел сервис-источник;
  • получателю нужен доступный сетевой адрес и обработчик запросов;
  • формат и состав данных задает отправитель;
  • уведомление может не дойти из-за ошибки сети или недоступности сервера;
  • отправитель может повторить запрос, поэтому получатель должен быть готов к дублям;
  • частые или объемные сообщения могут создать нагрузку.
Условия доставки, таймауты и повторные попытки отличаются у разных провайдеров. Например, документация GitHub отдельно описывает проверку подписи, быстрый ответ сервера и повторную доставку пропущенных уведомлений. Поэтому эти параметры нужно проверять в документации конкретного сервиса.

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

Общий порядок настройки выглядит так:
  1. Определить событие. Решить, какое изменение должно запускать действие: новая заявка, успешная оплата, смена статуса.
  2. Проверить возможности источника. Убедиться, что сервис поддерживает вебхуки и нужный тип события.
  3. Подготовить эндпоинт. Создать адрес, который доступен источнику и принимает запросы нужного формата.
  4. Настроить подписку. Указать URL и выбрать события в панели или API источника.
  5. Обработать запрос. Проверить его, определить тип события и выполнить нужное действие.
  6. Протестировать сценарии. Проверить успешный запрос, некорректные данные, повторную доставку и временную недоступность получателя.
  7. Настроить контроль. Записывать ошибки и следить за историей доставок, если источник предоставляет такую возможность.
Для первичной проверки можно использовать тестовый URL-сервис, который показывает заголовки и тело входящих запросов. Так разработчик увидит, какие именно данные отправляет источник. Не передавайте через открытые тестовые страницы реальные персональные, платежные или другие чувствительные данные.

Как защитить вебхуки

Эндпоинт вебхука доступен извне, поэтому нельзя считать любой пришедший запрос доверенным. Для защиты интеграции рекомендуется:
  • использовать HTTPS;
  • проверять подпись запроса с помощью секрета, если источник это поддерживает;
  • проверять тип события и обязательные поля до обработки;
  • не хранить секреты в открытом коде и не передавать их в URL;
  • принимать только необходимые типы событий и данные;
  • ограничивать доступ по IP, если источник публикует актуальные адреса отправителей;
  • сохранять идентификатор доставки и не выполнять одно событие повторно;
  • вести журнал ошибок, не записывая в него лишние персональные данные.
Проверка подписи помогает убедиться, что запрос пришел от ожидаемого источника и не был изменен. Защиту от повторной обработки обычно строят на идентификаторе события или доставки: если тот же запрос пришел снова, обработчик распознает его и не повторяет действие. GitHub также рекомендует проверять подпись и использовать идентификатор доставки при обработке вебхуков.

Что делать, если вебхук не работает

Начните с проверки адреса и настроек:
  • доступен ли URL извне и указан ли он без ошибки;
  • выбран ли нужный тип события;
  • отправляет ли источник запрос и какой код ответа получает;
  • совпадает ли ожидаемый формат данных с тем, который фактически пришел;
  • проходят ли проверку подпись и обязательные поля;
  • не превышает ли обработчик допустимое время ответа;
  • видна ли ошибка в журнале доставок источника или на стороне получателя.
Если событие важно для бизнеса, заранее решите, как восстановить данные после сбоя. Это может быть повторная отправка в панели сервиса, сверка статусов через API или очередь необработанных событий. Сам по себе вебхук не гарантирует доставку.

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

Кратко

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

Дочитали статью?

Для вас бонус — аудит сайта или системы в подарок.

Оставьте заявку и увидите, где сайт теряет клиентов и как это исправить