🚧

Acesso Limitado

O endpoint de Consulta de Resultado de Testes está em fase beta.
Para obter acesso, entre em contato conosco.

Gerando o token

Para utilizar este fluxo, é necessário utilizar o Bearer Token gerado nas configurações avançadas da plataforma. Acesse nossa seção de autenticação para saber como gerar o o token de autenticação.

No momento de gerar o token habilite o seguinte endpoint da V2:

• Applications Tests

1. Realizando a consulta

Para consultar o resultado de teste, é obrigatório informar "applicationId".

ApplicationId corresponde ao id de uma aplicação(também chamado de candidatura) a uma vaga. é possível consultar candidaturas de uma vaga no endpoint GET Applicantions.

Você pode acessar o endpoint para consulta de Resultado de Resultados de Testes em: GET Applicant Test Results

2. Retorno Possíveis

Uma aplicação pode possuir nenhum ou múltiplos. Um teste é associado na criação de uma etapa da vaga. Uma etapa pode ter nenhum ou no máximo um teste.
Deste modo, serão retornados todos os resultados de testes finalizados pela candidata, para testes existentes nas etapas da vaga.

📘

Importante:

São retornados apenas resultados de testes finalizados. Testes em andamento não serão retornados.

❗️

Tipos de Testes Retornados

Oferecemos a consulta de Resultados de Teste para Testes Gupy e Testes de Provedores Externos.

Retornos possíveis:

1. Token Inválido/Expirado - Ao realizar uma consulta com token inválido, expirado, será retornado o status 401.
2. Application não encontrada - Ao consultar uma "application" não encontrada, será retornado results vazio com status 200.
3. Application Encontrada sem Testes Finalizados -Ao consultar uma "application" existente sem testes finalizados, será retornado results vazio com status 200.
4. Application Encontrada com Testes Finalizados - Ao consultar uma "application" existente que possua testes finalizados, serão retornadas as informações de resultados de testes com o status 200. Uma application(candidatura), pode ter um ou mais testes associados. Sendo assim, são retornados os resultados de todos os testes dessa candidatura dentro do array results.

Exemplo de objeto de retorno:

{
    "results": [
        {
            "applicationId": 143685,
            "candidateId": 1414336,
            "createdAt": "2024-04-22T19:10:24.744Z",
            "finishedAt": "2024-04-22T21:10:05.675Z",
            "updatedAt": "2024-04-22T21:10:05.676Z",
            "providerTestId": "culturalFit_V2",
            "testResult": {
                "title": "Fit Cultural",
                "status": "done",
                "results": [
                    {
                        "date": "2024-04-22T21:10:05.570Z",
                        "tier": "major",
                        "score": 63,
                        "title": "Fit Cultural",
                        "type_result": "percentage"
                    }
                ],
                "testCode": "culturalFit_V2",
                "description": "Esse teste tem o objetivo de avaliar se o perfil da pessoa candidata é aderente ao da sua empresa. O resultado serve para a pessoa recrutadora entender se há um alinhamento entre os valores de um profissional e aqueles disseminados dentro da sua empresa.",
                "providerLink": "https://gupy.io",
                "providerName": "Testes Gupy"
            }
        }
    ],
    "nextPageToken": null
}

📘

Observe:

As informações presentes no objeto testResult são recebidas pelo provedor externo,
para maiores informações sobre esse campo e integração com provedores, acesse: Resultados de Teste