Real-Time Notification System
ComTM includes a fully functional, real-time notification engine that keeps sellers updated on every aspect of their store operations—from new checkout orders to low stock alerts and billing warnings.
The Real-Time Notification System is available to all sellers on Starter (Free), Growth, and Scale plans. Real-time alerts keep sellers informed on orders, stock levels, and system events.
Notification Categories & Types
Notifications are classified into four main categories. Users can configure toggles for each category in their settings.
| Category | Event Type (type) | Description | Default Trigger |
|---|---|---|---|
| Orders | order_placed | New customer order received | Customer checkout checkout-client |
order_status_changed | Order status changes (e.g., Pending → Confirmed) | Vendor updates status in Admin orders | |
payment_received | Successful Cashfree payment | Successful checkout payment | |
| Alerts | low_stock | Product inventory level drops below threshold | Stock decrement during checkout |
| Billing | plan_expiry_warning | Warning that subscription will expire soon | Daily cron/billing check |
plan_expired | Subscription expired, features limited | Grace period expiry | |
plan_upgraded | Success upgrade to Growth/Scale | Payment captured webhook | |
plan_downgraded | Plan changed to a lower tier | Subscription cancellation | |
| System | system_update | Platform-wide announcements or maintenance | Dispatch by system administrator |
Interactive Features
1. The Notification Center
Located at /admin/notifications, the Notification Center is the central dashboard for checking alerts.
- Category Tabs: Dynamically filter alerts by All, Orders, Alerts, Billing, and System.
- Mark as Read: Clicking any notification card marks it read, immediately updating the top navbar indicator badge.
- Quick Action Shortcuts:
- Orders: "View Orders" button redirects directly to fulfillment dashboard.
- Alerts: "Manage Inventory" button redirects to product catalog.
- Billing: "Manage Plan" redirects to billing settings.
- Soft Deletion: Hovering over any item displays a trash icon to remove it from your history.
2. Live Bell Dropdown
The top navbar houses the real-time Notification Bell.
- Realtime Badge: Shows a subtle indicator when new unread notifications arrive.
- Quick Preview: Shows the 5 most recent notifications.
- Real-time Updates: New alerts appear instantly without requiring a page refresh.
3. Preferences Control Panel
Accessible at /admin/settings/notifications, sellers can customize how and when they get notified.
- Channel Toggles: Turn on/off categories (Orders, Inventory Alerts, Plan Updates, System Updates).
- Custom Thresholds: Configure the exact stock level (default:
5) that triggers a low-stock alert.