Webhook — вебхук

Webhook — способ взаимодействия систем через HTTP-запрос. Часто одна система уведомляет другую о событии. В Битрикс24 входящий вебхук также обозначает адрес доступа к REST API с заданными правами.

Также встречается: Веб-хук, HTTP callback.

Для чего используется

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

Как SEO-специалист использует это в проекте

В SEO и автоматизации вебхуки связывают формы, CRM, отчёты и уведомления. Разработчик определяет проверку подлинности, формат, права и обработку повторной доставки.

Опишите событие и минимальные права.
Проверяйте подпись или другой предусмотренный источник доверия.
Сохраняйте событие и обрабатывайте повторы идемпотентно.

Практический пример

CRM сообщает об изменении статуса. Получатель проверяет запрос и сохраняет событие. Повтор с тем же ID не создаёт вторую оплату в аналитике.

Иллюстрация подхода, не данные конкретного проекта.

Ошибки и риски

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

Доверять любому входящему POST; публиковать токен; выполнять долгую обработку до подтверждения; считать HTTP 200 доказательством бизнес-успеха.

Как проверить результат

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

Связанные термины

Продолжить по теме

← Все термины