Um questionário de inscrição é uma ferramenta essencial para empresas durante o processo de recrutamento e seleção. Ele permite coletar informações padronizadas sobre os candidatos, abrangendo desde dados básicos até aspectos mais específicos como habilidades, experiências e expectativas. Isso simplifica a análise inicial e permite uma triagem mais eficiente.
Sua utilidade está em garantir que apenas candidatos alinhados aos requisitos avancem para as próximas etapas. Questionários bem estruturados também ajudam a eliminar vieses, fornecendo uma base objetiva para comparar perfis e identificar talentos mais qualificados para a vaga.
Além de avaliar habilidades técnicas e experiências, um questionário de inscrição pode ajudar a determinar o fit cultural de um candidato, ou seja, o alinhamento entre seus valores, atitudes e comportamentos e a cultura organizacional da empresa. Perguntas sobre situações hipotéticas, preferências de ambiente de trabalho ou até mesmo sobre a abordagem a desafios podem revelar se o candidato se adapta ao estilo de liderança, comunicação e colaboração da organização. Esse alinhamento é crucial para aumentar a satisfação, o desempenho e a retenção no ambiente corporativo.
Acessando a Funcionalidade via API #
A API da Textualiza permite automatizar a criação de descrição de cargo. Siga os passos abaixo para integrá-la ao seu sistema.
Passo 1: Entenda o Endpoint #
- Endpoint utilizado:
GET /api/content/jobs/questionnaire/ - Esse endpoint permite recuperar, criar ou configurar questionários para serem usados em processos seletivos.
Passo 2: Configure a Autenticação #
Certifique-se de incluir o token de autenticação no cabeçalho da requisição:
Authorization: Bearer <seu_token>Passo 3: Estrutura de Requisição #
Para criar ou configurar um questionário, use os seguintes parâmetros no corpo da requisição:
- job_
title(string): Nome do Cargo; - department (string): Departamento/Setor;
- seniority_level (string): nível de senioridade (ex: júnior, sênior, coordenador, vp, etc)
requirements(array): Lista de requisitos do cargo;- responsibilities(array): Lista de responsabilidades ou atribuições do cargo;
- company (object): dados da empresa;
- webhook_url: caso a chamada seja assíncrona, configure o endpoint para onde a notificação será enviada quando o processo for concluído;
Exemplo:
json {
"input_data": {
"job_title": "AAAAAA",
"department": "AAAAAA",
"seniority_level": "AAAAAA",
"requirements": [
"string"
],
"responsibilities": [
"AAAAAA"
],
"company": {
"name": "AAAAAA",
"short_bio": "AAAAAA",
"industry": "AAAAAA"
}
},
"webhook_url": "http://example.com"
}Passo 4: Envie a Requisição #
Utilize uma ferramenta como Postman ou uma biblioteca HTTP (como requests em Python) para enviar a requisição POST ao endpoint.
Exemplo em Python:
import requests
url = "https://textualiza.com.br/api/content/jobs/questionnaire/"
headers = {
"Authorization": "Bearer <seu_token>",
"Content-Type": "application/json"
}
data = {
"input_data": {
"job_title": "Desenvolvedor de Software",
"department": "Tecnologia",
"seniority_level": "Sênior",
"requirements": [
"Experiência em desenvolvimento web",
"Conhecimento em JavaScript, Python e Django",
"Habilidade em trabalhar com bancos de dados relacionais"
],
"responsibilities": [
"Desenvolver novas funcionalidades para o sistema",
"Manter e otimizar os sistemas existentes",
"Colaborar com outras equipes para integrar soluções"
],
"company": {
"name": "Tech Solutions",
"short_bio": "Somos uma empresa de tecnologia inovadora focada em soluções para o mercado B2B.",
"industry": "Tecnologia"
}
},
"webhook_url": "http://example.com"
}
response = requests.post(url, headers=headers, json=data)
if response.status_code == 201:
print("Questionário criado com sucesso!")
else:
print("Erro:", response.json())Passo 5: Teste e Ajuste #
- Acesse o questionário criado na interface da plataforma para validar sua configuração.
- Ajuste perguntas ou opções conforme necessário, enviando novas requisições ao endpoint.
Passo 6: Integração Final #
Integre o questionário ao fluxo de inscrição da sua aplicação, garantindo que os candidatos possam acessá-lo e responder.
