ooligo
n8n-flow

Alertas del embudo de contratación con Ashby, PostgreSQL y n8n

Dificultad
intermedio
Para
recruiting-leader · talent-acquisition · recruiting-ops
Reclutamiento y TA

Stack

Usa este workflow cuando el equipo de operaciones de recruiting necesite saber qué vacante o etapa merece una revisión. La descarga incluye un recolector de Ashby, un esquema de PostgreSQL y un workflow de n8n inactivo. El ejemplo sintético genera cuatro alertas agregadas. Puedes revisar la evidencia de cada una antes de conectar cuentas.

Ejecuta el ejemplo

Extrae la descarga y ejecuta python3 -B check_fixture.py con Python 3.10 o posterior. Luego imprime la instantánea que alimenta ambos detectores.

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

La fecha es el límite superior exclusivo en UTC. La ventana diaria cubre el 1 de noviembre y la semanal empieza el 26 de octubre. El ejemplo contiene dos páginas de candidaturas para Analyst y dos páginas de historial para una candidatura. También incluye una vacante supervisada sin candidaturas y otra añadida hace poco. El adaptador lee diez páginas sintéticas e incorpora las tres vacantes a la instantánea.

Alerta esperadaEvidencia del ejemplo
Caída de conversiónUna de cuatro salidas completadas de Screen avanzó a Onsite. El 25% queda por debajo de la media de referencia del 75% menos dos desviaciones de 10 puntos porcentuales.
Permanencia en etapaLa mediana de los intervalos completados en Screen fue de 48 horas. El umbral es 1,5 veces el límite configurado de 24 horas.
Vacante sin movimientoQuiet no tuvo entradas ni salidas en siete días. La vacante reciente llevaba menos de siete días bajo supervisión y no generó alerta.
Tendencia de contrataciónUna candidatura llegó a la etapa de contratación 59 días después de su creación, por encima del umbral de ejemplo de 30 días. El mínimo configurado es una contratación.

fixtures/expected-alerts.json contiene los resultados esperados. Para ver una sola alerta, ejecuta node check_postgres.mjs --one-alert tras configurar PGlite según _README.md. El escenario de la vacante inactiva encola una alerta la primera vez y cero alertas nuevas la segunda. La comprobación SQL completa ejecuta primero el detector de contratación y luego el de etapas. Obtiene una alerta de contratación y tres de etapa o vacante. Al repetir ambos, se crean cero alertas adicionales. Define valores de referencia y muestras mínimas adecuados para tus métricas del embudo.

Prepara la fuente y la base de datos

Copia config.example.json y sustituye todos los ID, etiquetas, fechas de supervisión, valores de referencia y límites inventados. Define qué etapas posteriores cuentan como avance. Calcula la media y la desviación históricas con tasas diarias elegibles y el mismo denominador de salidas completadas. La regla exige al menos 20 días de referencia y una desviación positiva. El recolector rechaza referencias actualizadas hace más de 35 días. Tu equipo debe preparar el historial y programar las actualizaciones.

El recolector independiente llama a application.list de Ashby por cada vacante supervisada y a application.listHistory por cada candidatura. Ambos usan POST con paginación y permiso candidatesRead. El adaptador ordena el historial por número de etapa y usa ID y marcas de tiempo. Una página faltante, un registro duplicado o una secuencia incoherente detiene toda la recolección. Cero actividad solo tiene sentido tras completar correctamente esa lectura.

Aplica schema.sql con psql, configura ASHBY_API_KEY para el recolector y programa el comando real de _README.md antes de las 02:00 UTC. --persist guarda una instantánea completa en la conexión PostgreSQL configurada. Las tablas son hfa.snapshots y hfa.alerts. Una instantánea idéntica se puede cargar otra vez. Un resultado distinto para la misma fecha requiere revisión. Los agregados guardados excluyen nombres, emails e ID de candidaturas. Revisa las etiquetas de vacantes antes de enviarlas a servicios externos.

Conecta los dos detectores y la entrega

