How ananth-madura/madhura_wa works
Whatsapp_CRM is a standalone WhatsApp customer-engagement service with an Express/Socket.IO backend and React frontend. Users log in, open the WhatsApp workspace, manage conversations or configure campaigns and flows, then the backend routes requests to session or Cloud API services and persists state in MySQL. Separate capabilities cover contacts, templates, automation, reminders, analytics, and AI. The graph emphasizes documented route mounting and indexed module references; several route and frontend implementations were not sampled, so their internal connections are omitted.
Main entry points: server.js Express API · waFlowEngine.js Conversation flows · waAutomationService.js Automation engine · whatsappService.js WhatsApp sessions
Components 29
Web client
- React application
frontend/src/App.js - Inbox workspace
frontend/src/pages/whatsapp.jsx - Feature pages
frontend/src/pages - Campaign wizard
frontend/src/components/WhatsAppCampaignWizard.jsx - Reminder controls
frontend/src/components/WhatsAppInteractiveReminders.jsx
API and sessions
- Express API
backend/server.js - Login and access
backend/routes/authRoutes.js - Token validation
backend/middleware/authMiddleware.js - WhatsApp routes
backend/routes/whatsappRoutes.js
Messaging engines
- WhatsApp sessions
backend/services/whatsappService.js - Cloud API
backend/services/whatsappCloudApi.js - Sender selection
backend/services/waLoadBalancer.js
Engagement features
- Campaign routes
backend/routes/waCampaignRoutes.js - Flow routes
backend/routes/waFlowRoutes.js - Automation routes
backend/routes/waAutomationRoutes.js - Reminder routes
backend/routes/waReminderRoutes.js - Other WA routes
backend/routes - Campaign engine
backend/services/waCampaignEngine.js - Conversation flows
backend/services/waFlowEngine.js - Automation engine
backend/services/waAutomationService.js - Bot gating
backend/services/waBotGate.js - Interactive menus
backend/services/waMenuHandler.js - Lead capture
backend/services/waLeadCapture.js - Confirmations
backend/services/waConfirmationService.js
Persistence and events
- MySQL database
backend/config/database.js - WA schema
backend/services/waDatabase.js - Live notifications
backend/sockets/notifications.js - CRM event bus
backend/services/crmEventBus.js
Other components
- WhatsApp user
Connections 36
- WhatsApp user → React application: uses
README.md - React application → Inbox workspace: routes to
frontend/src/App.js - React application → Feature pages: routes to
frontend/src/App.js - Inbox workspace → Express API: requests data
README.md - Campaign wizard → Campaign routes: configures
- Reminder controls → Reminder routes: configures
- Express API → Login and access: mounts
backend/server.js - Express API → WhatsApp routes: mounts
backend/server.js - Express API → Campaign routes: mounts
README.md - Express API → Flow routes: mounts
backend/server.js - Express API → Automation routes: mounts
backend/server.js - Express API → Reminder routes: mounts
README.md - Express API → Other WA routes: mounts
README.md - WhatsApp routes → Token validation: validates
backend/server.js - Login and access → MySQL database: reads users
backend/routes/authRoutes.js - Campaign routes → Campaign engine: starts campaigns
backend/routes/waCampaignRoutes.js - Campaign engine → Sender selection: selects sender
backend/services/waCampaignEngine.js - Sender selection → WhatsApp sessions: sends via session
backend/services/waLoadBalancer.js - Sender selection → Cloud API: sends via cloud
backend/services/waLoadBalancer.js - Flow routes → Conversation flows: triggers flow
backend/routes/waFlowRoutes.js - Automation routes → Automation engine: manages automations
backend/routes/waAutomationRoutes.js - WhatsApp sessions → Conversation flows: dispatches messages
backend/services/whatsappService.js - WhatsApp sessions → Automation engine: dispatches triggers
backend/services/whatsappService.js - Automation engine → Bot gating: checks gate
backend/services/waAutomationService.js - Automation engine → Sender selection: sends messages
backend/services/waAutomationService.js - Conversation flows → Bot gating: checks gate
backend/services/waFlowEngine.js - Conversation flows → Lead capture: captures leads
backend/services/waFlowEngine.js - Conversation flows → Interactive menus: uses menus
backend/services/waFlowEngine.js - Reminder routes → Confirmations: handles reminders
backend/routes/waReminderRoutes.js - Confirmations → Automation engine: triggers follow-ups
backend/services/waConfirmationService.js - WA schema → MySQL database: creates WA tables
backend/services/waDatabase.js - Campaign engine → MySQL database: records sends
backend/services/waCampaignEngine.js - Conversation flows → MySQL database: stores flow state
backend/services/waFlowEngine.js - WhatsApp sessions → Live notifications: emits updates
backend/services/whatsappService.js - Lead capture → CRM event bus: publishes leads
backend/services/waLeadCapture.js - Express API → CRM event bus: starts sweep
backend/server.js