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

  1. Detect inbound emails likely to contain role briefs.
  2. Extract role requirements into structured text.
  3. Submit matching request to Vitae endpoint.
  4. Generate shortlist draft with candidate links.
  5. 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.