---
title: Tipos de evento
description: Referência dos eventos de webhook do Human Token — schema do payload e valores possíveis de lastEvent.
canonical: https://developer.unico.io/pt-BR/human-token/webhooks-and-events/event-types
locale: pt-BR
generated_by: markdown-export
---

- [/pt-BR/](/pt-BR/)
- Recursos adicionais
- [Webhooks e Eventos](/pt-BR/human-token/webhooks-and-events/)
- Tipos de evento

**Nesta página# Tipos de evento

Os payloads de webhook descrevem uma transição de estado de processo. Esta página documenta o schema do payload e a enumeração completa dos valores de `lastEvent`.
### Schema do payload​

CampoTipoDescrição`processId``string` (UUID)ID da transação.`state``string`Estado atual da transação. Atualmente: `PROCESS_STATE_FINISHED`.`flow``string`Fluxo executado para esta transação (ex.: `api+humantoken`, `api+liveness+humantoken`, `humantoken`, `humantoken+revalidation`, `api+liveness+humantoken+revalidation`).`lastEvent``string`Último evento da transação. **Retornado apenas quando o processo expirou antes de o usuário concluir o fluxo.**`lastEventDescription``string`Descrição legível de `lastEvent`. **Retornado apenas quando o processo expirou antes de o usuário concluir o fluxo.**
Vocabulário de statusO campo `state` nos payloads de webhook usa o prefixo `PROCESS_STATE_*`. Este é um vocabulário distinto dos campos `result` e `status` retornados pelo endpoint GetProcess, que utilizam `PROCESS_RESULT_*`. Não os trate como intercambiáveis.
### Exemplo de payload​

#### Finalizado — com sucesso​

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

#### Finalizado — expirado​

```
{  "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"}
```

### Enumeração de lastEvent​

A lista completa de valores que podem aparecer em `lastEvent`:
EventoDescrição`EVENT_TYPE_PROCESS_CREATED`Processo criado`EVENT_TYPE_PROCESS_STARTED_BY_USER`Processo iniciado pelo usuário`EVENT_TYPE_IDENTITY_VALIDATION_STEP_FINISHED`Etapa de validação de identidade concluída`EVENT_TYPE_SESSION_ENDED`Sessão encerrada por timeout ou por nova sessão criada
Tratamento configurávelO conjunto de eventos pode evoluir. Trate os eventos aos quais seu endpoint reage como **configuração**, não como constantes fixas no código — dessa forma, novos eventos podem ser habilitados sem um novo deploy.
### Lendo o resultado completo do processo​

O payload do webhook sinaliza que um processo foi finalizado, mas não inclui o resultado em si. Para recuperar o resultado — junto com dados de captura, pontuações biométricas, campos do documento, etc. — chame o endpoint **GetProcess** apropriado, consulte [Obter Processo](/pt-BR/human-token/api-reference/get-process).Última atualização em 17 de out. de 2026**