Webhooks

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:

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

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

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

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

{
  "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)

Introduction

Jobs

Applications

Configuração

Formato do Payload

Eventos Disponíveis

Job Created

Job Status Updated

Application Submitted

Application Stage Updated

Retry Policy

​Configuração

​Formato do Payload

​Eventos Disponíveis

​Job Created

​Job Status Updated

​Application Submitted

​Application Stage Updated

​Retry Policy

Configuração

Formato do Payload

Eventos Disponíveis

Job Created

Job Status Updated

Application Submitted

Application Stage Updated

Retry Policy