📖 Viewing Guide As: Standard Workspace User
1 Open Portal ☀️ Clean Light
2 Register Org Admin Account
3 Auto-Seed 86 Lists + 4 Nos
4 Start Session WAMGW Socket
5 Scan QR Linked Devices
6 Suite & Market WA + Shop + Payouts
Part 1

Selecting Clean Light Theme & Registering Your Workspace

  1. Open the WAM Enterprise Portal: Navigate to https://wamithra.com in your browser. Select ☀️ Clean Light from the theme selector dropdown in the top navigation bar.
  2. Open the Self-Service Registration Modal: Click Register Workspace (or Start Free Workspace) on the landing page.
  3. Complete Your Workspace Details:
    • Full Name: Enter your operator display name (e.g., Karthik Krishnan).
    • Flexible Identifier (Choose Any):
      • Work Email: Enter your login email (e.g., karthik@gknit.co.in). Phone number can be left blank.
      • WhatsApp Phone Number: Enter your mobile number (e.g., 919876543210). Email can be left blank.
      • Both: Provide both for dual-channel notifications.
    • Organization / Workspace Name: Enter your workspace name (e.g., GKNIT Clean Light Hub).
    • Password: Enter a secure password (minimum 8 characters).
    • Dual-Channel Password Reset: Accounts with an email can reset via an email token link; accounts with a phone number can reset via a 6-digit WhatsApp OTP.
  4. Create Workspace: Click Create Workspace & Launch Control Plane.
⚠️ IMPORTANT NOTICE — WHATSAPP MESSAGING DISCLAIMER
Please Read Carefully Before Subscribing or Registering: WAMAN is an independent software service provider and is not affiliated with, endorsed by, or authorized by WhatsApp LLC or Meta Platforms Inc. WhatsApp is a third-party service that may restrict messaging policies or accounts at its sole discretion; messaging functionality and delivery are not guaranteed. Subscription fees cover access to WAMAN software tools only and do not guarantee delivery or account immunity.
✨ Automatic Provisioning on Registration: Creating a workspace automatically provisions your isolated tenant, assigns you as Admin, creates all 86 context-based Contact Lists across 9 Occasion Collections, and seeds every list with your 4 core WhatsApp numbers (919876500001, 919876500002, 919876500003, 919876500004).
Step 1 — Register Workspace in Clean Light Theme
Figure 1: Self-Service Workspace Registration modal in Clean Light theme.
Part 2

Starting a WhatsApp Gateway Session (Two Options)

Once redirected to the Control Plane (/app), you can start your WhatsApp pairing session either from the Dashboard Onboarding Banner (Option A) or from the WhatsApp Sessions tab (Option B).

⚡ Option A: 1-Click Dashboard Banner (Fastest)

  1. On the Dashboard, locate the 📲 Activate Your Workspace — Link WhatsApp card at the top.
  2. Click ⚡ Link WhatsApp Device & Verify Mobile.
  3. WAM automatically creates your primary session, starts the socket, and opens the QR code scanner modal.

📱 Option B: Via "WhatsApp Sessions" Menu

  1. Click WhatsApp Sessions in the left sidebar.
  2. Click + New Session, enter a Session Display Name (e.g., Primary Broadcast Gateway), and click Create Session.
  3. Click ⚡ Start / Connect (or 📱 Scan QR) on the session card.
Step 2 — Dashboard Onboarding Banner in Clean Light Theme
Figure 2: Control Plane Dashboard in Clean Light theme showing the 1-Click "Activate Your Workspace — Link WhatsApp" banner.
Step 3 — WhatsApp Sessions View in Clean Light Theme
Figure 3: WhatsApp Connections & Sessions view in Clean Light theme showing the session card ready to Start / Connect.
Part 3

