Operational Command Manual — v1.0

SWATI India
Market Entry Agent

An AI-powered command centre for discovering Indian distributors, generating hyper-personalised outreach, and managing your sales pipeline — end to end.

What This Agent Does

SWATI's India Market Entry Agent automates the three hardest steps of market expansion: finding the right distributors, crafting the right message, and tracking every relationship to deal closure.

1,248
Leads Discovered
↑ +12% this week
856
Outreach Sent
↑ +18% this week
42
Active Pipelines
↑ +5% this week
4.2%
Conversion Rate
↑ +1.2% this week

🔍
AI Distributor Discovery
Gemini AI scans the Indian market and returns ranked, qualified distributors with contact details and relevance scores — in seconds.
✍️
AI Outreach Generator
Instantly crafts personalised cold-email and LinkedIn DM copy tailored to each distributor's profile and your brand pitch.
📋
Kanban Pipeline
Drag-and-drop sales pipeline tracks every lead from Identified → Contacted → Responded → Negotiation → Closed, with state persistence.
📊
Live Insights Dashboard
Real-time conversion funnel visualisation and activity feed keep the team aligned on progress without any manual reporting.
🔒
Secure Login
Role-based access with a dedicated login gate ensures only authorised team members can enter the command centre.
⚙️
Settings & Integrations
Configure API keys, brand profiles, and notification preferences from a centralised settings panel.

Six Core Modules

Each module has a dedicated route in the dashboard. Here is how to use each one.

01
📊 /dashboard

Overview Dashboard

The command centre home screen. Provides a bird's-eye view of all KPIs, a live conversion funnel chart, and a chronological activity feed of recent actions.

  • KPI Cards: Total Leads, Active Pipelines, Outreach Sent, Conversion Rate — each with week-on-week change.
  • Conversion Funnel: Visual chart showing lead drop-off at each pipeline stage.
  • Activity Feed: Timeline of the last 20 actions (outreach sent, pipeline moves, new leads).
Total Leads
1,248 ↑12%
Outreach Sent
856 ↑18%
Pipelines
42 ↑5%
Conversion
4.2% ↑1.2%
[ Conversion Funnel Chart ]
02
🔍 /dashboard/discovery

AI Distributor Discovery

Enter your brand name, product category, and target cities. The Gemini AI agent returns a ranked list of qualified Indian distributors with relevance scores, emails, and phone numbers.

  • Enter Brand Name (e.g. SWATI Cosmetics)
  • Enter Category (e.g. Beauty & Personal Care)
  • Enter Target Cities — comma-separated (e.g. Mumbai, Delhi, Pune)
  • Click Generate Leads — results appear in the table below
  • Use Add All to Pipeline to bulk-import leads, or add individually
Tip: The relevance score (0–100) is AI-computed. Leads scoring ≥ 90 are shown in green — prioritise these first.
Brand Name
SWATI Cosmetics
Category
Beauty & Personal Care
Target Cities
Mumbai, Delhi, Pune
🔍 Generate Leads
Apex Retail Solutions · Mumbai94
Global Trade Partners · Delhi88
Nexus Supply Co · Pune81
03
✍️ /dashboard/outreach

AI Outreach Generator

Paste a distributor name and optional brand context. The AI writes a fully personalised cold email and a LinkedIn DM simultaneously. One-click copy to clipboard or send directly.

  • Enter Target Distributor name
  • Optionally add Brand Pitch / Context (margins, USP, key stats)
  • Click Generate Copy — both email and LinkedIn drafts appear
  • Hover the output card to reveal Copy and Execute Send buttons
Route: POST /api/generate-copy — powered by Google Gemini Flash. Secure server-side key management via environment variables.
Target Distributor
Apex Retail Solutions
Brand Pitch (optional)
30% margin, proven Tier-2 city sales...
✨ Generate Copy
📧 Email Draft
Subject: Partnership Opportunity — SWATI Cosmetics
Dear Apex team, I'm reaching out...
💬 LinkedIn DM
Hi [Name], loved what Apex is doing in Mumbai retail...
04
📋 /dashboard/pipeline

