Publicando uma Vaga

O assistente Criar Vaga leva você de uma tela em branco a um link de candidatura ativo em dois passos. Este guia explica o que cada campo controla e como ele molda a triagem por IA nos bastidores.

Antes de começar

Uma vaga sempre está dentro de um negócio (seu espaço de trabalho). O seletor de negócios na barra superior da página inicial determina onde a nova vaga será criada. Se você tem mais de um negócio, troque para o correto antes de clicar no botão Criar Vaga.

Ao abrir o assistente, o ResReader cria imediatamente um rascunho em segundo plano — você pode fechar o assistente a qualquer momento sem perder seu trabalho. O rascunho se torna uma vaga publicada quando você clica em Publicar Vaga na segunda página; este é o único caminho que também coloca a descrição na fila para processamento por IA. A indicação de status na barra superior permite alternar diretamente entre Rascunho / Ativo / Pausado / Arquivado, mas em um rascunho novo você ainda deve clicar Publicar Vaga para a primeira publicação — caso contrário, a vaga vai ao ar sem um perfil de avaliação por IA, e os candidatos que chegarem não serão pontuados até você voltar ao editor e clicar Publicar Vaga para iniciar o processamento.

Passo 1 — Descrição

A descrição é a única entrada que o assistente pede no Passo 1, e é o dado mais importante para a triagem por IA — tudo que o ResReader compara no currículo de um candidato vem desse texto. O assistente não tem campos separados para título da vaga, local, salário, tipo de contratação ou nível de experiência; estes são extraídos da descrição pelo processador de IA após a publicação e armazenados no aiEvaluationProfile da vaga. O processador é instruído a produzir um título curto e legível na mesma língua natural da descrição, portanto expor claramente o cargo no topo da descrição (ex.: no primeiro título H1) ajuda ele a escolher o título que você escolheria.

Escrevendo a descrição

Você tem três formas para preencher o editor:

Digite ou cole markdown — cole seu anúncio de vaga já pronto direto da sua página de carreiras, LinkedIn ou app de notas. A barra de ferramentas acima do editor controla a formatação (títulos, listas, tabelas, emoji).
Peça ajuda ao assistente de IA — no desktop, o painel esquerdo tem duas abas no topo: Editor e Assistente de IA. Troque para o Assistente de IA, digite algo curto como "Desenvolvedor Flutter Sênior, remoto, 5+ anos", e a IA cria uma descrição completa que você pode voltar a editar. (O painel direito mantém a prévia ao vivo o tempo todo.)
Itere — continue conversando com a IA para ampliar ou ajustar seções (ex.: "adicione uma seção de benefícios", "torne a lista de requisitos mais rígida"). A conversa é salva em jobs/{jobId}/aiDescriptionUserCommand e persiste mesmo com recarregamento da página.

No mobile, as mesmas opções são exibidas como uma barra de três abas no topo do editor: Editor, IA, Pré-visualização (IA é a aba padrão na primeira abertura).

O que é necessário para publicar

A descrição é a única entrada obrigatória. O assistente bloqueia a publicação apenas quando o campo de descrição está vazio — tudo no Passo 2 é opcional, e as metadados de título/localização/salário são preenchidos pelo processador de IA após a publicação.

Passo 2 — Configuração da IA

A segunda página controla como o ResReader pontua os candidatos recebidos e o que acontece depois de pontuá-los. Cada campo desta página é opcional — você pode clicar Publicar Vaga sem alterar nada e a IA pontuará apenas com base na descrição. Mas quanto mais informações você fornecer aqui, mais úteis serão as classificações.

Prompt de filtragem

O prompt de filtragem é uma instrução em texto livre para a IA explicando como ponderar a descrição. Pense nisso como uma nota privada para o triador que não aparece na vaga pública.

Bons prompts de filtragem são específicos:

"Priorize candidatos com 3+ anos em desenvolvimento mobile. Flutter é um grande diferencial; experiência nativa iOS/Android é aceitável. Rejeite candidatos com experiência única em web."
"Habilidades de comunicação importam mais que anos de experiência. Procure evidências de escrita — posts em blogs, palestras, documentação OSS."

Se você deixar em branco, a IA pontua apenas contra a descrição.

Perguntas de esclarecimento por IA

Quando ativado, o ResReader envia por email ao candidato cinco perguntas de acompanhamento personalizadas após a primeira avaliação, e então reavalia o candidato após as respostas.

