---
title: 이벤트 유형
description: Human Token 웹훅 이벤트 참조 — 페이로드 스키마 및 가능한 lastEvent 값.
canonical: https://developer.unico.io/ko/human-token/webhooks-and-events/event-types
locale: ko
generated_by: markdown-export
---

- [/ko/](/ko/)
- 추가 자료
- [웹훅 및 이벤트](/ko/human-token/webhooks-and-events/)
- 이벤트 유형

**이 페이지에서# 이벤트 유형

웹훅 페이로드는 프로세스 상태 전환을 설명합니다. 이 페이지에서는 페이로드 스키마와 `lastEvent` 값의 전체 목록을 문서화합니다.
### 페이로드 스키마​

필드유형설명`processId``string` (UUID)트랜잭션의 ID.`state``string`트랜잭션의 현재 상태. 현재: `PROCESS_STATE_FINISHED`.`flow``string`해당 트랜잭션에 대해 실행된 플로우 (예: `api+humantoken`, `api+liveness+humantoken`, `humantoken`, `humantoken+revalidation`, `api+liveness+humantoken+revalidation`).`lastEvent``string`트랜잭션의 마지막 이벤트. **사용자가 플로우를 완료하기 전에 프로세스가 만료된 경우에만 반환됩니다.**`lastEventDescription``string``lastEvent`에 대한 사람이 읽을 수 있는 설명. **사용자가 플로우를 완료하기 전에 프로세스가 만료된 경우에만 반환됩니다.**
상태 용어웹훅 페이로드의 `state` 필드는 `PROCESS_STATE_*` 접두사를 사용합니다. 이는 GetProcess 엔드포인트가 반환하는 `result` 및 `status` 필드(이 경우 `PROCESS_RESULT_*` 접두사 사용)와는 구별되는 용어입니다. 이 두 가지를 혼용하지 마세요.
### 페이로드 예시​

#### 완료됨 — 성공​

```
{  "processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",  "state": "PROCESS_STATE_FINISHED",  "flow": "humantoken"}
```

#### 완료됨 — 만료됨​

```
{  "processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",  "state": "PROCESS_STATE_FINISHED",  "flow": "humantoken",  "lastEvent": "EVENT_TYPE_SESSION_ENDED",  "lastEventDescription": "Session ended by timeout or by new session created"}
```

### lastEvent 열거형​

`lastEvent`에 나타날 수 있는 값의 전체 목록:
이벤트설명`EVENT_TYPE_PROCESS_CREATED`프로세스 생성됨`EVENT_TYPE_PROCESS_STARTED_BY_USER`사용자가 프로세스를 시작함`EVENT_TYPE_IDENTITY_VALIDATION_STEP_FINISHED`신원 확인 단계 완료됨`EVENT_TYPE_SESSION_ENDED`세션이 타임아웃으로 종료되었거나 새 세션이 생성됨
구성 가능한 처리이벤트 집합은 변경될 수 있습니다. 엔드포인트가 반응하는 이벤트는 하드코딩된 상수가 아닌 **구성**으로 처리하세요 — 그러면 새로운 이벤트를 배포 없이 활성화할 수 있습니다.
### 전체 프로세스 결과 읽기​

웹훅 페이로드는 프로세스가 완료되었음을 알리지만, 결과 자체는 포함하지 않습니다. 결과(캡처 데이터, 생체 인식 점수, 문서 필드 등과 함께)를 가져오려면 적절한 **GetProcess** 엔드포인트를 호출하세요. [프로세스 조회](/ko/human-token/api-reference/get-process)를 참조하세요.마지막 업데이트 2026년 10월 17일**에