ooligo
n8n-flow

Alertas do funil de recrutamento com Ashby, PostgreSQL e n8n

Dificuldade
intermediário
Para
recruiting-leader · talent-acquisition · recruiting-ops
Recrutamento e TA

Stack

Use este workflow quando a equipe de operações de recrutamento precisar identificar qual vaga ou etapa merece uma investigação. O download inclui um coletor do Ashby, um esquema PostgreSQL e um workflow n8n inativo. O exemplo sintético produz quatro alertas a partir de dados agregados. Você pode examinar os dados que acionam cada alerta antes de conectar qualquer conta.

Execute o exemplo

Extraia o ZIP e execute python3 -B check_fixture.py com Python 3.10 ou posterior. Depois, exiba o snapshot usado pelos dois detectores:

python3 -B ashby_adapter.py --config config.example.json --fixture fixtures/ashby-pages.json --as-of 2026-11-02

A data é o limite final exclusivo em UTC. A janela diária cobre 1º de novembro e a semanal começa em 26 de outubro. Os dados de teste incluem duas páginas de candidaturas à vaga Analyst e duas páginas de histórico de uma candidatura. Também há uma vaga monitorada sem candidaturas e uma vaga adicionada recentemente. O coletor lê dez páginas de respostas sintéticas e inclui as três vagas no snapshot.

Alerta esperadoEvidência nos dados de teste
Queda na conversão de etapaDas quatro saídas de Screen com etapa seguinte observada, uma avançou para Onsite. A taxa de 25% fica abaixo da média de referência de 75% menos dois desvios-padrão de 10 pontos percentuais cada.
Tempo de permanência concluídoA mediana dos intervalos concluídos em Screen foi de 48 horas. O limiar do alerta é 1,5 vez o limite configurado de 24 horas.
Vaga sem movimentaçãoA vaga monitorada Quiet role não teve entradas nem saídas de etapa em sete dias. A vaga mais recente teve menos de sete dias de monitoramento e não gerou alerta.
Tendência do prazo de contrataçãoUma candidatura chegou à etapa de contratação configurada 59 dias após sua criação, acima do limite de 30 dias do exemplo. A amostra mínima configurada é de uma contratação.

fixtures/expected-alerts.json contém os dados esperados para cada alerta. Para o cenário com apenas um alerta, execute node check_postgres.mjs --one-alert após configurar o PGlite conforme o _README.md. A vaga sem movimentação gera uma entrada na fila na primeira execução e nenhuma nova entrada na segunda. No teste SQL completo, o detector de contratações é executado antes do detector de etapas. O primeiro gera um novo alerta de contratação e o segundo, três novos alertas de vaga ou etapa. Repetir ambos não cria alertas adicionais. Os limites e as pequenas amostras do exemplo ilustram as regras. Escolha referências e tamanhos mínimos de amostra adequados às suas métricas do funil.

Prepare a fonte e o banco de dados

Copie config.example.json e substitua todos os IDs fictícios de vaga e etapa, rótulos, datas de início do monitoramento, referências e limites. Defina quais etapas seguintes contam como avanço. Calcule a média e o desvio-padrão de referência com as taxas diárias elegíveis, usando o mesmo denominador de saídas concluídas. A regra exige pelo menos 20 dias de referência e desvio-padrão positivo. O coletor rejeita referências atualizadas há mais de 35 dias. Cabe a você recompor o histórico e agendar as atualizações das referências.

O coletor separado chama Ashby application.list para cada vaga monitorada e depois application.listHistory para cada candidatura. As duas requisições POST paginadas usam a permissão candidatesRead. O coletor ordena o histórico pelo número da etapa e usa IDs de etapa e registros de data e hora. Uma página ausente, um registro duplicado ou uma sequência inconsistente interrompe a coleta. A ausência de atividade só pode ser interpretada após a conclusão bem-sucedida de toda a coleta.

Aplique schema.sql com psql, defina ASHBY_API_KEY para o coletor e agende o comando de coleta real do _README.md antes das 02:00 UTC. A opção --persist armazena um snapshot completo usando a conexão PostgreSQL configurada. As tabelas são hfa.snapshots e hfa.alerts. Um snapshot idêntico pode ser carregado novamente. Um conteúdo diferente para a mesma data exige revisão. Nomes de candidatos, emails e IDs de candidatura ficam fora dos agregados armazenados. Revise os rótulos das vagas antes de enviá-los a serviços externos.

