Bem-vindo ao TalentAI 👋

Este guia ensina, passo a passo, como usar o TalentAI para recrutar com inteligência artificial — da publicação da vaga até a contratação. Escolha um capítulo na barra lateral ou siga a ordem sugerida abaixo.

O caminho recomendado

Conhecer o painel

O painel do TalentAI tem um menu lateral com todas as áreas do sistema. Cada seção está disponível com um clique — sem recarregar a página.

Seções do menu

• 📊 Dashboard — visão geral: vagas abertas, candidatos, entrevistas da semana e score médio.
• 📋 Vagas — criar, editar e excluir vagas. Inclui gerador de Job Description com IA.
• 👤 Candidatos — todos os candidatos cadastrados, com score, análise IA e currículo.
• 🗂️ Pipeline — visão kanban por etapa, com filtro por vaga e triagem automática.
• 📅 Entrevistas — agendamento com envio automático de e-mail e lembrete 24h antes.
• 💼 Ofertas — registrar propostas salariais com e-mail automático ao candidato.
• 🤖 Assistente IA — chat em linguagem natural com dados reais do banco.
• 📈 Relatórios — distribuição por etapa, score médio e taxa de aprovação.
• 💬 Mensagens — chat interno entre RH e candidatos.
• 📧 E-mails — templates dos 6 e-mails automáticos, editáveis pelo admin.
• 🔒 LGPD — exportação e exclusão de dados por requisição do titular.
• ⚙️ Configurações — dados da empresa, SMTP, chave Anthropic e Supabase.

Configuração inicial

Antes de publicar vagas, configure as credenciais do sistema em ⚙️ Configurações.

1. Conectar ao Supabase

   Informe a URL do projeto e a chave anon do Supabase. Clique em Conectar — o status muda para 🟢 Supabase conectado no canto superior direito.

2. Dados da empresa

   Preencha o nome da empresa. Ele aparece nos e-mails automáticos enviados aos candidatos.

3. Configurar SMTP (e-mail)

   Informe o host, porta, usuário e senha do servidor de e-mail. Clique em Testar conexão para confirmar que os e-mails serão enviados corretamente.

4. Chave da API Anthropic

   Cole a chave sk-ant-api03-… obtida em console.anthropic.com. Ela é necessária para score de currículos, geração de JD e assistente IA.

5. Criar templates de e-mail

   Em 📧 E-mails, crie os 6 templates de disparo automático. Use o botão Sugestão IA para gerar o texto automaticamente.

Criar e gerenciar vagas

Cada vaga publicada aparece automaticamente no Portal do Candidato. Preencha os campos com cuidado — a IA usa as informações para avaliar os candidatos.

1. Abra 📋 Vagas e clique em + Nova vaga

   Um formulário lateral se abre com todos os campos da vaga.

2. Preencha os dados principais

   Informe título do cargo, área / departamento, modalidade (Remoto, Híbrido ou Presencial) e tipo de contrato (CLT, PJ, Estágio, Freelance).

3. Defina a faixa salarial

   Informe salário mínimo e máximo. Esses valores aparecem no portal para os candidatos.

4. Adicione requisitos e tags

   Requisitos são as habilidades necessárias (ex.: Python, 3 anos de experiência). Tags são palavras-chave para busca no portal.

5. Escreva ou gere a descrição

   Escreva manualmente ou clique em ✨ Gerar com IA — a IA cria um texto profissional automaticamente. Veja o próximo capítulo.

6. Salve e publique

   Clique em Salvar. A vaga fica com status Ativa e aparece imediatamente no portal.

Gerar descrição de vaga com IA ✨

Em vez de escrever a descrição do zero, o TalentAI usa inteligência artificial para criar um texto profissional e atrativo automaticamente — em segundos.

1. Preencha o título, área e requisitos

   A IA usa esses dados como base. Quanto mais informações, melhor o resultado.

2. Clique em ✨ Gerar com IA

   O botão fica ao lado do campo de descrição. A geração leva cerca de 5–10 segundos.

3. Revise e edite

   O texto gerado aparece no campo de descrição. Você pode editá-lo livremente antes de salvar.

4. Salve a vaga

   Clique em Salvar normalmente.

Portal do Candidato

O portal é a página pública onde os candidatos descobrem as vagas e se inscrevem. Não precisa de login para ver as vagas — apenas para se candidatar.

