Developer Docs
Inbox Automation Pattern
Build inbox-driven automation to detect job descriptions in email, call matching, and return candidate shortlists automatically.
The inbox automation pattern scans incoming job-description emails, calls Vitae matching, and drafts shortlist responses for recruiter approval. It reduces triage time without removing human control.
Pipeline stages
- Detect inbound emails likely to contain role briefs.
- Extract role requirements into structured text.
- Submit matching request to Vitae endpoint.
- Generate shortlist draft with candidate links.
- Require human approval before any external send.
Data quality guardrails
- Require minimum extraction confidence before matching
- Flag missing role essentials (seniority, domain, mandatory skills)
- Fallback to manual routing when extraction quality is low
Quota-aware behavior
Prioritize urgent client requests when daily budget is low. Queue low-priority emails and process them during off-peak periods.
Operational checklist
Before go-live
- Implement 429 and 5xx retry strategy with backoff
- Add queue depth alerts
- Log each stage with correlation IDs
- Create fallback queue for failed extractions
- Document manual override workflow for recruiters
Human-in-the-loop recommendation
Keep a recruiter approval gate for outbound client emails. Automation should assist decisions, not auto-send final client submissions.