clever-whatsapp

byMeghna Rajawat

WhatsApp-Based AI-Governed Investment & Financial Distribution Platform (Mutual Funds | Broking | Lending | Insurance | Payments) 1. System Overview The proposed system is a WhatsApp-first, AI-governed financial orchestration platform designed to enable distribution and execution of multiple financial products through a secure conversational interface. The platform integrates: Mutual Fund Transaction Rails (NSE NMF II, BSE StAR MF) Broking APIs (Angel One SmartAPI and future integrations) Lending Infrastructure (FinBox, Decentro) Insurance APIs (Digit, Acko) KYC & Identity APIs (Aadhaar eKYC, CIBIL, Account Aggregator, CKYC) Payment & Mandate Infrastructure (UPI, Razorpay, NACH) WhatsApp Business API as the primary customer interaction layer At the core of the system is an AI-driven orchestration engine that governs intent recognition, workflow routing, escalation management, and compliance-safe interaction handling. The system is modular, phase-driven, compliant-ready, and designed for long-term scalability. 2. Architectural Model The system will follow a layered, modular architecture: WhatsApp Interaction Layer AI & Conversation Intelligence Layer Workflow Orchestration Layer Financial Domain Modules Integration Adapter Layer Data & Infrastructure Layer Admin & Operations Control Layer All third-party providers will be connected through adapter abstractions to ensure: Provider isolation Flexibility for future migration Rail redundancy Failover capability The AI layer will operate independently from execution rails, ensuring separation between decision logic and transaction execution. 3. AI & Intelligence Layer Architecture The AI layer acts as the decision-making engine of the platform. It governs: Intent classification Entity extraction Multi-turn conversation management Workflow routing Escalation detection Guardrail enforcement Continuous enrichment The AI system will never directly execute financial transactions. All executions pass through backend validation and integration layers. 3.1 Intent Classification Engine The AI will detect and classify user intents across domains: Investment (SIP, Lump sum, Redemption, Portfolio) Broking (Order placement, Portfolio view) Lending (Loan application, Eligibility check) Insurance (Quote request, Policy issuance) Informational queries Escalation requests Outputs will be structured and confidence-scored to ensure deterministic routing. 3.2 Entity Extraction & Structured Output The AI will extract required financial parameters such as: Investment amount Scheme name Tenure Loan type Risk preference Policy type All extracted data will undergo validation before workflow execution. 3.3 Conversation State Management The system will support: Multi-turn dialogue Reference resolution Partial workflow continuation Session-based memory tracking This enables natural, uninterrupted WhatsApp-based financial journeys. 3.4 Workflow Orchestration Engine The AI determines: Required pre-checks (KYC, Mandate, Eligibility) Correct domain module activation Appropriate API invocation Error handling and fallback responses Execution remains backend-controlled to ensure transaction safety. 3.5 Guardrails & Compliance Controls Given the regulated financial domain, strict safeguards will be implemented: Tool-first data sourcing (no hallucinated financial data) Deterministic transaction confirmations Structured response formatting No speculative financial advice Ambiguity detection with clarification prompts All AI decisions will be auditable. 3.6 Human Escalation Intelligence Escalation triggers include: Explicit RM request Sentiment-based distress detection Repeated workflow failure High-value transaction flags The AI pauses automation and routes the interaction to the assigned Relationship Manager. 3.7 Continuous Enrichment Framework The AI system will support long-term expansion via: Modular intent registry Config-driven workflow templates Version-controlled prompt management Analytics-based refinement cycles Domain expansion without architectural rebuild 4. Phase-Wise Implementation Scope Phase 1 – Revenue Foundation Objective Establish the AI-governed core execution backbone for mutual funds and broking via WhatsApp. 4.1 WhatsApp Orchestration Layer Webhook ingestion Intent routing Conversation state management Escalation to human interaction 4.2 User Onboarding & Identity Aadhaar eKYC integration KYC status tracking User lifecycle management Identity state validation 4.3 Mutual Fund Execution (Primary Rail: NSE NMF II) Scheme discovery SIP creation Lumpsum execution Redemption handling Order status synchronization Reconciliation framework 4.4 Broking Integration (Angel One SmartAPI) Portfolio retrieval Order execution Token lifecycle management Status synchronization 4.5 Payment & Mandate Infrastructure Razorpay integration UPI mandate setup Webhook verification Transaction-payment reconciliation 4.6 Relationship Manager (RM) Escalation Layer RM-client mapping Ticketing framework Escalation matrix Callback scheduling Manual override capability 4.7 Admin & Operations Dashboard – Phase 1 Includes: User management KYC monitoring MF transaction logs Broking activity logs RM assignment management Immutable audit logs Operational override tools Phase 1 Outcome Live-ready AI-governed mutual fund and broking distribution system with operational oversight. Phase 2 – Risk & Lending Expansion Objective Introduce credit intelligence, lending orchestration, and insurance distribution. 5.1 Account Aggregator Integration Consent lifecycle management Financial data pull orchestration Consent artifact storage 5.2 Credit Bureau Integration (CIBIL) Credit score retrieval Bureau normalization Pull logging & audit tracking 5.3 Lending Infrastructure (FinBox) Loan application orchestration Offer tracking Document handling Status synchronization 5.4 Insurance Distribution (Digit / Acko) Quote generation Policy issuance Renewal tracking Document delivery 5.5 Admin Dashboard – Phase 2 Enhancements Bureau pull logs Consent tracking panel Loan monitoring Insurance issuance dashboard Risk analytics Phase 2 Outcome Multi-product AI-enabled financial distribution engine with credit and insurance capabilities. Phase 3 – Redundancy & Ecosystem Scaling Objective Increase resilience and diversify rails. 6.1 Multi-Rail Mutual Fund Infrastructure BSE StAR MF integration Rail abstraction Automated failover logic 6.2 Thematic Investments (Smallcase) Basket discovery Rebalancing orchestration 6.3 Credit Marketplace Integration (Paisabazaar) Pre-qualification engine Offer comparison 6.4 Dual Bureau Strategy (Experian) Secondary bureau integration Comparative analytics Phase 3 Outcome Resilient, diversified ecosystem-ready financial orchestration platform. Phase 4 – Embedded Finance Expansion Objective Transition into enterprise-grade embedded finance infrastructure. Includes: Co-lending (M2P) NACH mandate management DigiLocker integration CKYC registry integration Payment gateway redundancy Compliance reporting exports Phase 4 Outcome Fully embedded, AI-governed financial infrastructure platform. 5. Cross-Phase System Characteristics Across all phases, the platform will maintain: Adapter-based third-party integration State-driven workflow management Idempotent financial transaction handling Field-level encryption Immutable audit logging Centralized observability Modular domain isolation Progressive Admin Dashboard evolution AI decision trace logging Compliance-safe automation 6. Monitoring & Evaluation Framework The system will track: Intent accuracy Workflow success rate Escalation frequency API failure rates Transaction reconciliation accuracy AI latency Operational exception metrics Continuous optimization cycles will be implemented. 7. Final System Positioning Upon full implementation, the platform will function as: A WhatsApp-native financial execution environment An AI-governed financial orchestration backbone A consent-driven risk and credit engine A multi-rail resilient transaction system An embedded finance distribution infrastructure A centralized, audit-controlled financial operations platform

