--- title: セットアップ description: オンボーディング時にUnicoがHuman Token Webhookを設定するために必要な情報 — URL、認証、リトライ、同時実行数制限、タイムアウト。 canonical: https://developer.unico.io/ja/human-token/webhooks-and-events/setup locale: ja generated_by: markdown-export --- - [/ja/](/ja/) - 追加リソース - [Webhook とイベント](/ja/human-token/webhooks-and-events/) - セットアップ **このページの内容# セットアップ Unico チームが、連携のオンボーディング時に Webhook を設定します。 ### 必要な情報​ フィールド説明**通知URL**Unicoがイベント通知を配信するために呼び出すエンドポイント。HTTPSでアクセス可能である必要があります。**認証タイプ**Unicoがエンドポイントに対して認証する方法。以下のオプションを参照してください。**リトライ設定**最大試行回数と試行間隔（指数バックオフが適用されます）。**同時実行数制限**同時処理中の配信の最大数（最大: **500**）。**タイムアウト**エンドポイントのレスポンスの最大待機時間（秒単位）。**通知するステータス**通知をトリガーするプロセス状態のセット。現在は `PROCESS_STATE_FINISHED` に固定されており、この時点では設定変更はできません。 ### 認証方法​ **OAuth2**提供するもの: Webhookの`endpoint` OAuth2プロバイダーの`URL` OAuth2プロバイダーの`ClientId` OAuth2プロバイダーの`Secret` Unicoはクライアント認証情報を使用してプロバイダーURLからアクセストークンをリクエストし、Bearerトークンとしてエンドポイントに転送します。 **Basic Authorization**`user:pass`の形式で認証情報を提供してください。UnicはBase64でエンコードし、すべてのWebhook呼び出しの`Authorization: Basic `ヘッダーで送信します。 **API Key**2つの形式がサポートされています。文字列は**最初の**コロンで分割されます: `header:value` — カスタムヘッダー名を設定します。例: `X-API-Key:abc123` → `X-API-Key: abc123` `Authorization:Bearer abc123` → `Authorization: Bearer abc123` `value`のみ（コロンなし） — 値はスキームプレフィックスなしで`Authorization`ヘッダーとして送信されます。例: `abc123` → `Authorization: abc123`。 Bearerスキームが必要な場合は`header:value`形式を使用してください（例: `Authorization:Bearer `）。値のみの形式はプレフィックスなしで生の値を送信します。 **認証なし**認証情報は送信されません。開発環境のみで推奨されます。本番環境のエンドポイントは常に認証を要求する必要があります。 ### 通知をトリガーするプロセス状態​ 現在、Unicoはプロセスが以下の状態に遷移するたびに通知を送信します: 状態説明`PROCESS_STATE_FINISHED`プロセス完了 — 結果に関わらずの終端状態。 状態は変化する可能性がありますプラットフォームから通知される状態のセットは将来変更される可能性があります。エンドポイントが反応する状態を**設定可能**にしてください。そうすることで、新しい状態を追加する際にサービスの再デプロイが不要になります。 ### リクエスト形式​ Webhookの配信はエンドポイントへの**POST**リクエストです。ボディにはプロセス識別子と現在の状態が含まれます。 ``` { "processId": "8263a268-5388-492a-bca2-28e1ff4a69f0", "state": "PROCESS_STATE_FINISHED", "flow": "humantoken"} ``` `lastEvent` と `lastEventDescription`これら 2 つのフィールドは、**プロセスがユーザーのジャーニー完了前に期限切れになった場合のみ**ペイロードに表示されます。通常の完了ペイロードには含まれません。完全なスキーマと使用可能な `lastEvent` 値の一覧については、[イベントタイプ](/ja/human-token/webhooks-and-events/event-types)を参照してください。 ### 期待されるレスポンス​ エンドポイントは**同期的に**レスポンスを返す必要があります: **成功**: `200`〜`299`の範囲内の任意のHTTPステータス。 **失敗**: その他のステータス。Unicoは設定された最大試行回数まで、または`2xx`を受信するまで指数バックオフでリトライします。 速やかにレスポンスを返す設定されたタイムアウト内にWebhookを迅速に確認応答し（アクノリッジ）、ペイロードの処理は自社側で非同期に行ってください。Webhookハンドラー内での長時間の処理は、タイムアウトや不要なリトライの可能性を高めます。 冪等性とリトライ処理のガイダンスについては、[セキュリティ](/ja/human-token/webhooks-and-events/security)を参照してください。最終更新 2026年10月17日**に