Importa hiring-funnel-anomaly-n8n.json en n8n. Asigna las credenciales de PostgreSQL, Anthropic Header Auth y Slack Header Auth. Configura los ID de los canales aprobados para etapas y liderazgo en Check channel configuration. Mantén inactivo el workflow hasta que ambos detectores devuelvan las filas esperadas en una base desechable. El recolector usa su propia credencial de Ashby fuera de n8n.

El detector de las 02:00 UTC evalúa conversión, permanencia completada y actividad de la vacante durante siete días. La conversión cuenta las salidas completadas con una etapa posterior consecutiva observada antes del corte. Excluye las salidas terminales sin sucesor y los saltos en la numeración. La permanencia corresponde a intervalos terminados y describe una etapa, no a una persona actualmente en espera. El detector de las 03:00 calcula de forma independiente los días desde la creación de la candidatura hasta la primera entrada en la etapa de contratación definida. Solo cuenta una contratación cuando el historial está completo desde el ordinal cero hasta la entrada en esa etapa. Si falta la parte inicial, no se puede verificar la primera fecha de contratación y la candidatura queda fuera de este indicador. Confirma el significado de la etapa en tu ATS antes de interpretar el indicador como tiempo de contratación. Ambos detectores fallan de forma visible si falta la instantánea del día.

Los dos horarios guardan claves estables en la misma bandeja de salida. Después de detectar y cada 15 minutos, una ejecución reserva una fila pendiente. Claude recibe métricas agregadas para redactar una explicación breve. Slack recibe las cifras, la explicación y la referencia. Comprueba el resultado delivery_state y el campo state de la fila. Una respuesta confirmada incluye ok:true, canal y marca de tiempo. Un rechazo conocido, como ok:false con channel_not_found, registra un fallo de entrega. Slack indica que internal_error y fatal_error pueden ocurrir tras un éxito parcial. Esos errores, los códigos desconocidos, las confirmaciones incompletas y los tiempos de espera dejan incierta la aceptación. Busca la referencia en el canal antes de decidir si reintentar. El paquete retiene los envíos inciertos para revisión. Consulta el contrato de respuestas de Slack.

Verificación y costo operativo

Doce comprobaciones locales de Python cubren paginación, datos inválidos, límites temporales, vacantes vacías y estructura del workflow. El SQL se ejecutó con datos sintéticos en PostgreSQL 18.6 mediante PGlite y, por separado, en PostgreSQL 18.4 nativo. Se comprobaron los dos detectores, las alertas exactas y la repetición. PGlite también verificó las reservas de entrega, confirmaciones, rechazos explícitos y resultados inciertos. El archivo original se importó en n8n 2.45.7. Siete ejecuciones por CLI usaron copias con activadores manuales, credenciales locales y endpoints simulados para el modelo y Slack. Los nodos SQL, Code y HTTP procesaron cuatro explicaciones y cuatro envíos simulados confirmados, dos por canal. Repetir los detectores y la entrega añadió cero llamadas o alertas. El README incluye los comandos. Los horarios reales y las cuentas de los proveedores requieren una ejecución por tu equipo.

Presupuesta las páginas de candidaturas e historiales por vacante, almacenamiento PostgreSQL, ejecuciones de n8n y llamadas al modelo para las alertas reservadas. En el ejemplo de cuatro alertas, cuatro primeros intentos exitosos solicitarían cuatro explicaciones y cuatro envíos a Slack. Los reintentos previos al envío pueden consumir más tokens. Mide los tokens, la demora de entrega y el tiempo de revisión en tu entorno antes de fijar un objetivo de costo o respuesta.

Usa una hoja de cálculo o el informe de tu ATS si nadie se responsabiliza de las referencias, el enrutamiento o el seguimiento. Reconsidera el detector cuando existan etapas estables y una persona encargada de revisar las señales. Los resultados apoyan la investigación de operaciones agregadas de recruiting. El workflow no modifica registros en el ATS.

Archivos de este artefacto

Descargar todo (.zip)