Generate employee retention analytics reports with GPT-4o and Gmail digests

Description

This workflow automates employee retention analytics by combining candidate performance data with trait-level retention statistics. It scores candidates, validates data, and generates a polished Retention Digest HTML email using GPT (Azure OpenAI). Hiring managers receive structured insights weekly, highlighting top/weak traits, candidate scores, and actionable JD refinement tips.

What This Template Does (Step-by-Step)

⚡ Manual Trigger – Starts workflow execution on demand.
📑 Candidate Data Fetch (Google Sheets – Hires Tracking) – Pulls candidate-level details like name, role, traits, start date, and retention status.
📑 Trait Summary Fetch (Google Sheets – Retention Summary) – Fetches aggregated trait-level retention statistics, including hires, stayed, left, retention %, and weight adjustments.
🔀 Merge Candidate + Trait Data – Combines both datasets into a unified stream for scoring.
🧮 Candidate Scoring & Data Normalization (Code Node) –

• Cleans and standardizes data.
• Builds a trait → weight map.
• Calculates each candidate’s Candidate_Score.
• Outputs normalized JSON.
• ✅ Data Validation (If Node) – Ensures both candidate and trait datasets are present.
• TRUE → continues to AI digest generation.
• FALSE → routes to error logging.
• ⚠️ Error Handling Logic (Google Sheets – Error Log) – Logs any failed or incomplete runs into a dedicated error sheet for auditing.
• 🧠 AI Processing Backend (Azure OpenAI) – Prepares candidate + trait data for GPT processing.
• 🤖 Retention Digest Generator (LLM Chain) – Uses GPT (gpt-4o-mini) to create a structured HTML Retention Digest, including:
• TL;DR summary
• Top Traits (positive retention)
• Weak Traits (negative retention)
• Candidate highlights (scores & retention status)
• 3 actionable JD refinement tips
• 📧 Email Delivery (Gmail) – Sends the digest directly to hiring managers as a styled HTML email with subject:
• Retention Analysis Digest – Weekly Update

Prerequisites

Google Sheets (Hires Tracking + Retention Summary + Error Log)
Gmail API credentials
Azure OpenAI access (gpt-4o-mini model)
n8n instance (self-hosted or cloud)

Key Benefits

✅ Automates retention analytics & reporting
✅ Provides AI-powered insights in structured HTML
✅ Improves hiring strategy with trait-based scoring
✅ Reduces manual effort in weekly retention reviews
✅ Ensures reliability with error handling & validation

Perfect For

HR & Recruitment teams monitoring post-hire retention
Organizations optimizing job descriptions & hiring strategy
Talent analytics teams needing automated, AI-driven insights
Stakeholders requiring clear weekly digest emails