Scanning the QR Code from Your Mobile Phone

  1. Verify QR Modal is Open: When you click ⚡ Link WhatsApp Device & Verify Mobile or ⚡ Start / Connect, the Scan QR Code with WhatsApp modal opens.
  2. Open Linked Devices on Your Phone:
    • Android: Open WhatsApp → tap the three-dot menu (⋮) in the top-right → tap Linked devices.
    • iPhone (iOS): Open WhatsApp → tap Settings (⚙️) in the bottom-right → tap Linked Devices.
  3. Scan the QR Code: Tap Link a Device on your phone, unlock with biometric/PIN if prompted, and point your camera at the QR code on screen.
  4. Automatic Verification: The modal polls the gateway every 3 seconds. Once scanned, the badge turns green (✓ Device Connected Successfully!), your verified phone number badge (📱 +91... ✓ Verified) appears in the top bar, and the modal closes automatically.
💡 Tip — Refreshing Expired QR Codes: WhatsApp rotates QR codes periodically. If your QR code expires before you scan it, click the 🔄 Refresh QR button at the bottom-left of the modal to fetch a fresh code immediately.
Step 4 — Scan QR Code Modal in Clean Light Theme
Figure 4: The "Scan QR Code with WhatsApp" pairing modal in Clean Light theme with live 3-second gateway status polling.
Part 4

Browsing Your 86 Audience Lists & Shooting Multi-List Campaigns

  1. Browse by Occasion in Contact Lists: Click Contact Lists in the left sidebar to explore My WhatsApp Audience Library — Browse by Occasion (86 lists across Family Circus, Friends Zone, Business Hub, Events & Festivals, Community Connect, Quick Blast, Funny & Unusual, Education World, and Veterans Circle).
  2. Target Multiple Lists + Manual Numbers in Campaign Composer:
    • Click Campaign Composer in the left sidebar.
    • Filter lists by occasion pill or search box and check any combination of Target Contact Lists.
    • Optionally enter additional mobile numbers in the Manual Numbers box.
    • Keep 🛡️ Prevent duplicate messages across selected lists & manual numbers checked to guarantee each unique number receives only 1 message.
    • Click Dispatch Campaign to broadcast live and view real-time delivery status in the Execution & Telemetry Console.
Step 5 — Audience Library in Clean Light Theme
Figure 5: My WhatsApp Audience Library (86 Preset Lists across 9 Occasion Collections, 4 Contacts each) in Clean Light theme.
Step 6 — Multi-List Campaign Dispatch in Clean Light Theme
Figure 6: Shooting a live broadcast across multiple Contact Lists + Manual Numbers with automatic duplicate prevention in Clean Light theme.
Part 5

Quick Reference: Session States & Controls

Status Badge Description Available Controls
● Connected WhatsApp device is paired and active on WAMGW. Ready for live outbound campaigns. Stop, Restart, Logout, Delete
QR Required Session socket is open and waiting for you to scan the QR code from WhatsApp on your phone. 📱 Scan QR, Stop, Delete
Stopped Socket is paused, but saved authentication credentials remain intact for fast reconnection. ⚡ Start / Connect, Delete
Disconnected Socket connection dropped temporarily; click Reconnect to resume using stored credentials. ⚡ Reconnect, Logout, Delete
Logged Out Credentials were wiped or unpaired from the mobile device. Requires scanning a new QR code. ⚡ Pair Again, Delete
Part 6

Yearly Subscriptions & Direct Merchant UPI Payment

WAM provides a transparent subscription & credit model powered by Direct Merchant UPI QR / App Payment (0% PG Fee) to govern workspace resources and broadcast capabilities.

