Skip to main content

Core Modules & Workflows

Nexus is organized into interconnected modules. Each module owns a set of database tables, Edge Functions, and UI pages.

Module map​

┌─────────────────────────────────────────────────────────────┐
│                       NEXUS MODULES                         │
├────────────┬────────────┬────────────┬─────────────────────┤
│  Inbox     │  CRM       │  Orders    │  Fulfillment        │
│  (Messages)│  (Contacts)│  (Sales)   │  (Pick/Pack/Ship)   │
├────────────┼────────────┼────────────┼─────────────────────┤
│  Inventory │  Shipping  │  VoIP/PBX  │  AI Analytics       │
│  (Stock)   │  (AWBs)    │  (Calls)   │  (CS Insights)      │
├────────────┼────────────┼────────────┼─────────────────────┤
│  Automation│  Integr.   │  Platform  │  Competition Intel  │
│  (Workflows)│ (Ext. APIs)│ (Admin)   │  (Market Analysis)  │
└────────────┴────────────┴────────────┴─────────────────────┘

Module details​

Omnichannel Inbox​

Unified messaging across WhatsApp, Facebook Messenger, Instagram DMs, and email. Conversations are threaded and linked to contact records. Supports canned responses, media attachments, read receipts, and real-time updates.

CRM​

Contact and company management with lifecycle stages, labels, segmentation, touchpoint tracking, and customer-360 views. Includes campaign tools, product targeting, and buyer recommendation powered by AI embeddings.

Order Management​

Create, import (Shopify sync), edit, and track orders through their lifecycle: pending → confirmed → processing → shipped → delivered. Supports line items, discounts, notes, and customer linking.

Fulfillment​

Pick-list generation, picker assignment, item scanning, pack confirmation, and handoff to shipping. Mobile-responsive interface for warehouse staff.

Inventory & Warehousing​

Track inventory items across multiple warehouses and bin locations. Record stock movements (inbound, outbound, adjustment, transfer). Run cycle counts. Manage suppliers and purchase orders.

Shipping​

Create AWBs (airway bills) via courier APIs (Bosta, etc.), print labels, and track shipment status in real time via tracking webhooks.

VoIP / PBX​

Click-to-call from contact records, real-time call monitoring, CDR (call detail record) synchronization, and call analytics. Integrated with Issabel PBX via n8n webhooks.

AI Customer-Service Analytics​

Automatic conversation annotation, sentiment analysis, topic tagging, risk flags, and CS-agent performance dashboards. Powered by LLM-based AI workers (Edge Functions).

Automation​

Event-driven workflows: abandoned-cart recovery, stale-session cleanup, scheduled CRM tasks, and integration-triggered actions. Orchestrated via n8n and Supabase Edge Functions.

Integrations​

Native connectors for WhatsApp Business API, Meta Graph API (Facebook/Instagram), Shopify Admin API, courier APIs, Issabel PBX, Odoo, TikTok, and n8n.

Platform Admin​

Multi-tenant administration: organization management, user provisioning, audit logging, role-based access control.

Competition Intelligence​

Market analysis and competitor tracking with automated search, analysis, and reporting.

Typical end-to-end workflows​

Workflow 1: Customer inquiry → Order → Delivery​

  1. Customer sends a WhatsApp message asking about a product.
  2. Agent replies via the omnichannel inbox; conversation is auto-linked to the contact.
  3. Agent creates an order from the conversation view.
  4. Warehouse receives a pick list, picks and packs items.
  5. Shipping AWB is created via courier API; tracking link sent to customer via WhatsApp.
  6. Delivery confirmed via tracking webhook; order status updated automatically.

Workflow 2: Shopify order sync → Fulfillment​

  1. Customer places an order on a Shopify store.
  2. shopify-webhook Edge Function receives the order and syncs it into Nexus.
  3. Order appears in the Orders module; inventory is reserved.
  4. Fulfillment pick list is generated; warehouse staff picks and packs.
  5. AWB is created; Shopify fulfillment status is updated via shopify-fulfill.

Workflow 3: Abandoned cart recovery​

  1. abandoned-carts-scan-send runs on a schedule, identifying carts not converted within a threshold.
  2. WhatsApp template message is sent to the customer via whatsapp-send-template.
  3. If the customer responds, the conversation appears in the inbox for agent follow-up.