> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tallentu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Receba notificações em tempo real sobre eventos no seu workspace

Os webhooks permitem que você receba notificações HTTP POST em tempo real quando eventos específicos ocorrem no seu workspace da Tallentu.

## Configuração

Você pode configurar webhooks no painel de configurações do seu workspace. Ao criar um webhook, você deve fornecer uma URL de callback (endpoint) que receberá as requisições POST.

## Formato do Payload

Todos os webhooks são enviados com o seguinte formato padrão:

```json theme={null}
{
  "id": "uuid", // id único por evento
  "event": "nome.do.evento",
  "timestamp": "2023-10-27T10:00:00.000Z",
  "data": {
    // Dados específicos do evento
  }
}
```

## Eventos Disponíveis

### Job Created

Disparado quando uma vaga é criada.

**Evento:** `job.created`

```json theme={null}
{
  "id": "msg_1234567890",
  "event": "job.created",
  "timestamp": "2023-10-27T10:00:00.000Z",
  "data": {
    "job_id": "job_123"
  }
}
```

### Job Status Updated

Disparado quando o status de uma vaga é alterado.

**Evento:** `job.status.updated`

```json theme={null}
{
  "id": "msg_1234567890",
  "event": "job.status.updated",
  "timestamp": "2023-10-27T10:00:00.000Z",
  "data": {
    "job_id": "job_123",
    "status": "published",
    "previous_status": "draft"
  }
}
```

### Application Submitted

Disparado quando um novo candidato se inscreve em uma vaga.

**Evento:** `job_application.submitted`

```json theme={null}
{
  "id": "msg_1122334455",
  "event": "job_application.submitted",
  "timestamp": "2023-10-27T10:10:00.000Z",
  "data": {
    "job_id": "job_123",
    "candidate_id": "user_789"
  }
}
```

### Application Stage Updated

Disparado quando um candidato é movido para uma nova etapa no processo seletivo.

**Evento:** `job_application.stage.updated`

```json theme={null}
{
  "id": "msg_0987654321",
  "event": "job_application.stage.updated",
  "timestamp": "2023-10-27T10:05:00.000Z",
  "data": {
    "job_id": "job_123",
    "candidate_id": "user_456",
    "stage_id": "interview",
    "previous_stage_id": "triage"
  }
}
```

## Retry Policy

Se o seu endpoint retornar um status de erro (qualquer coisa diferente de 2xx) ou falhar ao responder dentro de 10 segundos, a Tallentu tentará reenviar o webhook com um backoff exponencial.

Os intervalos de retry são:

* 5 minutos
* 10 minutos
* 20 minutos
* 40 minutos
* 1 hora
* 2 horas
* 1 dia (repetido por 5 dias)