Um passo crucial na sua experiência com a Gupy é a abertura de vagas. Pensando em automatizar o trabalho dos responsáveis por essa etapa (sendo eles gestores ou recrutadores), temos a funcionalidade de templates de vagas, que são modelos previamente criados e salvos na sua plataforma. Eles podem ser utilizados por qualquer colaborador da sua empresa, no momento de abertura de uma nova vaga.

Ao criar uma vaga na Gupy, você pode se deparar com as seguintes situações:

• Há perguntas, etapas e textos de outras vagas que você desejaria replicar sempre;
• Há descrições de cargos bem escritas que você gostaria de usar como referência;
• Há algumas padronizações dentro do processo da sua empresa que você gostaria que já estivessem pré-definidas na Gupy;

Para todos os cenários, você pode recorrer aos templates de vagas. Utilizando-os como base para a criação de vagas.

Gerando token

No momento de gerar o token habilite os seguintes endpoints da V1:

• Company Branches
• Company Departments
• Jobs
• Job Roles
• Job Templates

Fluxo de Integração

1. Acesse o endpoint GET Job Templates para buscar o id do template que deseja vincular à vaga. Caso o template utilizado seja sempre o mesmo, pode ser um campo fixo em seu código.
   O template pode ser encontrado através de:

• name: nome do template
• roleId: roleId (retorno da consulta à API Listing Roles) pode ser utilizado para fazer a busca pelo template que está atrelado a um determinado cargo.

Exemplo de requisição (por nome)

curl --request GET \
     --url 'https://api.gupy.io/api/v1/job-templates?name=%5BVAGA%20MODELO%5D%20Coordenador%28a%29%20de%20Conte%C3%BAdo&perPage=10&page=1' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXX'

Exemplo de resposta

{
  "results": [
    {
      "id": 3640152,
      "name": "[VAGA MODELO] Analista de Integrações",
      "type": "vacancy_type_effective",
      "departmentId": 21021,
      "departmentName": "Administrativo (Adm.)",
      "roleId": 62872,
      "roleName": "Analista Teste Z",
      "branchId": null,
      "branchName": null,
      "createdAt": "2022-12-07T14:07:36.086Z",
      "updatedAt": "2023-07-04T18:06:55.735Z"
    }
  ],
  "totalResults": 1,
  "page": 1,
  "totalPages": 1
}

🚧

Atenção na busca pelo nome

A API faz uma busca de templates que contém o nome pesquisado, portanto, se o template estiver com a descrição, por exemplo, "ASSISTENTE I" e "ASSISTENTE II", caso seja incluído "ASSISTENTE I"; no campo name, a API vai retornar "ASSISTENTE I"; e "ASSISTENTE II"

É importante testar os cenários de diferentes cargos para evitar puxar o template incorreto.

2. Com o id em mãos, faça a requisição para a API POST Jobs, adicionando o campo templateId em sua requisição.

Exemplo de requisição:

curl --request POST \
     --url https://api.gupy.io/api/v1/jobs \
     --header 'accept: application/json' \
     --header 'authorization: Bearer XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXX' \
     --header 'content-type: application/json' \
     --data '
{
     "name": "Analista de Integrações",
     "type": "vacancy_type_effective",
     "numVacancies": 2,
     "departmentId": 4767,
     "roleId": 9452,
     "templateId": 3640152
}
'

Exemplo de resposta:

{
  "id": 4146770,
  "code": "483",
  "name": "Analista de Integrações",
  "status": "draft",
  "type": "vacancy_type_effective",
  "publicationType": "internal",
  "numVacancies": 1,
  "departmentId": 4767,
  "departmentName": "Administrativo (Adm.)",
  "roleId": 9452,
  "roleName": "Analista Teste Z",
  "subsidiaryId": 2743,
  "subsidiaryName": "MATRIZ",
  "createdAt": "2023-02-17T14:18:46.719Z",
  "updatedAt": "2023-02-17T14:18:46.969Z",
  "hiringDeadline": null,
  "description": "Descrição da vaga",
  "responsibilities": "Funções da vaga",
  "prerequisites": "Pré-requisitos para se candidatarem à vaga",
  "additionalInformation": "informações adicionais sobre a vaga",
  "notes": "Notas sobre a vaga",
  "disabilities": true,
  "addressStreet": "Avenida Paulista",
  "addressNumber": "1234",
  "addressCity": "São Paulo",
  "addressState": "São Paulo",
  "addressStateShortName": "SP",
  "addressCountry": "Brasil",
  "addressCountryShortName": "BR",
  "addressZipCode": "38043873",
  "addressLatitude": null,
  "addressLongitude": null,
  "remoteWorking": false,
  "reason": "staff_increase",
  "image": null,
  "socialMediaImage": null,
  "applicationDeadline": null,
  "careerPageId": null,
  "careerPageName": null,
  "vacancyCodes": [],
  "managerId": null,
  "managerName": null,
  "managerEmail": null,
  "recruiterId": null,
  "recruiterName": null,
  "recruiterEmail": null,
  "salary": {
    "currency": "BRL",
    "startsAt": 3000,
    "endsAt": 6000
  },
 
  "jobRatingCriterias": [],
  "cancelReason": null,
  "cancelReasonNotes": null,
  "cancelAt": null,
  "publishedAt": null,
  "closedAt": null,
  "approvedAt": null,
  "disapprovedAt": null,
  "lastFreezeDate": null,
  "lastUnfreezeDate": null,
  "creatorId": 22011,
  "creatorName": "Public API",
  "creatorEmail": "[email protected]",
  "videoUrl": null,
  "approvers": null,
  "workflowRequestMethod": null,
  "branchId": 2743,
  "branchName": "MATRIZ"
}

Informações importantes!

1. As informações que estão presentes no template serão aplicadas à vaga (cargo, área, tipo da vaga, descrição da vaga, etapas do processo, página de carreiras...), desde que na sua requisição do POST Jobs estes campos não sejam enviados. Após a publicação da vaga não é possível alterar a página de carreiras, fique atento!
2. Se um template for utilizado na integração ele não pode ser removido da plataforma e mesmo que seja recriado com o mesmo nome, o seu id será alterado e isso impactará na integração.