Skip to main content
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 Submitted

Disparado quando uma vaga é criada. Evento: job.submitted 
{
  "id": "msg_1234567890",
  "event": "job.submitted",
  "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)