Sales Pipeline (Kanban)

Drag-and-drop Kanban board with five stages. All card positions are persisted to localStorage so your pipeline state survives page refreshes and browser restarts.

  • Lead Identified → discovered but not yet contacted
  • Contacted → outreach sent, awaiting reply
  • Responded → distributor replied (shown with ⚠️ alert icon)
  • Negotiation → terms being discussed
  • Closed → deal signed
Drag-and-Drop: Grab any lead card and drop it into the target stage column to update its status instantly.
Identified
Apex Retail
Apex India94
Future Group
FRL75
Contacted
Nexus Supply
Nexus Brands81
Closed
Reliance Retail
RRL98

From Zero to Closed Deal

Follow this six-step operating procedure to run a complete India market entry campaign using the agent.

1

Log In to the Command Centre

Navigate to swati-india-agent.vercel.app. Enter your credentials on the login screen. You will be redirected to the Overview Dashboard on successful authentication.

2

Run AI Discovery to Build Your Lead List

Go to Discovery. Enter SWATI Cosmetics as brand, Beauty & Personal Care as category, and your target cities. Click Generate Leads. Review the AI-ranked table — focus on leads scoring ≥ 90 first.

3

Add Selected Leads to the Pipeline

Click Add All to Pipeline or the individual row Add → button. Each lead appears in the Lead Identified column on the Pipeline board automatically.

4

Generate Personalised Outreach Copy

Navigate to Outreach. Enter the distributor name and a one-paragraph brand pitch (margins, USP, territory exclusivity). Click Generate Copy. Review, edit if needed, then copy or send.

5

Track Responses in the Pipeline Board

When a distributor replies, drag their card from Contacted to Responded. The orange ⚠️ icon will flag the card, reminding you to take immediate follow-up action.

6

Close the Deal and Review Insights

Move the card to Closed once the agreement is signed. Visit the Insights module to review funnel drop-off rates and optimise future discovery or outreach strategies.

Backend Endpoints

MethodRoutePurposeRequired Body
POST/api/find-leadsAI distributor discoverybrandName, category, cities[]
POST/api/generate-copyAI outreach copy generationdistributorName, brandDescription
Security: All API routes are server-side Next.js Route Handlers. The Gemini API key is stored in .env.local and never exposed to the client. Do not commit .env.local to Git.

Built With

Framework
Next.js 15 (App Router)React 19TypeScript
Styling
Tailwind CSS v4Framer MotionLucide Icons
AI / Backend
Google Gemini FlashNext.js Route HandlersPrisma ORM
Infrastructure
Vercel (Production)GitHub CI/CDEnvironment Variables

Common Questions

Why did lead generation fail?
This is most often caused by an ad-blocker intercepting the fetch to /api/find-leads. Disable the ad-blocker for this domain, or add an exception for localhost when testing locally.
Is my pipeline data saved?
Yes. Pipeline card positions are persisted to localStorage. They survive page refreshes and browser restarts, but are browser-specific. A database sync is on the roadmap.
How do I update the Gemini API key?
Edit .env.local in the project root and set GEMINI_API_KEY=your_key. In Vercel production, update the key in Project → Settings → Environment Variables, then redeploy.
How do I deploy changes?
Push to the main branch on GitHub. Vercel auto-deploys on every push within 30–60 seconds. Check the Vercel dashboard for build logs and deployment status.
Can I add more pipeline stages?
Yes. Edit the STAGES array in app/dashboard/pipeline/page.tsx. Add a new object with an id, label, and Tailwind color class, then redeploy.
Which cities are supported for discovery?
Any Indian city can be entered — the AI is not limited to a fixed list. Enter multiple cities separated by commas: Mumbai, Delhi, Bengaluru, Hyderabad, Chennai.