Annual Plan Subscription Fee WhatsApp Sessions Contact Capacity Voice Broadcasting
Free Tier ₹0 / year 1 Single Session 5 Lists (1,000 / list) Email & Voice Plans Sold Independently
Custom Enterprise Admin Configured Custom Sessions Defined / Unlimited Lists Custom Voice & Mail Allocations
Feature / Quota Unsubscribed (Free / Starter) Subscribed (Yearly Active Plan)
WhatsApp Sessions Strictly 1 single session Multi-session support (Up to 25 sessions)
Allowed Message Media Text and Images only All Formats: Text, Image, Video, Audio, Documents (PDF)
Voice Broadcasting Not included Custom Credit Allocation (Admin Defined)
Audience Contact Lists Capped at 5 Lists Defined / Unlimited Lists
Contacts per List Capped at 1,000 Contacts per list Defined / Unlimited Contacts (up to 50,000+)
WhatsApp Group Sync Restricted / Locked Full Background & On-Demand Sync
Group Members Export Disabled Enabled (subject to admin authorization)
📱 Direct Merchant UPI Checkout: Navigate to Billing & Subscriptions → Click Pay via UPI on Wallet Top-Ups or Admin-assigned workspace subscriptions. Scan the dynamic UPI QR or open Google Pay / PhonePe / Paytm / BHIM, complete payment, and submit your 12-digit UTR / Reference Number for System Admin 1-click verification & activation.
⚠️ Subscription Disclaimer (Section 6): All subscription charges collected are strictly for access to our proprietary software platform, contact management facilities, data organisation, and technical infrastructure. Such charges are not payments for guaranteed WhatsApp messaging, message delivery, or third-party service availability. Third-party restrictions by WhatsApp do not constitute a software failure or entitle the subscriber to an automatic refund.
🛡️
System Administration & Platform Controls Hidden

Platform-level configuration (Dynamic SMTP parameters, group privacy architecture, and operator CLI tools) is restricted to System Administrators and hidden in this Standard User view. If you are an authorized administrator, switch to Administrator View →

Part 7

Multi-Channel Suite: Bulk Email (WAM Mail) & Voice Broadcasting (WAM Voice) — Coming Soon

Alongside WhatsApp Campaigns, WAM includes standalone Bulk Email (WAM Mail) and Voice Broadcasting (WAM Voice) modules powered by the Common WAM System Wallet — currently marked 🕒 Coming Soon on the Landing Page and Control Plane.

  1. WAM Mail — Bulk Email Broadcasting Suite (Coming Soon): Supports HTML templates, metered email address verification, spam scrubbing, BYO SMTP or provisioned senders, and quantity-based Bulk Email packs.
  2. WAM Voice — Voice Broadcasting & External Dialler (Coming Soon): Supports audio prompt uploads, quantity voice credit packs, webhook/SIP external dialler integration, and real-time call outcome analytics.
  3. Unified Campaign Scheduling: WhatsApp, Email, and Voice campaign composers all support immediate execution or Schedule for Later date/time queueing with 1-click cancellation before dispatch.
🕒 Availability Note: Email Broadcasting and Voice Broadcasting purchase CTAs in the Control Plane show Coming Soon while live WhatsApp Campaign plans, Contact Lists (up to 1,000 contacts/list on Free Tier), and Direct UPI checkout are active.
Part 8

Creator & Services Marketplace: Showcase, Wallet Checkout & ₹1,000+ Payouts

Any registered workspace can showcase Images, Videos, and Professional Services in the Marketplace. Buyers pay using their Common WAM System Wallet with escrow protection, while sellers earn directly in cleared seller balances withdrawable from ₹1,000.00+.

  1. Browse Public & Control Plane Showcase: Guests can preview approved products & services at https://wamithra.com/#marketplace with Login to Buy / Register to Buy; signed-in users open Marketplace Showcase in the left sidebar.
  2. Commission Split & Escrow Protection: Digital Products (image, video) carry a 25% platform fee (75% net to seller; instant private download for buyers + 48h clearing window). Services carry a 10% platform fee (90% net to seller; held safely in escrow until delivery confirmation or auto-release).
  3. Submit Listings for Approval: In Seller Studio & Sales, upload a public showcase preview and private paid deliverable file (for digital products), attest commercial rights, and submit — all new listings enter Pending Admin Approval before going live.
  4. Organization Bank / UPI Payouts (₹1,000+ Minimum): Organization Owners can configure Bank NEFT/IMPS or UPI VPA payout details under Seller Payouts. Once cleared withdrawable seller earnings reach ₹1,000.00+, submit a payout request for Super Admin approval & transfer.