LoginUsersEscalationsKYC MonitorClient ProfileOnboardingDashboardRM ManagementPaymentsWhatsAppMutual FundsTransactionsLendingInsuranceScheduleBroking
Login

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirement Document

System Requirements Document (SRD)

Project Name: clever-whatsapp


1. Introduction

Welcome to the System Requirements Document for clever-whatsapp, a WhatsApp-based AI-governed investment and financial distribution platform. This document outlines the system's architecture, functional and non-functional requirements, user personas, visual design concepts, and technical specifications.

The platform is designed to revolutionize financial services in India, leveraging WhatsApp's widespread adoption and AI-driven orchestration to deliver mutual funds, broking, lending, insurance, and payment solutions seamlessly. Meghna Rajawat, based in India, envisions this platform as a secure, scalable, and compliant solution tailored to the Indian financial landscape.


2. System Overview

clever-whatsapp is a WhatsApp-first financial orchestration platform governed by AI. It enables secure distribution and execution of financial products through conversational interfaces.

Key integrations include:

  • Mutual Funds: NSE NMF II, BSE StAR MF
  • Broking APIs: Angel One SmartAPI
  • Lending Infrastructure: FinBox, Decentro
  • Insurance APIs: Digit, Acko
  • KYC & Identity APIs: Aadhaar eKYC, CIBIL, Account Aggregator, CKYC
  • Payment Infrastructure: UPI, Razorpay, NACH

At its core, the platform features an AI-driven orchestration engine for intent recognition, workflow routing, escalation management, and compliance-safe interaction handling. It is modular, phase-driven, and designed for long-term scalability.


3. Functional Requirements