Conecte os dois detectores e a entrega

Importe hiring-funnel-anomaly-n8n.json no n8n. Vincule as credenciais de PostgreSQL, Anthropic Header Auth e Slack Header Auth. Em Check channel configuration, configure os IDs aprovados dos canais para etapas e para liderança. Mantenha o workflow inativo até que os dois detectores retornem os registros esperados em um banco de teste descartável. O coletor usa sua própria credencial do Ashby fora do n8n.

O detector das 02:00 UTC avalia conversão, permanência concluída e atividade das vagas em sete dias. A conversão considera saídas concluídas cuja etapa imediatamente seguinte foi observada antes do limite final. Saídas terminais sem sucessor e lacunas na numeração das etapas ficam de fora. A permanência mede intervalos concluídos. O alerta descreve uma etapa, sem identificar alguém que esteja aguardando nela. Às 03:00 UTC, o outro detector calcula de forma independente o intervalo entre a criação da candidatura e a primeira entrada na etapa de contratação configurada. Uma contratação só entra na contagem se o histórico estiver completo desde a etapa de número zero até essa entrada. Quando falta o início do histórico, não é possível verificar a primeira data de contratação e a candidatura fica fora dessa estatística. Confirme o significado dessa etapa no ATS antes de interpretar a métrica como tempo de contratação. Se faltar o snapshot do dia, cada detector retorna um erro explícito.

Os dois agendamentos gravam chaves estáveis de alerta na mesma fila de saída. Após cada detecção e a cada 15 minutos, o processo de entrega reserva uma linha pendente. O Claude recebe métricas agregadas para produzir uma explicação curta. O Slack recebe os números, a explicação e a chave de referência. Confira o resultado delivery_state e o campo state da linha. Para confirmar a entrega, a resposta do Slack deve conter ok:true, o canal e um registro de data e hora. Uma rejeição conhecida, como ok:false com channel_not_found, indica falha definitiva. Segundo o Slack, internal_error e fatal_error podem ocorrer após sucesso parcial. Esses erros, códigos desconhecidos, confirmações incompletas e timeouts de envio deixam o resultado incerto. Procure a referência no canal antes de decidir por uma nova tentativa. O workflow mantém os envios incertos aguardando revisão. Respostas do Slack

Verificação e custo operacional

Doze verificações offline em Python cobrem paginação, entradas inválidas, limites de datas, vagas sem candidaturas e estrutura da exportação. O SQL fornecido foi executado no PostgreSQL 18.6 via PGlite e, de forma independente, no PostgreSQL 18.4 nativo com dados sintéticos. Os testes executaram os dois ramos, compararam os dados exatos dos alertas e repetiram as execuções. As verificações do PGlite também cobriram reservas temporárias de entrega, confirmações de recebimento, rejeição definitiva e resultados incertos. A exportação foi importada sem modificação no n8n 2.45.7. Sete execuções pela CLI usaram cópias com triggers manuais, credenciais locais de teste e serviços simulados de modelo e Slack na interface de loopback. Os nós reais de SQL, Code e HTTP processaram quatro explicações simuladas e quatro postagens simuladas confirmadas, duas por canal. Repetir os ramos de etapa, contratação e entrega não acrescentou chamadas nem alertas. O README traz os comandos do exemplo. Ainda é preciso verificar os disparos nos horários previstos e as contas reais dos fornecedores.

Planeje o custo das candidaturas e páginas de histórico consultadas por vaga, do armazenamento PostgreSQL, das execuções do n8n e das chamadas ao modelo para alertas reservados. No exemplo com quatro alertas, quatro primeiras tentativas bem-sucedidas solicitam quatro explicações e quatro postagens no Slack. Novas tentativas antes do envio podem aumentar o uso do modelo. Meça os tokens, o atraso de entrega e o tempo de revisão no seu ambiente antes de definir um custo ou uma meta de resposta.

Use uma planilha ou o relatório atual do ATS se ninguém for responsável pelas referências, pelo roteamento ou pelo acompanhamento. Reavalie o detector quando as etapas tiverem definições estáveis e houver uma pessoa responsável pela revisão. A saída orienta a investigação das operações de recrutamento a partir de dados agregados. O workflow não altera dados no ATS.

Arquivos deste artefato

Baixar tudo (.zip)