🛡️ Financial Safety Separation: Top-up wallet credits (balance_inr) are strictly spendable on platform subscriptions and Marketplace purchases and cannot be cashed out; only cleared seller sales earnings (seller_available_inr ≥ ₹1,000) qualify for organization payout requests.
Part 9

Super Admin: Marketplace Moderation, Payouts, Merchant UPI & SMTP

🛡️ Administrator Only

System Administrators pre-approve seller Marketplace listings, resolve buyer/seller escrow disputes, approve ₹1,000+ seller payout requests, manage Merchant UPI settings, and configure outgoing SMTP.

  1. Access SMTP Settings: Sign in as a System Admin → Navigate to System Settings → SMTP Configuration (/admin).
  2. Configure Mail Parameters:
    • SMTP Host: Enter your mail server hostname (e.g., mail.gknit.co.in or intranet IP 10.10.10.35).
    • SMTP Port: 587 (Submission / STARTTLS) or 465 (SMTPS) or 25 (SMTP).
    • Encryption: Select TLS (recommended), SSL, or None.
    • Credentials: Enter your mailbox Username (e.g. info@gknit.co.in) and Password.
    • From Header: Configure the Sender Email (e.g., info@gknit.co.in) and Sender Name (e.g., GK NIT WAM Platform).
  3. Marketplace Moderation, Disputes & Payout Approvals: Open Marketplace Showcase → 🛡️ Admin Moderation & Payouts to ✓ Approve / Reject / Suspend submitted products & services, resolve disputed escrow orders (Release Seller or Refund Buyer), and settle verified seller payout requests above ₹1,000 by recording the Bank/UPI UTR reference.
  4. Merchant UPI Receiver & 1-Click UTR Approval Queue: In Subscription & Billing or Settings, enter your Merchant UPI ID (VPA) and Payee Name. Incoming user UTR submissions appear in UPI Payment & UTR Approval Queue for 1-click ✓ Approve or ✗ Reject.
  5. AES-256 Security at Rest: All credentials are encrypted using AES-256 in the system_settings database table. Plaintext passwords are never exposed.
  6. Live Connection & Test Email Dispatch: Enter a recipient address in the Test SMTP Connection form and click Send Test Email. The platform performs live socket testing, STARTTLS handshake, ESMTP auth, and dispatches a verified test email.
🛡️ Built-in Intranet DNS Fallback: If the local OS DNS resolver encounters an intranet split-horizon issue resolving mail.gknit.co.in, WAM automatically resolves to the local mail server (10.10.10.35:587) with SSL peer name handling, ensuring mail dispatches never fail due to local DNS lookup errors.
Part 10

WhatsApp Group Members Synchronization & Privacy Visibility

🛡️ Administrator Only

WAM automatically synchronizes group participants from paired WhatsApp sessions into actionable audience contact lists while enforcing rigorous privacy guardrails.

  1. Automated Background Sync: Whenever a WhatsApp session connects, WAM dispatches a background job (SyncWhatsappSessionGroupsJob) to fetch group participants quietly without disrupting live campaigns.
  2. Operator Manual Sync: Administrators can trigger a manual sync anytime via the CLI:
    php artisan wam:sync-groups
  3. Hidden Lists for Privacy: Synchronized group contacts are flagged as is_hidden = true. Self-registered workspace owners and members cannot browse or export member phone numbers without explicit administrative authorization.
  4. Session-Scoped Access Grants: System Admins can grant fine-grained permissions to specific operators for designated sessions via the Admin Control Panel.