As story points:

  • As a User, I should be able to onboard using Aadhaar eKYC.
  • As a User, I should be able to invest in mutual funds via SIP or lump sum.
  • As a User, I should be able to redeem mutual fund investments.
  • As a User, I should be able to view and manage my broking portfolio.
  • As a User, I should be able to apply for loans and check eligibility.
  • As a User, I should be able to request insurance quotes and issue policies.
  • As a User, I should be able to make payments via UPI and Razorpay.
  • As an Admin, I should be able to monitor KYC status and transaction logs.
  • As an Admin, I should be able to manage Relationship Manager (RM) assignments.
  • As an Admin, I should be able to override workflows manually when needed.
  • As a User, I should be able to selectively re-run and regenerate the System Requirements Document (SRD).

4. User Personas

1. User

  • Primary customer interacting via WhatsApp.
  • Needs seamless access to financial products and services.
  • Expects secure, compliant, and user-friendly workflows.

2. Admin

  • Responsible for monitoring system operations.
  • Manages KYC, transaction logs, and RM assignments.
  • Ensures compliance and handles escalations.

3. Relationship Manager (RM)

  • Provides personalized assistance to users.
  • Handles escalations flagged by the AI engine.
  • Manages high-value transactions and distressed users.

5. Visuals Colors and Theme

The visual theme for clever-whatsapp will focus on a clean and professional aesthetic, emphasizing trust and clarity. Based on Meghna's request, the updated color palette is:

  • Primary Colors:

    • White (#FFFFFF) for clarity, simplicity, and a clean interface.
  • Secondary Colors:

    • Light Gray (#F5F5F5) for subtle accents and neutral tones.
    • Black (#000000) for text and contrast.

The WhatsApp interface will retain its familiar green accents for user comfort and recognition, while integrating the white and gray palette for a cohesive experience. Blue has been completely removed from the design as per Meghna's preference.


6. Signature Design Concept

Interactive Financial Canvas Homepage

The homepage will resemble a dynamic financial canvas, symbolizing simplicity, clarity, and interconnectedness. The design will feature interactive animations that evolve as users navigate the platform.

  • Animations: Sections of the canvas (representing mutual funds, broking, lending, insurance, payments) will "paint themselves" in real-time as users scroll or interact.
  • Transitions: Smooth transitions between sections, with canvas strokes morphing into detailed charts, graphs, and product information.
  • Micro-Interactions: Hovering over a section highlights it with subtle glowing gray accents, while clicking opens a detailed view with actionable buttons (e.g., "Invest Now," "Apply for Loan").
  • Color Shifts: The background remains predominantly white, with light gray accents dynamically highlighting active sections.

This concept creates an unforgettable first impression, blending innovation with functionality while visually reinforcing the platform's theme of simplicity and trust.


7. Non-Functional Requirements

  • Scalability: Support millions of users concurrently.
  • Security: Implement field-level encryption and immutable audit logs.
  • Compliance: Adhere to Indian financial regulations (SEBI, IRDAI, RBI).
  • Performance: Ensure low latency for AI responses and transaction processing.
  • Reliability: Guarantee failover capabilities and rail redundancy.

8. Tech Stack

Frontend:

  • React for Web
  • React Native for Mobile App

Backend:

  • Python
  • FastAPI

Database:

  • MySQL or MariaDB (with Alembic for migrations)

AI Models:

  • GPT 5.2 for user-friendly responses
  • Claude 4.5 Opas for academic or coding work
  • Gemini 3 Pro for friendly responses
  • Google Nano Banana for image generation

AI Tools:

  • Litellm for LLM Routing
  • Langchain

Local Orchestration:

  • Docker
  • Docker-compose

Server-Side Orchestration:

  • Kubernetes

9. Assumptions and Constraints

  • Assumptions:

    • Users are familiar with WhatsApp and basic financial concepts.
    • Aadhaar eKYC is widely adopted in India.
    • UPI is the preferred payment method for most users.
  • Constraints:

    • Compliance with Indian financial regulations is mandatory.
    • WhatsApp Business API limits certain functionalities.
    • AI decisions must be auditable and deterministic.

10. Glossary

  • AI: Artificial Intelligence
  • KYC: Know Your Customer
  • RM: Relationship Manager
  • UPI: Unified Payments Interface
  • NACH: National Automated Clearing House
  • SEBI: Securities and Exchange Board of India
  • IRDAI: Insurance Regulatory and Development Authority of India
  • RBI: Reserve Bank of India

This document provides a comprehensive overview of the clever-whatsapp platform, ensuring clarity and alignment for all stakeholders. Meghna, your vision is inspiring, and this SRD is tailored to bring it to life! 🚀

Login: Sign In
Dashboard: View Overview
KYC Monitor: Review Status
Transactions: View Logs
RM Management: Assign RMs
Transactions: Override Workflow
Users: Manage Profiles