---
title: Webhookとイベント
description: IDCloud Webhookの概要 — ID確認プロセスイベントのリアルタイム通知を受信します。
canonical: https://developer.unico.io/ja/dual-api/developers/webhooks-and-events/
locale: ja
generated_by: markdown-export
---

**Webhook**とは、システム間の非同期統合を可能にするシステム通知サービスです — Unico IDCloudは、プロセスが状態を変化させるたびにバックエンドに通知するため、更新をポーリングする必要がありません。

このセクションでは、Webhookを統合するために必要な4つの事項を説明します: エンドポイントと認証の**設定**方法、Unicoが送信する**イベント**、**フォールバック戦略**、およびエンドポイントが実装しなければならない**セキュリティと信頼性**パターンです。

### Webhookを使用する場面

Webhookは、プロセスの完了を通知される推奨方法です。特に以下の場合に適しています:

- **ビジュアルフロー** (SDK / Web Redirect / iFrame) — ユーザーがジャーニーを完了したことを知るため。
- **非同期Web & SDKフロー** — `POST /client/v1/process`がUnicoの側で処理を完了したときに通知を受けるため。
- **複数の機能を組み合わせた長時間実行フロー** (例: ドキュメント分析 + 手動レビュー)。Webhookは終端状態 (`PROCESS_STATE_FINISHED`) のときのみ発火します。途中の進捗イベントは配信されません。

WebhookはGetProcessエンドポイントを補完しますが、置き換えるものではありません。[フォールバック](/developers/webhooks-and-events/fallback)を参照してください。

### このセクションの内容

- **[セットアップ](/developers/webhooks-and-events/setup)** — エンドポイントの登録、認証方法（OAuth2、Basic、APIキー）、リトライ設定。
- **[イベントタイプ](/developers/webhooks-and-events/event-types)** — Unicoが送信するイベントとペイロード構造。
- **[セキュリティ](/developers/webhooks-and-events/security)** — 冪等性、同時実行数制限、エラーレート。
- **[フォールバック](/developers/webhooks-and-events/fallback)** — Webhookが利用できない場合のプロセス結果の取得方法。