creating an application
Essa documentação se refere ao glossário do endpoint de criação de aplicações à uma vaga (método POST)
Endpoint do escopo de Applications
Create Application - Cria uma aplicação (candidatura) a partir de uma vaga e um candidato. Pode criar a candidatura utilizando o id do candidato (quando o candidato já está cadastrado em alguma vaga na Gupy) ou fazendo uma inserção manual do candidato (quando ainda não existe informação sobre o candidato).
Logo, se passarmos o candidateId **_não preencheremos o _manualCandidate** e vice-versa.
Todo candidato inserido manualmente em uma vaga através da plataforma receberá um e-mail de convite para essa vaga, é necessário que o candidato aceite o convite clicando no link enviado pelo e-mail, só assim seus dados ficarão disponíveis na candidatura.
Se você está realizando a inserção manual através desse endpoint, é necessário utilizar o serviço Invite the candidate para enviar o convite ao candidato.
Abaixo, temos os campos que podem ser preenchidos na criação de uma vaga via API
CAMPO BACKEND | OPÇÕES NO BACKEND | CAMPO NO FRONTEND | Observações |
---|---|---|---|
jobId | Número gerado automaticamente pela Gupy ao criar uma vaga (conhecido como jobId). Ao abrir uma vaga na plataforma, o Id pode ser identificado na URL após /companies/jobs/ | Retorno results.id ao criar uma vaga utilizando o endpoint creating a job | |
notes | Anotações no perfil da pessoa candidata | ||
candidateId | Id gerado automaticamente pela plataforma quando uma pessoa realiza o cadastro em qualquer vaga da Gupy e assim adentra a base de dados. | ||
manualCandidate.name | Nome do candidato | ||
manualCandidate.lastName | Sobrenome do candidato | ||
manualCandidate.email | Ao acessar uma vaga é o botão "Adicionar" logo acima das etapas da vaga. O primeiro campo que aparecerá para inserir será o e-mail do candidato. | Caso o e-mail já exista na base da Gupy, será gerado um erro na tentativa de criá-lo (statusCode 409). Neste caso, será retornado o candidateId e a partir dele, você pode fazer uma nova chamada para criar a candidatura para a vaga | |
manualCandidate.mobileNumber | Telefone celular do candidato | ||
manualCandidate.linkedinProfileUrl | Link para o perfil do candidato no LinkedIn (se houver) | ||
manualCandidate.insertionSource | candidate_active_contact, events hunting, market_referral_consulting employee_referral, chrome_extension | Fonte da inserção manual do candidato. |
Updated over 1 year ago