Project Description: WhatsApp Lead Generator + Outreach Automation (Google Maps → WhatsApp Web) 1) Goal of the Project Build a marketing application that: collects business leads from Google Maps (based on a target market), organizes and filters those leads, automatically sends personalized WhatsApp messages using WhatsApp Web, tracks replies and qualifies leads using AI, outputs a clean list of “Qualified / Not Qualified / Follow-up needed”. This system is intended for outreach to businesses found on Google Maps (e.g., restaurants, clinics, salons, workshops, etc.) in specific locations and categories. 2) What the App Must Do (Core Workflow) A) Lead Collection from Google Maps User selects: Business category/keywords (example: “dentist”, “gym”, “real estate agency”) City/area (example: “Muscat”, “Ghala”, “Dubai Marina”) Optional filters (rating, number of reviews, open now, etc.) App collects business data and saves it into a database: Business name Category Address Phone number (if available) Website (if available) Google Maps link Rating + number of reviews Any other visible fields needed App prevents duplicates (same phone, same maps link). B) Lead List Management (CRM-like) Leads appear in a table with: search source (keyword + location) lead status (New / Ready / Messaged / Replied / Qualified / Not Qualified / Follow-up) notes tags (e.g., “high rating”, “has website”, “no website”, “no phone”) Basic operations: search, filter, sort, export CSV manually edit lead data manually change status C) WhatsApp Web Automation (Messaging Engine) User connects WhatsApp by opening WhatsApp Web inside the app and scanning the QR code. App can send messages automatically to leads only when a WhatsApp-valid number exists. User can create campaigns: pick a lead list (from a search) choose target segment (filters) select message template schedule sending or send now App must include: sending speed controls (delay range like 20–60 seconds) daily limits random delays to reduce risk pause/resume/stop campaign For each lead, store: message sent time message text used delivery status (sent/failed) last contact timestamp D) AI Message Writing (Personalized Outreach) User defines: the offer (example: “We build websites for local businesses”) target type (example: “clinics in Muscat”) tone (formal/friendly) language (English/Arabic/etc.) AI generates messages based on lead info: business name category location website presence (if missing, propose value) Support message variations: first message follow-up message #1 follow-up message #2 User can approve templates before sending. E) Reply Tracking and AI Qualification App monitors incoming replies in WhatsApp Web and attaches them to the correct lead. AI reads replies and classifies leads into: Qualified (interested / asks price / wants call) Not Qualified (not interested / wrong business) Follow-up Needed (no clear answer / asked to contact later) AI should extract key info from replies, for example: interest level budget signals (if mentioned) preferred contact time objections (too expensive, already has provider, etc.) App suggests next action: send follow-up book a call mark as not qualified assign to sales 3) Main Screens (Minimum UI) Login / User Management (basic) Google Maps Lead Search input keywords + location start scraping/collecting show progress and results count Leads Database table of leads, filters, tags, status Campaigns create campaign, choose leads, choose AI template, start sending campaign monitoring page (sent, failed, remaining) Inbox / Conversations list of active chats and replies AI qualification result + suggested response button Settings WhatsApp Web connection status sending limits and delays AI provider/API key settings 4) Admin / Control Features (Required) Role: Admin (full access), Operator (limited) Audit log for: who launched campaigns who edited templates who changed lead status