Quem recebe os acompanhamentos. Apenas candidatos que se inscreveram pelo seu link público de candidatura são elegíveis — uploads manuais, importações em lote e pelo Chrome são ignorados. Qualquer candidato elegível com nota 1 ou mais é colocado na fila (na prática, quase todos que chegam à análise). Use isso se preferir coletar mais informações de cada candidato ao invés de rejeitar só com o currículo raso; desative se processar alto volume e não quiser que todos recebam email.

O que a IA pergunta. Cinco perguntas geradas para cada candidato com base nas lacunas entre o currículo dele e os requisitos da vaga — nada de template genérico. Uma das cinco é sempre sobre expectativas salariais (o candidato pode responder com faixa, número ou palavras). As outras quatro focam nas áreas mais fracas ou ambíguas do currículo. O candidato responde via formulário web em /follow-up/<token>; o link é válido por 7 dias.

O prompt personalizado. A caixa de texto abaixo do toggle é adicionada às instruções da IA para geração das perguntas. Use para direcionar o foco ("Pergunte sobre projetos reais, não certificações", "Investigue liderança real, não só participação em equipe"). Se estiver vazia, a IA gera perguntas só com base nas lacunas do currículo.

Regras de nova pontuação (quando o candidato responde):

Uma nova nota é calculada usando o currículo mais o Q&A. A nota anterior, a nova, e um resumo das melhorias ficam salvos na candidatura.
Melhorias são limitadas. Um candidato com nota 7 ou menos pode subir no máximo +3 pontos (ex.: 5 → 8). Um candidato acima de 7 pode ir até 10. Não há limite para quedas — uma resposta ruim pode derrubar um candidato forte.
O flag de qualificado muda para true a partir de nota ≥ 7, a mesma regra da avaliação inicial.

Uma vez por candidato. Um candidato que já recebeu acompanhamentos não será colocado na fila novamente, mesmo se você reprocessar a vaga. Se você ativar esses acompanhamentos depois que o candidato enviou inscrição, ele só recebe perguntas na próxima análise.

Impacto da entrevista na pontuação

Se você usa entrevistas IA, o desempenho do candidato na entrevista é sempre registrado e visível na página de análise. Por padrão, a nota da entrevista não altera a nota geral — a IA pode interpretar mal áudio, então a nota do currículo é mais confiável.

Ative essa opção para que a nota geral considere a entrevista. A IA reavalia o candidato usando currículo e a transcrição da entrevista juntos, dando mais peso ao currículo (cerca de 65/35). Isso é uma orientação para o modelo, não uma fórmula fixa — a IA pode se desviar quando a entrevista revelar algo que o currículo ocultou, em qualquer direção. A nota anterior fica salva para você ver o efeito da entrevista.

Quadro de pontuação

Anexe um modelo de quadro de pontuação se seu time pontua candidatos em critérios específicos após entrevistas (ex.: Profundidade Técnica, Adequação Cultural, Comunicação). Escolha um modelo no menu e seus critérios são fixados na vaga — se o modelo mudar depois, essa vaga mantém a versão usada na escolha. Para criar ou editar modelos, use o botão Gerenciar ao lado do menu; ele abre a página de Quadros de Pontuação do seu negócio. A mesma página também pode ser acessada no menu de overflow de qualquer página de análise.

Configurações de idioma

O ResReader pode exibir quatro superfícies em idiomas diferentes — cada um configurado separadamente:

Idioma da Análise — idioma em que a IA escreve seus relatórios de avaliação (descrição mostrada nos cards, análise de pontos fortes/fracos etc.). Padrão é o idioma em que você usa o ResReader.
Idioma da Comunicação com o Candidato — idioma dos emails enviados ao candidato (confirmação, perguntas de acompanhamento, rejeição, oferta, convites para entrevista). Padrão é Idioma do candidato, detectado automaticamente pelo currículo. Substitua por idioma fixo para que todos recebam em inglês (ou qualquer preferido).
Idioma do Gestor de Contratação — idioma dos emails de revisão para gestores e sumários de IA que eles veem quando você encaminha candidatos para revisão. Por padrão inglês em vagas novas; vagas antigas herdam seu idioma de análise.
Idioma da Entrevista IA — idioma que o entrevistador IA fala em entrevistas ao vivo. O padrão Idioma do candidato é enganoso: na verdade é o modo auto, onde a IA detecta o idioma da descrição da vaga e conduz a entrevista nesse idioma (com inglês padrão se faltar descrição). Definir idioma específico força esse idioma — a IA fará as entrevistas inteiras nesta língua, independente do que o candidato falar.

Equipe nesta vaga

