Recrutei

Registra uma observação no perfil de um candidato, vinculada a uma candidatura. O texto aceita HTML simples.

add_talent_observation

Atualiza os dados cadastrais de um candidato criado manualmente, identificado pelo id do talento. Sobrescreve os campos enviados.

update_candidate

Busca 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.

search_ats_natural_language

Busca 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

Cadastra 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_candidate_in_vacancy

Cria uma tag de chave e valor em uma candidatura, com cor opcional em hexadecimal.

create_talent_tag

Devolve 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_application

Devolve 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

Reescreve 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_observation

Sobrescreve a chave, o valor e a cor de uma tag existente, identificada pelo id devolvido em list_talent_tags.

update_talent_tag