What Is Whoxa CRM?
Whoxa CRM is a multi-tenant SaaS platform that enables businesses to manage customer communication through WhatsApp Business API. It combines a real-time chat inbox, automation flow builder, template management, contact management, analytics, and agent collaboration — all in a single dashboard.
Architecture
The platform has three layers: Meta / WhatsApp (Cloud API, Webhooks, OAuth) → Whoxa Backend API (Node.js, REST, Socket.IO, PostgreSQL, Redis, Stripe/Razorpay) → Three React frontends (Business Web App, Agent Web App, Super Admin Panel).
Key Architectural Principles
| Principle | Implementation |
|---|
| Multi-tenancy | Each business user owns isolated data (WABA, conversations, agents, templates) |
| Real-time | Socket.IO for live message delivery and agent presence |
| Subscription-gated | Feature limits enforced per plan at middleware level |
| API-first | All UI operations go through versioned REST API |
| Webhook-driven | Meta pushes all inbound events; platform processes and routes them |
Main Modules
| Module | Description |
|---|
| Chat Inbox | Unified inbox for all WhatsApp conversations with real-time updates |
| WABA Connection | Connect WhatsApp Business Account via Embedded Signup or manual setup |
| Automation Flow Builder | Visual node-based chatbot/flow builder with triggers, conditions, and actions |
| Template Management | Create, submit, and manage WhatsApp message templates |
| Agent Management | Invite agents, assign conversations, track activity |
| Contact Management | Store, tag, and segment customer contacts |
| Meta Catalog | Sync and manage product catalogs for WhatsApp commerce |
| Analytics | Conversation stats, agent performance, template metrics |
| Subscription & Billing | Plan management with Stripe and Razorpay payment gateways |
| API Access | Developer API keys for external integrations |
| Webhook Integration | Outbound webhooks for e-commerce and third-party systems |
| AI Config | Configure AI model integrations for automated replies |
| Chat Widget | Embeddable web chat widget for websites |
| Default Messages | Configure welcome, out-of-hours, and delayed reply messages |
User Roles
| Role | Access Level | Description |
|---|
| Super Admin | Platform-wide | Manages all tenants, plans, payment gateways, AI models, languages |
| Business | Tenant owner | Full access to their own account — WABA, agents, templates, billing |
| Agent | Limited tenant | Chat inbox, assigned conversations, contact view — no admin settings |
Technology Stack
| Layer | Technology |
|---|
| Frontend | React 18, TypeScript, Vite, React Query, Zustand/Context |
| Backend | Node.js, Express.js, Sequelize ORM |
| Database | PostgreSQL |
| Real-time | Socket.IO + Redis (presence tracking) |
| Payments | Stripe, Razorpay |
| WhatsApp | Meta Cloud API (WhatsApp Business Platform) |
| Authentication | JWT (access token + refresh token) |
| File Storage | Local/cloud media uploads |