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 nome, contato, localização, tags e a última vaga de cada candidato, com paginação. 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.

get_application

Devolve a ficha completa de uma vaga pelo id: status, tipo, cliente, fluxo e etapas, remuneração, local, requisitos, benefícios, responsáveis, link público e campos personalizados. Use as etapas retornadas aqui como 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