Atribua recrutadores (outros colegas no seu negócio — UIDs do seu time) e gestores de contratação (itens da coleção hiringManagers — não precisam ser usuários ResReader; um email já basta). Ambas as listas alimentam exatamente dois comportamentos hoje:

Ao abrir o diálogo Enviar para Revisor Gestor na página de análise, os gestores atribuídos à vaga já vêm pré-selecionados. Você pode adicionar ou remover gestores antes de enviar.
Quando um candidato aceita uma oferta, o ResReader envia um email Confirmação de Contratação — para o candidato, e para cada recrutador e gestor atribuído (sem duplicação por email). Se uma data de início foi definida na oferta, o email inclui convite calendário .ics para o dia inteiro.

Essas atribuições não filtram dashboards, nem limitam visibilidade ou alteram feeds de tarefas — todo colega do negócio vê todas as vagas independentemente da atribuição. Use o campo para declarar autoria e para os envios dos emails de confirmação; dá para editar depois na edição da vaga.

Publicando

Clique em Publicar Vaga quando acabar. Algumas coisas acontecem ao mesmo tempo:

O status da vaga é definido para o que o indicador mostra — normalmente Ativo, que define isActive: true e isDraft: false no documento.
Uma linha é adicionada em jobDescriptionProcessorQueue. Uma Cloud Function processa, analisa a descrição, cria o perfil de avaliação IA (representação estruturada de habilidades, requisitos e alertas), e salva na vaga.
A URL pública de candidatura — https://resreader.com/<businessId>/<jobId> — foi criada com o rascunho e agora está ativa. Abra o diálogo Compartilhar Vaga da página de análise para copiar ou gerar variações rastreadas (LinkedIn, X, slugs personalizados); o parâmetro de consulta ?src=<slug> registra a origem do candidato. Toda candidatura via essa URL — direta ou rastreada — recebe source: "public_job_link", que torna o candidato elegível para as perguntas de acompanhamento.
Você é redirecionado para a página de análise, onde pode ver as candidaturas chegarem.

A latência do processamento depende da fila, mas o perfil IA normalmente fica pronto em segundos. Os candidatos novos são pontuados conforme chegam — não é necessário mais nada.

Editando uma vaga publicada

Você pode editar qualquer campo de uma vaga publicada pelo menu de opções (Editar Vaga) na página inicial ou análise. A maioria das alterações — atribuir recrutador ou gestor, trocar modelo de quadro, atualizar idioma, mudar status — aplicam-se imediatamente.

Duas mudanças específicas são diferentes. Se editar a descrição ou o prompt de filtragem numa vaga publicada, o ResReader mostra o diálogo Reescaneamento ao salvar.

O diálogo tem três botões:

Cancelar — fecha o diálogo, fica na página de edição, nada é salvo para a fila.
Ignorar — mantém as edições, mas aplica os novos critérios apenas para candidaturas futuras. As que já existem mantém as notas originais.
Reescanear — aplica os novos critérios às candidaturas existentes. Escolha entre Todos os currículos ou uma nota mínima (selecionar 7 reescaneia todos com nota 7 ou mais — útil se quiser apertar o prompt e só escanear os melhores).

Reescaneamentos rodam em segundo plano. A vaga fica marcada hasBeenEdited na primeira edição pós-publicação e você verá as notas se atualizarem na página de análise conforme o processamento.

Rascunhos, pausadas e o ciclo de vida da vaga

Uma vaga está em um de quatro estados, controlados na indicação de status na barra superior do editor:

Rascunho — interno apenas. A URL pública existe, mas mostra "Esta vaga não está aceitando inscrições atualmente" — rascunhos têm isActive: false. Use-os para preparar descrições antes do início oficial da contratação.
Ativa — pública, aceitando inscrições, a pontuação roda para cada novo candidato. Este é o único estado em que a página de candidatura é funcional.
Pausada — URL pública mostra a mensagem de inatividade. As inscrições, notas, entrevistas e quadros continuam acessíveis na análise. Reabra voltando para Ativa.
Arquivada — mesmo efeito da Pausada para o público; usada para limpar vagas pausadas do quadro ativo sem deletar.

Há um atalho na página de análise: quando um candidato aceita oferta, um banner verde Vaga preenchida! aparece no topo com o botão Fechar vaga. Clicar nele põe o status em Pausada e oferece enviar rejeições aos demais candidatos em aberto. Você também pode enviar as rejeições sem fechar a vaga, ou descartar o banner caso tenha mais posições para preencher com a mesma vaga.