MUHAMMAD AHMAD SIDDIQUI

Full Stack & AI Engineer

000

Available for work·Book a call
All Projects/Act Angel AI

Full Stack Developer

Act Angel AI

AI-assisted recruitment workspace, rebuilds a Salesforce recruiting app as a fast HR tool where one status change sends an AI agent to call, WhatsApp, or email the candidate

Next.js 16React 19TypeScriptTailwind CSSshadcn/uiTanStack TableRechartsReact Hook FormZodSalesforce REST APIPostgreSQLPostgRESTUpstash RedisNextAuth (Google OAuth)n8nVercel
Act Angel AI

Overview

Act Angel AI is a recruitment and employee management platform that replaces a Salesforce Lightning recruiting app with a modern, purpose-built HR workspace. HR teams manage job applications, positions, candidate contacts, reviews, interviews, and employees from one fast interface, while Salesforce stays the system of record underneath. The platform is designed to work alongside AI recruitment agents: moving a candidate into an outreach status hands them to an AI agent that contacts them by phone, WhatsApp, or email, and the resulting call recordings, transcripts, and outcomes flow back onto the application. A public careers site lets candidates browse roles, apply through a two-step form with resume upload, and check their application status with a passwordless link.

The Challenge

The existing recruiting process lived inside Salesforce Lightning, powerful but slow for day-to-day HR work, and hard to extend with AI agents or reuse for other clients. The new app had to keep every existing record, relationship, and identifier intact, match 24 live Salesforce picklist statuses exactly (the AI backend matches on those strings, and some statuses place a real phone call), and run on serverless infrastructure without a long-lived database connection. It also needed staff-only access, an append-only audit trail of every status change and AI action, and fast list views over Salesforce data without hitting API limits.

How We Solved It

1

Salesforce as System of Record

The app's own Next.js API routes read and write Salesforce directly through its REST API using an OAuth 2.0 client, with retry-on-401 token refresh. Because serverless functions have no long-lived memory, the Salesforce access token and hot lookups are cached in Upstash Redis. Adapters translate Salesforce objects into clean application, position, contact, review, and employee models for the UI.

2

AI-Triggered Candidate Outreach

A single status config drives badges, dropdowns, pipeline columns, and allowed transitions for all 24 Salesforce statuses. Moving a candidate to 'Initiate Outreach' hands them to the AI recruitment backend, which contacts them and updates the record to 'AI Contacted to Call / WhatsApp / Email'. AI call recordings with an audio player and full transcript appear on the application, and AI-flagged conversations and failed calls surface as notifications.

3

HR Workspace

Searchable, filterable application lists with scores and bulk status updates; a drag-and-drop Kanban pipeline; application detail pages with reviews, resume preview, notes, attachments, and call records; positions with one-level approval before posting; candidate contacts as first-class records; an interview calendar; and an employee directory covering onboarding, exits, and history.

4

Dashboards & Reporting

An HR dashboard shows applications by position this month versus last, HR call outcomes, applications with reviews, the final-round shortlist against target, and selected candidates yet to join. Reports cover the hiring funnel (applied → reviewed → screened → interviewed → offered), applications over time, screening and interview rates, and time to screen, with CSV export.

5

Public Careers Site & Status Portal

Candidates browse open roles by team, read full job descriptions, and apply through a two-step form (personal details, then experience, pay, and documents) with Zod validation, international phone parsing, and PDF/DOCX resume upload. They receive a reference number and can check their progress through a passwordless email-link portal.

6

Access Control & Audit Trail

Staff sign in with Google through NextAuth; API routes verify the JWT and resolve roles from an app_users table behind PostgREST, cached in Redis. Admins manage users and roles and configure notification recipients. An append-only audit log records every status change, AI action, note, and email with actor and timestamp, and it can't be edited.

HR Workspace

Dashboards & Reports

Employees

Careers Site & Candidate Portal

Results & Impact

24 Live Salesforce Statuses

Every status matches the live Salesforce picklist exactly, driving badges, pipeline columns, transitions, and AI triggers from one config.

AI Outreach on One Click

A single status change hands a candidate to an AI agent that reaches out by call, WhatsApp, or email, with recordings and transcripts logged back.

Zero Data Migration Loss

Salesforce stays the system of record, so every existing application, contact, review, and attachment is available from day one.

Serverless-Ready

Runs on Vercel with Redis-cached Salesforce tokens and role lookups, and health checks for Salesforce and Postgres connectivity.

End-to-End Candidate Journey

From careers page and two-step application to AI screening, review, interview, offer, and a passwordless status portal.

Append-Only Audit Log

Every status change, AI action, note, and email is recorded with actor and timestamp for full traceability.

Original Project

Client's product site

Company website

actangel.ai (opens in a new tab)

Marketing site of the client company.

Technical Architecture

FrontendNext.js 16 (App Router) + React 19 + TypeScript + Tailwind CSS + shadcn/ui, HR workspace, TanStack Table lists, Kanban pipeline, Recharts dashboards, careers site, status portal
Forms & ValidationReact Hook Form + Zod, application intake, position editor, reviews; libphonenumber-js for international phone numbers; react-pdf resume viewer
BackendNext.js API routes, job applications, positions, contacts, reviews, attachments, status transitions, bulk updates, reports, admin, health checks
System of RecordSalesforce REST API, applications, positions, contacts, reviews, files, and call records; OAuth 2.0 with token refresh
App Data & CachePostgreSQL via PostgREST, app users, audit log, notification config; Upstash Redis, Salesforce token and role caching
AuthNextAuth with Google OAuth for staff sign-in; jose JWT verification and role-based access in API routes
AI & HostingAI recruitment backend and n8n workflows for call, WhatsApp, and email outreach; deployed on Vercel with auto-deploy from GitHub

Have a similar project?

I'm open to freelance projects and full-time roles. Let's build something great together.