An intelligent, rule-based WhatsApp bot for automated candidate screening and job matching. Built with n8n workflow automation - NO paid AI APIs required.
This WhatsApp hiring assistant automatically:
- ✅ Greets candidates and shares job update links
- ✅ Classifies work preferences (Work From Home / Work From Office)
- ✅ Matches candidates to relevant job openings
- ✅ Sends detailed job descriptions with application links
- ✅ Saves candidate data to Google Sheets for follow-up
- ✅ Asks clarifying questions when needed
Key Advantage: Uses pure rule-based keyword matching - no expensive AI APIs needed!
- Detects work preferences (WFH/WFO) from natural language
- Matches job keywords (BFSI, Virtual Assistant, etc.)
- Handles variations and synonyms
- Work From Home: Virtual Assistant job details
- Work From Office - Gurugram: BFSI & Capital Markets roles
- Unclear requests: Asks clarifying questions
- Automatically saves candidate information
- Separate sheets for WFH and WFO candidates
- Includes timestamp, name, phone, message, and classification
- Easy to add new jobs via configuration
- Keyword expansion without code changes
- Modular workflow structure
Virtual Assistant (VA) - Remote
- Salary: ₹6.5-8.5 LPA
- Shifts: Evening/Night (IST)
- Experience: 2+ years
- Apply Here
Capital Markets & BFSI Roles
- Salary: ₹32,000-39,000 CTC
- Positions: Wealth Management, Trading, Customer Support
- Experience: 6+ months in BFSI
- Apply Here
- n8n - Workflow automation platform
- Google Sheets API - Candidate database
- WhatsApp Business API - Messaging interface
- JavaScript - Rule-based logic in Code nodes
Total Cost: FREE (within API limits)
.
├── whatsapp_hiring_assistant.json # Main n8n workflow
├── deployment_guide.md # Step-by-step setup guide
├── implementation_plan.md # Technical documentation
├── ai_agent_design_guide.md # General AI agent design guide
├── ai_agent_cheat_sheet.md # Quick reference
├── example_whatsapp_ai_agent.json # Example AI agent workflow
└── README.md # This file
- n8n instance (self-hosted or cloud)
- Google account with Sheets access
- WhatsApp Business API access
-
Clone this repository
git clone https://github.com/YOUR_USERNAME/whatsapp-hiring-assistant.git cd whatsapp-hiring-assistant -
Import workflow into n8n
- Open n8n
- Go to Workflows → Import from File
- Select
whatsapp_hiring_assistant.json
-
Configure Google Sheets
- Create/verify candidate sheets
- Set up OAuth2 credentials in n8n
- Update credential IDs in workflow
-
Connect WhatsApp
- Get webhook URL from n8n
- Configure in WhatsApp Business API
- Subscribe to message events
-
Test & Deploy
- Activate workflow
- Send test messages
- Verify Google Sheets integration
📖 Detailed instructions: See deployment_guide.md
Scenario 1: First Contact
User: Hi
Bot: Hi 👋
Thank you for contacting Catalyst Hiring Solutions!
[Group links and instructions...]
Scenario 2: WFH Request
User: I'm looking for work from home jobs
Bot: 🚀 HIRING: Virtual Assistant (VA) – Remote
[Complete job details...]
Scenario 3: WFO Request
User: I want office job in Gurgaon for BFSI
Bot: 🔥 WE'RE HIRING – CAPITAL MARKETS & BFSI ROLES
[Complete job details...]
Scenario 4: Unclear Request
User: I need a job
Bot: Thank you for your interest! 😊
To help you better, could you please specify:
1️⃣ Work From Home or Work From Office?
2️⃣ Which type of role interests you?
Edit the Analyze Keywords code node:
// Add WFH keywords
const wfhKeywords = [
'work from home', 'wfh', 'remote',
'YOUR_NEW_KEYWORD' // Add here
];
// Add job-specific keywords
const bfsiKeywords = [
'bfsi', 'capital market',
'YOUR_NEW_KEYWORD' // Add here
];- Create response message in Set node
- Add Google Sheets save node
- Update routing logic in IF nodes
- Add keywords to analysis
See deployment_guide.md for detailed instructions.
WhatsApp Message
↓
Extract Data
↓
First Message? ──Yes──> Send Greeting
↓ No
Analyze Keywords
↓
Needs Clarification? ──Yes──> Ask Questions
↓ No
Classify Work Preference
↓
├─ WFH ──> VA Job Details ──> Save to WFH Sheet
├─ WFO ──> BFSI Job Details ──> Save to WFO Sheet
└─ Unclear ──> General Response
↓
Send WhatsApp Response
WFH Candidates Sheet:
WFO Gurugram Candidates Sheet:
Columns:
- Timestamp
- Name
- Phone
- Message
- Work Preference
- Job Match
Run these test scenarios:
# Test 1: Greeting
curl -X POST https://your-n8n.com/webhook/whatsapp-hiring-webhook \
-H "Content-Type: application/json" \
-d '{"from": "+919876543210", "message": "Hi", "name": "Test User"}'
# Test 2: WFH Request
curl -X POST https://your-n8n.com/webhook/whatsapp-hiring-webhook \
-H "Content-Type: application/json" \
-d '{"from": "+919876543210", "message": "work from home virtual assistant", "name": "Test User"}'
# Test 3: WFO Request
curl -X POST https://your-n8n.com/webhook/whatsapp-hiring-webhook \
-H "Content-Type: application/json" \
-d '{"from": "+919876543210", "message": "office job gurgaon bfsi", "name": "Test User"}'| Issue | Solution |
|---|---|
| Google Sheets not saving | Check credentials and sheet permissions |
| Webhook not receiving | Verify WhatsApp API configuration |
| Wrong job response | Add more specific keywords |
| Clarification loop | Expand keyword arrays |
See deployment_guide.md for detailed troubleshooting.
- Deployment Guide - Complete setup instructions
- Implementation Plan - Technical architecture
- AI Agent Design Guide - General guide for building AI agents
- Cheat Sheet - Quick reference
Contributions welcome! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
MIT License - feel free to use for your own hiring needs!
Catalyst Hiring Solutions
- Multi-language support
- Voice message handling
- Interview scheduling integration
- Resume parsing
- Advanced analytics dashboard
- Multi-location support
Built with ❤️ using n8n workflow automation