add_talent_observation
ChatGPTRegistra uma observação no perfil de um candidato, vinculada a uma candidatura. O texto aceita HTML simples.
create_candidate_in_vacancy
ChatGPTCadastra um candidato novo diretamente em uma etapa de uma vaga. Requer o id da vaga, o id da etapa, o canal de aquisição e o nome. Se o e-mail informado já estiver em um candidato desta vaga, não cadastra de novo e devolve a candidatura existente. A origem fica registrada como cadastro manual via integração. A entrada na vaga pode disparar as automações de novo candidato configuradas pelo recrutador, como e-mail ao candidato ou chamada a uma URL externa.
create_talent_tag
ChatGPTCria uma tag de chave e valor em uma candidatura, com cor opcional em hexadecimal.
delete_talent_observation
ChatGPTExclui em definitivo uma observação do perfil do candidato. Só o autor consegue excluir; a exclusão é confirmada relendo a lista antes de responder.
delete_talent_tag
ChatGPTExclui em definitivo uma tag de candidatura, identificada pelo id devolvido em list_talent_tags.
get_application
ChatGPTDevolve os dados completos de uma candidatura pelo id: perfil do candidato (formações, idiomas, habilidades, experiências, contato e telefone), etapa atual, avaliação (aprovado/reprovado/não avaliado) e motivo da reprova quando houver, tags, histórico de ações e matching (quando o plano da empresa inclui o Turbo). Funciona tanto para candidato com perfil completo (talento) quanto para prospect. É também o jeito de abrir o perfil de quem veio da busca em linguagem natural: use o id da candidatura que ela devolve.
get_current_user
ChatGPTDevolve a identidade do gestor autenticado nesta conexão: id do manager, nome, email e empresa. Use sempre que o usuário disser "eu", "minhas vagas", "meu time" ou equivalente, para não listar registros de outro gestor da mesma conta.
get_vacancy
ChatGPTDevolve a ficha completa de uma vaga pelo id: status, tipo, cliente, fluxo e etapas com a quantidade de candidatos em cada uma, totais em processo e reprovados, remuneração, local, requisitos, benefícios, responsáveis, link público e campos personalizados. Use esta tool para saber quantos candidatos há em cada etapa ou como está o funil de uma vaga. As etapas retornadas aqui são os valores válidos de pipe_stage_id.
get_vacancy_trace
ChatGPTDevolve o histórico de mudanças de status da vaga (publicada, congelada, reativada, editada etc.), com data, autor e o que mudou. Use para "o que aconteceu com essa vaga" ou "quando ela foi pausada".
list_reference_data
ChatGPTLista uma das tabelas de apoio da conta: departamentos, clientes, fluxos (pipes), recrutadores, regimes de contratação ou canais de aquisição de candidato. Use para descobrir os ids necessários ao filtrar vagas ou cadastrar candidatos.
list_talent_observations
ChatGPTLista as observações registradas no perfil de um candidato, com autor, vaga relacionada, texto e data.
list_talent_tags
ChatGPTLista as tags aplicadas ao perfil de um candidato, com chave, valor, cor e candidatura associada.
list_vacancies
ChatGPTLista as vagas da conta com paginação e filtros opcionais por status, tipo (Ultra, solicitada internamente ou por cliente), cliente, recrutador, criador, período de criação e termo de busca. Devolve id, título, status, cliente, departamento e fluxo de cada vaga. Quando o usuário pedir as próprias vagas ("minhas vagas"), passe mine=true — sem isso, um gestor que vê todas as vagas da empresa recebe também as de colegas.
list_vacancy_stage_candidates
ChatGPTLista as candidaturas que estão em uma etapa específica do fluxo de uma vaga, com paginação. Devolve o id da candidatura, o id do talento e o nome e email do candidato. Use para saber QUEM está na etapa; para saber QUANTOS há em cada etapa, use get_vacancy, que traz a contagem de todas as etapas numa chamada só. Os ids de etapa válidos vêm de get_vacancy.
move_application_stage
ChatGPTMove uma candidatura para outra etapa do fluxo da vaga. A etapa de destino é validada contra o fluxo daquela vaga antes do envio. Altera a posição do candidato no processo seletivo e pode disparar as automações configuradas na etapa de destino, como e-mail ao candidato, envio de formulário ou teste, ou chamada a uma URL externa.
search_ats
ChatGPTBusca vagas, clientes e candidatos do ATS da Recrutei por um termo livre e devolve os três grupos com id, título, localização e cliente. Use quando o usuário cita um nome ou título e ainda não se sabe o id do registro.
search_ats_natural_language
ChatGPTBusca candidatos na base de talentos da conta descrevendo o que procura em uma frase (ex.: senioridade, localização, período, habilidades) em vez de montar filtros manualmente. A frase é interpretada por um provedor de IA contratado pela Recrutei, que devolve os filtros; a busca em si roda na base da própria conta. Devolve, de cada candidato, nome, contato, localização, idade, última experiência, formação, tags, a última vaga e o id da candidatura, que abre o perfil completo no get_application. Tem paginação (até 50 por página; use page para ver os seguintes). Requer plano com busca avançada.
update_candidate
ChatGPTAtualiza os dados cadastrais de um candidato criado manualmente, identificado pelo id do talento. Sobrescreve os campos enviados.
update_talent_observation
ChatGPTReescreve o texto de uma observação existente. Só o autor da observação consegue editá-la; quando outro usuário tenta, a tool devolve erro de permissão.
update_talent_tag
ChatGPTSobrescreve a chave, o valor e a cor de uma tag existente, identificada pelo id devolvido em list_talent_tags.
add_talent_observation
Claudecreate_candidate_in_vacancy
Claudecreate_talent_tag
Claudedelete_talent_observation
Claudedelete_talent_tag
Claudeget_application
Claudeget_current_user
Claudeget_vacancy
Claudeget_vacancy_trace
Claudelist_reference_data
Claudelist_talent_observations
Claudelist_talent_tags
Claudelist_vacancies
Claudelist_vacancy_stage_candidates
Claudemove_application_stage
Claudesearch_ats
Claudesearch_ats_natural_language
Claudeupdate_candidate
Claudeupdate_talent_observation
Claudeupdate_talent_tag
Claude