---
title: Вебхуки и события
description: Введение в вебхуки Human Token — получайте уведомления в реальном времени о завершении процесса.
canonical: https://developer.unico.io/ru/human-token/webhooks-and-events/
locale: ru
generated_by: markdown-export
---

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

В этом разделе рассматриваются четыре вещи, необходимые для интеграции вебхуков: как **настроить** эндпоинт и аутентификацию, **события**, которые отправляет Unico, **стратегия резервного варианта**, а также паттерны **безопасности и надёжности**, которые должен реализовывать ваш эндпоинт.

### Когда использовать вебхуки

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

- **Human Token Journey** (`humantoken`, `humantoken+revalidation`) — чтобы получить уведомление, когда пользователь завершает сценарий процесса, созданного через [Создать процесс](/ru/human-token/api-reference/post-processes). Вебхуки срабатывают только в конечном состоянии (`PROCESS_STATE_FINISHED`); промежуточные события прогресса не доставляются.
- **Потоки API Only** (`api+humantoken`, `api+liveness+humantoken`, `api+liveness+humantoken+revalidation`) — результат уже приходит в ответе [Создать процесс](/ru/human-token/api-reference/post-processes), поэтому эти потоки не зависят от вебхука.

Вебхуки дополняют, но не заменяют эндпоинты **GetProcess**. См. [Резервный вариант](/ru/human-token/webhooks-and-events/fallback).

### В этом разделе

- **[Настройка](/ru/human-token/webhooks-and-events/setup)** — регистрация эндпоинта, методы аутентификации (OAuth2, Basic, API Key), настройки повторных попыток.
- **[Типы событий](/ru/human-token/webhooks-and-events/event-types)** — события, которые отправляет Unico, и структура полезной нагрузки.
- **[Безопасность](/ru/human-token/webhooks-and-events/security)** — идемпотентность, ограничение параллелизма и частота ошибок.
- **[Резервный вариант](/ru/human-token/webhooks-and-events/fallback)** — как получить результат процесса при недоступности вебхука.