Real-time Automated Lead Management System (LMS)

🔹 Project Overview
The Automated LMS is a high-performance enterprise solution designed to bridge the gap between digital marketing (Meta Ads) and sales conversion. It automates the entire lead lifecycle—from real-time ingestion via Meta Webhooks to automated distribution, VoIP communication, and follow-up scheduling.

Initially joined as a member of a 3-person team, I eventually took full technical ownership of the project, overseeing the transition from manual Excel-based workflows to a fully automated, real-time ecosystem. The system is built on a role-based architecture that empowers counselors to manage leads, track conversions, and communicate with prospects directly through a unified dashboard.

• Role: Full Stack Developer & Project Lead

• Project Type: Industrial SaaS / Internal Automation Product

• Status: Live & Operational (Internal Production)

🔹 Lead Automation & Real-Time Flow

• Meta API Automation: Built a server-to-server integration using Meta Webhooks and Graph API. This captures Facebook Lead Form data instantly, bypassing the need for manual CSV downloads and reducing lead response time by 80%.

• Intelligent Routing: Implemented a backend distribution algorithm that assigns leads to available counselors based on pre-defined logic (e.g., workload, expertise), ensuring a balanced and efficient sales funnel.

• Multi-Channel Support: Integrated handlers for leads coming from Facebook, WhatsApp, and Website forms, centralizing all prospect data into a single source of truth.

🔹 Key Features & Functionalities

🔐 Role-Based Access Control (RBAC)

• Implemented secure authentication using JWT and role-specific middleware to isolate data between Counselors, Managers, and Super-Admins.

• Ensured that sensitive lead data and conversion metrics are only accessible to authorized personnel.

📞 Integrated VoIP & Communication

• Developed a built-in calling system using Twilio (VoIP), allowing counselors to call leads directly from the browser.

• Features include automatic call logging, duration tracking, and status updates, providing 100% transparency in the sales process.

📊 Task Management & Lead Tracking

• Built a comprehensive task management module to assign follow-ups, set priorities, and track the "Lead Journey" from "New" to "Converted."

• Integrated Socket.IO and Redis for instant desktop notifications, ensuring counselors never miss a high-priority lead.

📅 Scheduling & Automated Reminders

• Developed a scheduling engine for setting appointments and follow-up calls.

• Implemented automated system-wide reminders and background jobs (using BullMQ/Redis) to notify counselors of upcoming tasks.

🔹 Challenges & Solutions

🔴 Challenge 1: Navigating the Meta/Facebook API Complexity

• Problem: Meta’s documentation is vast and the App Review/Webhook setup is notoriously difficult for first-time implementations.

• Solution: Conducted extensive research and "trial-and-error" testing to configure the Webhook listener correctly. Successfully managed the App Review process to gain live production permissions for lead retrieval.

🔴 Challenge 2: Eliminating Data Bottlenecks (The "Excel Era")

• Problem: The firm relied on manual bulk uploads which caused data delays and human errors.

• Solution: Engineered the real-time ingestion pipeline that handles high-volume lead traffic without manual intervention, ensuring data is always fresh and actionable.

🔴 Challenge 3: Real-time Data Consistency at Scale

• Problem: Keeping multiple counselors updated on lead status changes in real-time without refreshing the page.

• Solution: Leveraged Socket.io for bi-directional communication and Redis for state caching, ensuring the UI reflects real-time updates across all active sessions.

🔴 Challenge 4: Taking Full Project Ownership Mid-Way

• Problem: After the departure of original team members, the project faced a loss of architectural context.

• Solution: I took charge of the full-stack codebase, performed critical bug fixes, refactored legacy code to Prisma ORM, and successfully deployed the system using Docker.

🔹 Frontend Architecture & Technologies

• Next.js (App Router) – Optimized for performance and SEO-friendly structure.

• TypeScript – Ensures type-safety across complex lead data models.

• Redux Toolkit / RTK Query – For efficient state management and API caching.

• Tailwind CSS & ShadCN UI – For a clean, professional enterprise dashboard.

• Socket.IO Client – For real-time lead alerts.

🔹 Backend Architecture & Technologies

• Node.js & Express – Scalable RESTful API architecture.

• Prisma ORM & MongoDB – Flexible schema handling for diverse lead data.

• Redis & BullMQ – For background tasks, reminders, and event queues.

• Twilio API – Integrated VoIP and messaging services.

• Docker – Containerization for consistent production environments.

🔹 My Role & Impact

• Lead Developer: Responsible for the end-to-end architecture, from Meta API integration to the VoIP communication layer.

• Automation Specialist: Successfully reduced operational overhead by automating 100% of the lead ingestion process.

• Product Visionary: Strategized future enhancements like WhatsApp Flows and AI-driven call analytics to keep the platform ahead of the curve.