API do Greenhouse: o que dá para fazer e como usar com agentes de IA
O Greenhouse é um sistema de recrutamento (ATS) com APIs para vagas, candidatos, candidaturas, entrevistas e ofertas, incluindo uma API pública de vagas para páginas de carreira. É usado por empresas de tecnologia e times de talent acquisition. O acesso é feito com chaves geradas pelo administrador da conta.
Os grandes recursos da API, em português claro.
Consulta de vagas abertas, inclusive para exibir em página de carreira.
Cadastro de candidatos, etapas e histórico de cada candidatura.
Agendamentos e scorecards dos entrevistadores.
Informações de propostas feitas aos candidatos.
Eventos como candidatura criada, etapa alterada ou contratação.
Como se acessa a API do Greenhouse.
- Com credencial da sua empresaUsa chaves de API criadas pelo administrador do Greenhouse, com permissões escolhidas por recurso; a API de vagas para página de carreira é de leitura pública.
- Documentação oficialdevelopers.greenhouse.io
- Dados de candidatos são pessoais (LGPD).
- Decisões de seleção não devem ser automatizadas pelo agente.
- Há limites de requisição na API.
- api greenhouse
- greenhouse api
- greenhouse harvest api
- greenhouse job board api
- api greenhouse candidatos
- integração greenhouse api
O que um agente do iTeam faz com a API do Greenhouse.
Currículos que chegam por e-mail ou indicação viram candidatos na vaga certa, com origem registrada.
O agente cobra os entrevistadores que ainda não enviaram a avaliação.
Antes da entrevista final, o agente junta as avaliações e monta um resumo para o gestor.
O agente informa candidatos por etapa e vagas paradas para o time de recrutamento.
Da credencial ao agente trabalhando, com aprovação.
Criar a chave com permissões mínimas
O administrador do Greenhouse cria a chave só com os recursos que o agente vai usar.
Guardar no cofre do iTeam
Cadastre a chave e restrinja o acesso aos agentes de recrutamento.
Decisões com pessoas
Mantenha avanço, reprovação e oferta como decisões humanas; o agente organiza e lembra.
Dúvidas sobre a API do Greenhouse.
A API do Greenhouse é gratuita?
A API faz parte da plataforma, sem cobrança separada; o acesso depende do contrato da empresa com o Greenhouse.
Preciso programar para usar a API do Greenhouse com o iTeam?
Não necessariamente. O Greenhouse está entre os apps que o iTeam conecta, e o time de implantação configura permissões e regras.
O agente faz triagem de currículos?
Ele pode organizar e resumir currículos com critérios definidos pelo time, mas quem decide é o recrutador.
Como criar a chave de API do Greenhouse com permissões por recurso?
O administrador do Greenhouse cria a chave em configurações de desenvolvedor e marca, para cada recurso, o que ela pode ler ou escrever. Para um agente que apenas acompanha vagas e etapas, deixe só leitura de vagas e candidaturas, sem acesso a ofertas.
A Job Board API do Greenhouse exige autenticação?
A API de vagas para páginas de carreira é de leitura pública, então não exige chave para listar vagas abertas. Já a API de dados de candidatos, a Harvest, exige credencial. O agente pode explicar vagas ao candidato sem tocar em nenhum dado privado.
O agente de IA pode ler candidaturas no Greenhouse?
Pode, dentro da permissão da chave. Ajuda o recrutador a resumir o status de cada vaga, achar candidatos parados numa etapa e preparar o agendamento de entrevistas. Os dados são pessoais e a LGPD se aplica ao tratamento.
O agente deve decidir quem avança no processo seletivo do Greenhouse?
Não: decisões de seleção não devem ser automatizadas pelo agente, que organiza informação e sugere o próximo passo para o recrutador. Quem avança ou reprova o candidato é uma pessoa, com critérios definidos pela empresa.
O Greenhouse tem sandbox para testar a integração?
Confira na documentação em developers.greenhouse.io se o seu plano inclui ambiente de teste; não confirmei um sandbox público. Uma prática segura é criar vagas e candidatos fictícios e rodar o agente primeiro só com leitura.
Quais dados de candidatos o agente deve evitar enviar para outros sistemas?
Currículo, contatos e avaliações são dados pessoais e não devem sair do Greenhouse sem necessidade. Defina quais campos o agente usa e por quanto tempo guarda o resumo, e informe os candidatos conforme a política de privacidade da empresa.
Webhooks do Greenhouse ajudam a automatizar avisos ao gestor?
Ajudam: os webhooks avisam quando um candidato muda de etapa ou uma oferta é criada. O agente pode avisar o gestor da vaga ou lembrar de dar feedback. Isso reduz o tempo de candidato parado sem resposta, que é uma queixa comum.
Quando não vale ligar IA ao Greenhouse?
Se a empresa contrata poucas vezes por ano, o trabalho manual é pequeno e a integração não se paga. Faz mais sentido em times de recrutamento com muitas vagas simultâneas, em que acompanhar etapas e agendar entrevistas consome o dia.