1. Acessar o portal

   O candidato acessa o link do portal (ex.: https://rh.suaempresa.com.br/portal). Vê todas as vagas ativas com filtros por modalidade, área e tipo de contrato.

2. Encontrar a vaga

   Usa a busca por cargo ou habilidade, ou filtra pelas tags. Clica na vaga para ver detalhes completos.

3. Criar conta e se candidatar

   Clica em Candidatar-me. Se for o primeiro acesso, preenche nome, e-mail, habilidades, localização e aceita a política de privacidade (LGPD).

4. Fazer upload do currículo

   Anexa o CV em PDF. O arquivo fica disponível para o RH baixar no painel.

5. Receber confirmação

   Um e-mail automático de confirmação é enviado. A IA inicia a análise de compatibilidade em segundo plano.

6. Acompanhar pela "Minha Área"

   O candidato acessa 👤 Minha Área para ver o status das candidaturas, score IA e mensagens do RH.

Score de compatibilidade por IA ⚡

Assim que o candidato se inscreve, a IA analisa automaticamente o perfil dele versus os requisitos da vaga e gera um score de 0 a 100%.

Como é calculado

• A IA avalia: habilidades técnicas, localização, anos de experiência e alinhamento com os requisitos da vaga
• Gera um score numérico + uma análise textual de 3–4 linhas explicando pontos fortes e o que falta
• O cálculo usa o modelo Claude Sonnet (Anthropic) e leva 3–10 segundos

O que significa cada faixa

Pipeline de Recrutamento 🗂️

O pipeline exibe todos os candidatos organizados por etapa, em formato kanban. É a visão central do processo seletivo.

As 7 etapas

Filtrar por vaga

Use o seletor Filtrar por vaga no topo do pipeline para ver apenas os candidatos de uma vaga específica. Por padrão, exibe todos.

Cards de candidato

• Cada card mostra nome, vaga e score IA colorido (verde / amarelo / vermelho)
• Clique no card para abrir o perfil completo do candidato
• O score se atualiza em tempo real após recalcular

Triagem Automática por IA 🤖

O botão 🤖 Triagem IA no pipeline processa todos os candidatos inscritos sem score de uma vez — em lote.

1. Abra o 🗂️ Pipeline

   Certifique-se de que existem candidatos na coluna Inscritos sem score calculado.

2. Clique em 🤖 Triagem IA

   O sistema processa cada candidato em sequência, com uma pausa de 600ms entre cada um para não sobrecarregar a API.

3. Acompanhe o resultado

   Um toast de notificação aparece a cada candidato processado. Ao final: "Triagem concluída!"

4. Revise os que ficaram em Inscritos

   Candidatos com score < 70% permanecem na coluna Inscritos. O RH decide: avança manualmente ou reprova.

Avançar e reprovar candidatos

O RH move os candidatos pelas etapas com um clique. A cada avanço ou reprovação, o sistema dispara e-mails automáticos.

Avançar etapa

1. Clique no card do candidato

   O perfil completo abre em um painel lateral.

2. Clique em ▶ Avançar etapa

   O candidato move para a próxima etapa do pipeline automaticamente.

3. E-mail automático

   Se o candidato avançar para Contratado, um e-mail de parabéns é enviado automaticamente. Para Entrevista agendada, o e-mail é enviado ao agendar.

Reprovar candidato

1. Abra o perfil do candidato

   Clique no card no pipeline.

2. Clique em ✕ Reprovar

   Um diálogo de confirmação aparece.

3. Confirme a reprovação

   O candidato vai para a etapa Reprovado e recebe automaticamente um e-mail de agradecimento e feedback respeitoso.

Perfil do candidato

Cada candidato tem um perfil completo com dados pessoais, currículo, score IA, histórico de candidaturas e ações disponíveis.

Dados armazenados

• Nome, e-mail, telefone — dados de contato
• Localização — cidade / estado
• Habilidades — tags inseridas pelo candidato
• Experiência — anos de experiência declarada
• Currículo — arquivo PDF para download
• Score IA e análise — por vaga candidatada
• Consentimento LGPD — data e hora do aceite
• Histórico de candidaturas — todas as vagas e etapas

Ações disponíveis no perfil

Análise e score IA 🧠

Além do score numérico, a IA gera uma análise textual detalhada explicando por que o candidato é ou não compatível com a vaga.

Agendar entrevistas 📅

Ao agendar uma entrevista no sistema, o candidato recebe um e-mail automático com todos os detalhes — data, hora, link e formato.

1. Abra 📅 Entrevistas e clique em + Nova entrevista

   Ou clique em 📅 Agendar direto no perfil do candidato — o formulário já vem pré-preenchido.

2. Selecione o candidato e a data

   Escolha o candidato no dropdown, defina a data e o horário da entrevista.

3. Escolha o tipo e o formato

   Tipo: RH, Técnica ou Final. Formato: Videoconferência ou Presencial.

4. Informe o link ou endereço (obrigatório)

   Para vídeo: cole o link do Meet/Zoom/Teams. Para presencial: informe o endereço completo.

5. Salve

   O e-mail é enviado automaticamente ao candidato com todos os detalhes formatados.

Registrar proposta e oferta 💼

Quando o candidato chega à etapa de oferta, registre a proposta no sistema — o candidato recebe um e-mail automático com os detalhes.

1. Abra 💼 Ofertas e clique em + Nova oferta

2. Selecione o candidato

   Escolha o candidato no dropdown. O sistema vincula à candidatura correspondente.

3. Preencha os detalhes da proposta

   Informe salário proposto, bônus de contratação (signing bonus), data de início prevista e prazo de validade da oferta.

4. Salve

   Um e-mail é enviado ao candidato com o salário formatado (ex.: R$ 8.500) e a data de início em formato legível (DD/MM/AAAA).

6 E-mails automáticos 📧

O TalentAI envia e-mails automáticos nos momentos mais importantes do processo — sem intervenção manual. Basta ter os templates configurados.

Variáveis disponíveis nos templates

Use estas variáveis no assunto ou corpo do e-mail — elas são substituídas pelos valores reais no envio:

Configurar templates de e-mail

Os templates são editáveis pelo admin em 📧 E-mails. Cada gatilho tem o seu próprio template de assunto e corpo.

1. Abra 📧 E-mails

   Você verá a lista dos 6 gatilhos disponíveis.

2. Clique em um gatilho

   O formulário do template abre: Assunto e Corpo do e-mail.

3. Escreva ou use a sugestão IA

   Clique em ✨ Sugestão IA para gerar um texto profissional automaticamente, ou escreva o seu.

4. Insira variáveis

   Use {nome}, {cargo}, etc. para personalizar cada e-mail com os dados do candidato.

5. Salve o template

   Clique em Salvar template. A partir daí o e-mail é enviado automaticamente quando o gatilho for acionado.

Mensagens diretas com candidatos 💬

O sistema tem um chat interno para troca de mensagens entre RH e candidatos — ideal para tirar dúvidas, solicitar documentos ou dar feedbacks informais.

Como funciona

• O RH inicia ou responde conversas pelo painel admin em 💬 Mensagens
• O candidato visualiza e responde pela área 👤 Minha Área no portal
• Conversas não lidas aparecem com um indicador visual na lista
• O histórico completo é preservado por candidatura

Dashboard — Visão geral 📊

O Dashboard exibe as métricas mais importantes do processo seletivo em tempo real, atualizadas a cada carregamento.

Relatórios 📈

A seção de Relatórios oferece uma visão analítica do processo seletivo com gráficos e tabelas detalhadas.

• Distribuição por etapa — quantos candidatos estão em cada fase do pipeline
• Candidatos por vaga — volume de inscrições por posição
• Score médio — compatibilidade média por vaga
• Taxa de aprovação — % que passou pela triagem IA
• Histórico de contratações — candidatos que chegaram até Contratado

Assistente IA 🤖

O assistente é um chat em linguagem natural conectado ao banco de dados real. Faça perguntas e receba respostas baseadas nos dados do sistema.

Exemplos de perguntas

• "Quais candidatos têm maior score para a vaga de Engenheiro?"
• "Quantas vagas temos abertas esta semana?"
• "Qual a taxa de aprovação na triagem IA este mês?"
• "Quais entrevistas estão agendadas para amanhã?"
• "Quantos candidatos foram contratados nos últimos 30 dias?"

Como usar

1. Abra 🤖 Assistente IA

   A tela do chat abre com o contexto do banco carregado automaticamente.

2. Faça sua pergunta

   Digite em linguagem natural e pressione Enter.

3. Leia a resposta

   O assistente responde com base nos dados reais do Supabase. Você pode fazer perguntas de acompanhamento — o histórico da conversa é mantido.

4. Use as ações rápidas

   Os botões de ação rápida na lateral direita executam as análises mais comuns com um clique.

LGPD e Privacidade 🔒

O TalentAI foi desenvolvido com conformidade à Lei Geral de Proteção de Dados (LGPD). Veja os recursos disponíveis para titular e admin.

Direitos do candidato (titular)

• Consentimento explícito — o aceite é obrigatório no cadastro, com registro de data e hora
• Exportação de dados — o candidato baixa todos os seus dados em JSON pela "Minha Área"
• Transparência — o candidato vê o próprio score IA e o status de cada candidatura

Ferramentas para o RH (admin)

• Exportar dados — gera JSON com todos os dados de um candidato específico
• Excluir candidato — remove permanentemente todos os dados (irreversível)
• Visualizar consentimentos — lista de candidatos com data/hora do aceite