OmniCart AI
1. Getting Started
Welcome to OmniCart AI — the intelligent e-commerce operations platform that combines multi-channel selling, AI-powered agents, visual workflow automation, and unified communications into a single dashboard. This manual covers every feature available to you as a tenant.
1.1 Sign Up & Onboarding
Creating your OmniCart account takes about 5 minutes. Every new account starts with a 14-day free trial of the Starter tier, giving you full access to explore the platform.
Step-by-Step Account Creation
- Visit the Sign-Up Page — Click "Start 14-Day Trial" on the landing page. You'll be directed to the sign-up form powered by Clerk authentication. Enter your email, set a password, or sign in with Google/GitHub.
- Organization Setup — Enter your business name and choose a URL slug (e.g.,
my-store). Select your industry and business model:- DropShipping — You sell products fulfilled by third-party suppliers
- Retail Inventory — You manage your own warehouse and stock
- Mixed — You use both models for different products
- Preferences — Set your timezone, default currency, and language.
- Connect a Platform (Optional) — Connect your first sales channel (Shopify, WooCommerce, Amazon, etc.) right away, or skip and do it later.
- Seed Demo Data (Optional) — Populate your account with sample products, orders, and workflows to explore features immediately.
1.2 Your First Dashboard Visit
After onboarding, you'll land on the main dashboard. A Welcome Banner guides you through recommended first steps:
- Add your first product
- Connect a sales channel
- Activate an AI agent
- Create your first workflow
- Invite a team member
Each step links directly to the relevant page. The banner disappears once you've completed the steps (or you can dismiss it).
1.3 Understanding Plans
OmniCart offers four subscription tiers. The "Read = Free, Write = Gated" philosophy means you can always see every feature — locked features display rich demo data. Write actions (create, edit, delete) on gated features show an upgrade prompt.
| Tier | Price | Best For |
|---|---|---|
| Free Trial | $0 / 14 days | Exploring the platform |
| Starter | $59/mo or $564/yr (Save 20%) | Growing businesses |
| Growth | $119/mo or $1,140/yr (Save 20%) | Expanding businesses |
| Professional | $249/mo or $2,388/yr (Save 20%) | Scaling operations |
| Enterprise | $599/mo or $5,748/yr (Save 20%) | Large teams & advanced automation |
| Enterprise+ | Custom (contact sales) | Bespoke deals & unlimited quotas |
See Chapter 14: Plan Comparison for the complete feature matrix.
2. Dashboard Overview
The dashboard is your command center. It provides a real-time overview of your entire e-commerce operation through information cards, quick actions, and live agent activity.
2.1 Dashboard Cards
Your main dashboard displays these information panels:
Business Overview
Revenue, orders, average order value, and conversion rates. Time-range selector (today, 7d, 30d, 90d). Trend indicators showing percentage change.
Agent Activity
Live feed of AI agent actions — pricing decisions, inventory alerts, supplier evaluations, listing optimizations. Shows agent name, action type, and timestamp.
Platform Performance
Per-channel revenue, order count, and health status for each connected platform (Shopify, Amazon, eBay, etc.).
AI Insights
Latest recommendations from your AI agents — pricing opportunities, inventory warnings, market trends, and optimization suggestions.
Automation Control
Active workflows and pipelines with execution counts. Quick toggles to pause/resume automations.
Current Operations
Recent orders table showing order ID, customer, channel, total, and status. Click any row to view full order details.
2.2 Navigation & Sidebar
The left sidebar organizes all features into logical groups:
| Group | Pages |
|---|---|
| Dashboard | Main overview page |
| Command Center | Agents (8 agent pages + listing), Workflows, Pipelines |
| Product Management | Products, Categories, Suppliers |
| Platforms | Amazon, Shopify, eBay, Social Commerce |
| Integrations | Portal, Activity, Health, Webhooks, API Keys, Custom Storefront |
| Communications | Hub, Inbox, Templates, Rules, Channels, Analytics |
| Settings | Team, Billing, Templates, Audit Logs, Notifications |
3. Product Management
The Product Management section is where you create, organize, and manage your entire product catalog. Products are the core entity that flows through every other system — agents analyze them, workflows process them, and integrations sync them to sales channels.
3.1 Adding, Editing & Deleting Products
Creating a Product
- Navigate to Product Management > Products
- Click the "Add Product" button
- Fill in the required fields:
- Name — Product title (shown on all channels)
- SKU — Unique stock-keeping unit identifier
- Price & Currency — Base selling price
- Business Model — DropShipping or Retail Inventory
- Status — Active, Draft, or Archived
- Select categories from your hierarchical category tree (up to 3 levels deep)
- Click Save — OmniCart automatically creates the companion record:
- DropShipping → Creates a
productDropshipInforecord (supplier, margins, lead time) - Retail Inventory → Creates a
productInventoryrecord (stock levels, warehouses)
- DropShipping → Creates a
The Product List
The product list page shows inventory health summary cards at the top (total, active, low stock, out of stock), followed by a searchable, filterable table with columns for image, name/SKU, category, price, inventory level, status, business model badge, and connected channel count.
Product Detail View
Click any product to open the full detail modal showing:
- Gallery — Image viewer with fullscreen lightbox and zoom
- AI Quality Score — Agent-computed score for listing quality
- Sales Metrics — Revenue, units sold, and channel breakdown charts
- Inventory Panel (Retail) — Stock levels per warehouse, reorder points
- Dropship Panel (DropShipping) — Supplier info, margins, price history
- Channel Tabs — Per-channel listing forms and status
3.2 Category Management
Starter+ Navigate to Product Management > Categories to manage your hierarchical category tree.
Categories support up to 3 levels of nesting (e.g., Electronics > Smartphones > Android). Each category has:
- Name & Slug — Display name and URL-friendly identifier
- Description — Optional category description
- Parent — Select a parent to nest under (or none for top-level)
- Sort Order — Controls display ordering within the same level
- Active/Inactive — Toggle visibility without deleting
Channel Category Mapping
The right panel maps your internal categories to marketplace taxonomy paths. For example, your "Smartphones" category might map to:
- Shopify →
Electronics > Cell Phones - Amazon →
Cell Phones & Accessories > Cell Phones - eBay →
Cell Phones, Smart Watches & Accessories
This ensures products are listed in the correct category on each marketplace.
3.3 Channel Listings
Each product can be listed on multiple sales channels simultaneously. The Channel Tabs in the product detail view show channel-specific listing forms:
| Channel | Key Fields |
|---|---|
| Amazon | ASIN, bullet points, search terms, fulfillment type (FBA/FBM) |
| Shopify | Tags, vendor, product type, SEO title/description |
| eBay | Item specifics, condition, listing format (auction/fixed), return policy |
| WooCommerce | Categories, tags, weight, dimensions, tax class |
| TikTok | Video URL, hashtags, product category, shipping template |
| Product tags, collection, shopping category | |
| Content category, availability, condition, brand |
3.4 Business Models
Your business model selection affects the entire operation pipeline:
DropShipping
- Products fulfilled by third-party suppliers
- Supplier manages inventory levels
- Orders route to supplier for fulfillment
- Inventory sync skips marketplace push (supplier-controlled)
- Compliance thresholds relaxed 50% (fulfillment timing is supplier-controlled)
Retail Inventory
- You manage your own warehouse stock
- Inventory levels tracked per warehouse
- Orders route to your warehouse
- Inventory syncs to all connected marketplaces
- Full compliance thresholds apply
If you selected Mixed during onboarding, each product is individually tagged. Orders containing both models are automatically split into separate fulfillment groups.
4. Order Management
Navigate to Product Management > Orders to view and manage all orders across every connected channel.
Order List
The order list displays: order ID, customer name/email, source channel, item count, total amount, fulfillment status, and date. Use filters for:
- Status — Pending, Processing, Shipped, Delivered, Cancelled, Refunded
- Channel — Filter by source marketplace
- Search — Find by order ID, customer name, or email
- Date Range — Filter orders by creation date
4.1 Order Lifecycle
When an order is created, the system automatically:
- Fires the
onOrderCreatedagent trigger - Determines the business model of each line item
- For Mixed orders: splits into DropShipping and Retail sub-groups
- Routes each sub-group to the appropriate fulfillment path
- Updates order stats (revenue, channel breakdown, fulfillment type segmentation)
4.2 Manual Orders & Export
Manual Order Creation
You can create manual orders for phone orders, custom requests, or testing. Click "Create Order" and fill in customer details, line items (with product selector), shipping method, and notes.
CSV Export
Export your orders as CSV for reporting or external systems. The export includes all order fields, line items, and customer information.
Order Statistics
The order stats system aggregates: total orders, status breakdown, channel breakdown, revenue totals, and byFulfillmentType segmentation (DropShipping vs RetailInventory totals). These stats feed into the Operations Controller agent and the dashboard Business Overview card.
5. Supplier Management
Navigate to Product Management > Suppliers to manage your supplier network. Suppliers are critical for DropShipping businesses and any tenant that sources products from external vendors.
Each supplier record includes:
- Contact Info — Name, email, phone, address
- Performance Score — AI-computed score based on fulfillment speed, quality, and reliability
- Active Products — Count of products linked to this supplier
- Lead Time — Average fulfillment time
- Last Activity — Most recent order or communication
5.1 Performance Tracking
Supplier performance is tracked across multiple dimensions:
- Fulfillment Speed — Average time from order placement to shipment
- Quality Rating — Based on return rates and customer feedback
- Reliability — Percentage of orders fulfilled without issues
- Stock Availability — How often products are in stock when ordered
- Communication — Responsiveness to inquiries and issues
5.2 Agent Integration
Supplier data feeds directly into the AI agent system:
- Supply Chain Commander — Uses performance scores to select optimal suppliers for order fulfillment, evaluates new suppliers, and flags underperformers
- Financial Strategist — Factors supplier costs into margin calculations and pricing recommendations
- Business Diplomat — Drafts supplier communications, negotiation strategies, and relationship management plans using BATNA/ZOPA analysis
6. AI Agent Team
OmniCart's AI agent team consists of 8 specialized agents that autonomously manage different aspects of your e-commerce operation. Each agent uses GPT-4o-mini to analyze data, make decisions, execute actions, and learn from outcomes.
6.1 The 8 Agent Cores
| Agent | Role | Min Plan |
|---|---|---|
| Market Scout | Discovers market opportunities, tracks trends, analyzes competitor pricing, scores product opportunities | Free |
| Channel Master | Optimizes listings across channels, ensures compliance, manages channel-specific content and pricing | Free |
| Supply Chain Commander | Manages suppliers, evaluates performance, handles procurement, routes orders to optimal fulfillment | Starter |
| Financial Strategist | Dynamic pricing, margin optimization, revenue attribution, arbitrage detection, A/B price testing | Starter |
| Operations Controller | Monitors fulfillment operations, tracks KPIs, manages returns processing, optimizes logistics | Starter |
| Business Diplomat | Drafts supplier/customer communications, negotiation strategy (BATNA/ZOPA analysis), relationship management | Professional |
| Chief Strategist | High-level business intelligence, model-segmented briefings, cross-agent coordination, strategic planning | Professional |
| Maestro | Orchestrator — coordinates all agents, provides a conversational interface (text/voice), generates visual dashboards. See Chapter 7 | Professional |
Agent Detail Pages
Each agent has its own detail page at Command Center > Agents > [Agent Name] showing:
- Status — Online/Offline/Paused with toggle controls
- Activity Feed — Real-time log of agent decisions and actions
- Configuration — Agent-specific settings (thresholds, triggers, scheduling)
- Intelligence Section — Recent decisions, learning patterns, memory entries, bus messages
- Performance Metrics — Success rate, cost tracking, action counts
Agent Learning System
Starter+ Agents record every decision they make. A daily learning synthesis job extracts patterns (what worked, what didn't) and stores them as agent memories. These memories inform future decisions, making agents smarter over time. Learning is isolated by business model — DropShipping patterns don't contaminate Retail Inventory learning.
6.2 Autonomy Levels
Each plan tier unlocks a different maximum autonomy level, controlling how independently agents can act:
| Level | Behavior | Plan |
|---|---|---|
| Monitor | Agents observe and report only — no actions taken | Free |
| Suggest | Agents recommend actions that require your approval | Starter |
| Auto-Low | Low-risk actions execute automatically; high-risk actions require approval | Professional |
| Auto-Full | All actions execute automatically within spending/guardrail limits | Enterprise |
6.3 Capabilities & Tools
Agents have 33 capabilities that map to 43 executable tools. Capabilities are plan-gated: each capability requires a specific plan tier and is assigned to specific agent cores.
Capability Categories
| Category | Capabilities | Example Tools |
|---|---|---|
| Pricing & Revenue | Dynamic Pricing, Revenue Attribution, Arbitrage Detection, Bundle Discovery | adjustPrice, attributeRevenue, identifyArbitrage, discoverBundle |
| Listings & Compliance | Listing Optimization, Compliance & Appeals, Content Generation | suggestOptimization, pauseListing, generateListingContent |
| Supply Chain | Fulfillment Routing, Supplier Evaluation, Purchase Orders | routeOrder, evaluateNewSupplier, createPurchaseOrder |
| Intelligence | Demand Forecasting, Opportunity Scoring, Risk Detection, Seasonal Trends | runForecast, scoreOpportunity, detectSeasonalTrend |
| Experimentation | A/B Price Testing, A/B Listing Testing | startPriceExperiment, evaluateListingExperiment |
| Competitive | Competitor Monitoring, Price Defense, Trend Hunting | monitorCompetitor, defendPrice, huntTrend |
| Simulation Enterprise | Monte Carlo Forecasting, Digital Twin Scenarios, Launch Planning | runMonteCarloForecast, runDigitalTwinScenario, planLaunch |
| Communications | Autonomous Communications, Message Composition | composeMessage, reviewMessageDraft, composeFromTemplate |
7. Maestro Virtual Assistant
Professional+ Maestro is the orchestrator agent with a unique conversational interface. Unlike the other 7 agents that work autonomously in the background, Maestro provides a direct human-to-AI interaction layer. Access it at Command Center > Agents > Maestro > Live.
7.1 Text Chat & Voice
- Text Chat — Ask Maestro questions about your business, request analyses, or give instructions to delegate to other agents. Maestro understands natural language and can interpret complex multi-step requests
- Voice Mode Enterprise — Speak to Maestro using text-to-speech (TTS) and speech-to-text (STT) with wake word detection. The voice engine runs in-browser — no external API key required for basic browser TTS
7.2 Dynamic Canvas
Maestro generates interactive visual dashboards on-the-fly based on your conversation. Ask questions like "Show me this week's sales by channel" or "Compare supplier performance" and Maestro renders charts, tables, and KPI cards directly in the canvas area. The canvas uses a component registry system that maps Maestro's responses to live React components.
7.3 Multi-Agent Coordination
Maestro's primary power is orchestrating complex multi-agent workflows that involve several agents working together:
Evaluate Product
Market Scout (opportunity score) + Financial Strategist (margin analysis) + Channel Master (listing assessment) collaborate to give you a complete product evaluation.
Fulfill Order
Operations Controller (logistics planning) + Supply Chain Commander (supplier selection) coordinate to route orders through the optimal fulfillment path.
Handle Supplier Emergency
Supply Chain (find alternatives) + Financial (recalculate margins) + Operations (reroute orders) + Diplomat (draft customer communications) all coordinate simultaneously.
Agent Bus
Behind the scenes, agents communicate via the Agent Bus — a message routing system with 16 message types processed every 30 seconds. Maestro receives alerts from all agents and can delegate tasks in response.
7.4 Negotiation Engine (Business Diplomat)
The Business Diplomat features a 5-tier negotiation strategy engine, accessible through Maestro or directly on the Diplomat's detail page:
| Tier | Capability | Plan |
|---|---|---|
| Basic | Simple request drafting | Free |
| Standard | Data-backed proposals with market evidence | Starter |
| Advanced | Multi-round negotiation strategy | Professional |
| Strategic | Relationship intelligence & BATNA analysis | Professional |
| Game Theory | Nash equilibrium, payoff matrices, ZOPA visualization, optimal concession ladders | Enterprise |
8. Visual Workflow Builder
The Workflow Builder is OmniCart's visual automation engine. Build drag-and-drop workflows that automate any e-commerce process — from sending order confirmations to complex multi-step AI-driven operations.
Navigate to Command Center > Workflows to see all workflows with their status, step count, trigger type, and execution history.
8.1 Step Types
Workflows are composed of 8 step types that you drag onto the canvas and connect:
| Step Type | Purpose | Outputs |
|---|---|---|
| Trigger | Entry point — every workflow starts with one trigger | Event data passed to next steps |
| Action | Perform operations: query data, update records, send emails, call APIs, invoke agents | Action result data |
| Condition | Branch the flow with Yes/No paths based on field comparisons | Two outputs: true/false |
| Transform | Reshape data: map, filter, reduce, or custom JavaScript | Transformed data |
| Delay | Pause execution for seconds, minutes, hours, or days | Resumes after duration |
| Approval | Pause and notify team members; resumes when approved/rejected | Approval decision + notes |
| Loop | Iterate: forEach, while, or times. Safety cap on max iterations | Collected results array |
| Parallel | Fan out to multiple branches that run concurrently, then reconverge | Combined results from all branches |
Action Step Capabilities
The Action step can perform these built-in operations:
queryProducts/queryOrders— Retrieve data with filtersupdateProduct/updateInventory/updateOrder— Modify recordscreateOrder— Create a new ordersendNotification— Send email, Slack, or webhook notificationsendCorrespondence— Render a template and send via emailcallExternalApi— Make an HTTP request (SSRF-protected)agentAction— Invoke any AI agent with a specific capabilitylogMessage/setVariable— Logging and variable management
Variable System
Steps pass data between each other using {{variableName}} template syntax. Access previous step outputs with {{stepName.fieldName}}.
8.2 Trigger Types
| Trigger | Description | Plan |
|---|---|---|
| Manual | Click "Run" from the builder or workflow list | All |
| Event | Fires on system events: order.created, inventory.updated, product.changed | All |
| Webhook | Unique HTTP endpoint for external systems to POST to | Professional+ |
| Schedule | Cron expression (e.g., daily at 6 AM). Timezone-aware | Professional+ |
8.3 Execution & Monitoring
When a workflow runs, the builder shows a real-time execution overlay on each node: green checkmark for completed, spinning for running, red X for failed, clock for waiting. The execution system snapshots the workflow definition at trigger time, so edits during execution don't affect in-flight runs.
Error Handling
Each step has configurable error behavior:
- Fail — Stop the entire workflow
- Retry — Exponential backoff, up to 5 attempts
- Skip — Continue to the next step
- Fallback — Jump to a designated fallback step
Execution Logs
The Logs Panel shows every step's start time, duration, input data, output data, and any error messages. The History Sidebar lists all past executions with status filters (completed, failed, running).
Versioning
Each workflow has a version number. Publish versions to create snapshots you can compare and rollback to. The Version History Panel shows all published versions with diff comparison.
8.4 Workflow Templates
OmniCart ships 6 ready-made templates to get you started:
| Template | Difficulty | Steps |
|---|---|---|
| Low Stock Alert | Beginner | Trigger → Condition (stock < threshold) → Send Email |
| Order Confirmation Email | Beginner | Order Created → 1min Delay → Send Email |
| Daily Sales Summary | Beginner | 6PM Schedule → Query Stats → Format → Email |
| Smart Order Routing | Intermediate | Order Created → Extract Address → Condition → Route |
| Multi-Channel Inventory Sync | Intermediate | Webhook → Transform → Parallel Sync (Shopify/Amazon/eBay) |
| Competitive Price Monitoring | Advanced | Daily Schedule → Loop Products → Fetch Prices → Condition → Approval → Update |
9. Pipelines
Pipelines are pre-built operational workflows optimized for your two core business processes. Navigate to Command Center > Pipelines.
9.1 DropShipping Pipeline
The DropShipping pipeline automates the flow from receiving an order to routing it to the optimal supplier.
9.2 Retail Inventory Pipeline
The Retail Inventory pipeline manages warehouse stock levels and channel synchronization.
Each pipeline auto-generates a visual workflow that you can view and customize in the Workflow Builder. Click "View Workflow" on any pipeline detail page to open it.
10. Integration Engine
The Integration Engine connects OmniCart to your sales channels and external systems. Navigate to Integrations > Portal.
10.1 Connecting Platforms
OmniCart supports 7 sales channels:
| Platform | Type | Sync |
|---|---|---|
| Shopify | Storefront | Products, Orders, Inventory (7 webhook topics) |
| WooCommerce | Storefront | Products, Orders, Inventory (6 webhook topics) |
| Amazon | Marketplace | Products, Orders, Inventory |
| eBay | Marketplace | Products, Orders, Inventory |
| TikTok | Social Commerce | Products, Orders |
| Social Commerce | Products, Orders | |
| Social Commerce | Products, Orders |
Connection Wizard
- Click "Add Integration" and select a platform
- Enter your API credentials (API key, secret, store URL depending on platform)
- OmniCart tests the connection by calling the platform's API
- On success, the system auto-registers webhooks and sets sync to real-time
- Initial sync imports your existing products, orders, and inventory
products/update, orders/create) so changes push to OmniCart instantly. Polling is demoted to a 6-hour reconciliation fallback.
10.2 Sync Settings & Webhooks
Per-Connection Settings
Click the gear icon on any connected platform to configure:
- Sync toggles — Enable/disable Products, Orders, and Inventory sync independently
- Sync frequency — Real-time (webhooks), 5 min, 15 min, hourly, or daily
Outbound Webhooks Professional+
Navigate to Integrations > Webhooks to configure URLs that OmniCart POSTs to when events occur. Available events:
order.created,order.updated,order.fulfilledproduct.created,product.updatedinventory.low,inventory.updatedagent.decision,workflow.completed,sync.completed
All outbound webhooks are signed with HMAC-SHA256 and include exponential backoff retry (5 attempts).
Activity Log
Navigate to Integrations > Activity for a chronological event log of all sync activity: sync started/completed/failed, webhook received, connection established/lost, rate limited. Filter by platform, event type, and search. Export to CSV. Events retained 30 days.
10.3 API Keys Starter+
Navigate to Integrations > API Keys to manage REST API access. Generate API keys for external applications to access your OmniCart data.
- Keys use the
omnc_prefix and are shown only once at creation - Per-key permissions:
products:read,orders:read,inventory:write, etc. - Per-key rate limits and usage tracking
- Rotate or revoke keys instantly
10.4 Health Monitoring
Navigate to Integrations > Health to monitor connection status. Each platform shows health badges (Healthy/Degraded/Down), recent incidents derived from failure events, and a "Run Health Check" button that tests the live connection.
11. Communications Platform
The unified Communications Platform lets you send, receive, and automate messages across multiple channels from a single hub. Navigate to Communications in the sidebar.
11.1 Communications Hub & Unified Inbox
The Hub provides an overview of all communication activity: per-channel stats, recent threads, and a compose button. The Inbox shows all conversations across all channels in a single unified view with unread counts and thread management.
11.2 Channel Setup
Navigate to Communications > Channels to configure messaging providers:
| Channel | Provider | Required Plan |
|---|---|---|
| Resend | All Plans | |
| In-App Notifications | Built-in | Starter+ |
| WhatsApp Business API | Professional+ | |
| SMS | Twilio | Professional+ |
| WeChat Official API | Enterprise | |
| Voice | Twilio | Enterprise |
| Video | Daily.co | Enterprise |
Click "Setup" on any channel card to enter provider credentials (API key, account SID, etc.). A green checkmark appears once configured and verified.
11.3 Trigger Rules Starter+
Trigger Rules automate communications: "When X happens, send Y via Z". Navigate to Communications > Rules.
Creating a Trigger Rule
- Click "Create Rule"
- Select an event source: order, inventory, agent, supplier, pricing, or product
- Select the event type: e.g.,
order.created,inventory.low_stock - Add conditions (optional): field-level filters with operators (equals, contains, greater_than, etc.) combined with AND/OR logic
- Set a cooldown: e.g., max 1 notification per order per 24 hours
- Define the action: send a template, send in-app notification, AI compose, or webhook
- Set priority for rule ordering when multiple rules match the same event
11.4 Correspondence Templates
OmniCart ships 24 default templates across 7 categories: Supplier, Customer, Financial, Negotiation, Compliance, Legal, and Marketing. Navigate to Communications > Templates or Settings > Templates.
Templates use variable placeholders like {{customerName}}, {{orderTotal}}, {{companyName}} that get filled automatically when sent. The template editor at Settings > Templates > [Template] provides a full editing experience with live preview and test-send capability.
| Capability | Plan |
|---|---|
| View & send default templates | All |
| Customize existing templates | Professional+ |
| Create new custom templates (up to 50) | Professional+ |
| Unlimited templates, approval workflows, AI suggestions, multi-language | Enterprise |
11.5 Communication Analytics Professional+
Navigate to Communications > Analytics for per-channel breakdowns of: total sent, delivered, opened, clicked, failed messages. Delivery rate and open rate percentages. Historical trend charts.
12. Notification System
OmniCart's notification system keeps you informed of important events across your entire operation. Notifications appear via the bell icon in the dashboard header and through configured communication channels.
12.1 Notification Types
| Category | Examples | Default |
|---|---|---|
| Order Alerts | New order received, order fulfilled, order cancelled, payment failed | On |
| Inventory Alerts | Low stock warning, out-of-stock alert, reorder point reached | On |
| Agent Decisions | Price change executed, supplier switch recommended, listing optimized | On |
| System Notices | Sync completed, integration error, webhook failure, maintenance window | On |
| Team Events | Member joined, role changed, member removed | On |
| Approvals | Workflow approval requested, agent action awaiting approval | On |
| Communications | New message received, reply to thread, trigger rule executed | Off |
12.2 Notification Preferences
Navigate to Settings > Notifications to configure your preferences:
- Per-category toggles — Enable or disable each notification category independently
- Per-source filtering — Filter by source type (orders, inventory, agents, system, team, approvals, communications)
- Quiet hours — Set time windows when only critical alerts are delivered
- Read/unread management — Mark individual or bulk notifications as read from the bell dropdown
Each team member has their own notification preferences. Changes apply only to your account, not the entire organization.
13. Settings & Configuration
13.1 Team Management
Navigate to Settings > Team to manage your organization's members.
Roles & Permissions
| Role | Permissions |
|---|---|
| Owner | Full access: all features, billing, team management, settings, delete organization |
| Admin | Manage products, orders, workflows, agents, integrations, team members (except billing) |
| Member | Create/edit products & orders, run workflows, view reports |
| Viewer | Read-only access to all data |
Team Actions
- Invite — Send email invitations with a role assignment
- Change Role — Promote/demote team members
- Remove — Remove a member (with confirmation dialog)
- Leave — Members can leave the organization (owners cannot)
13.2 Billing & Subscription
Navigate to Settings > Billing to manage your subscription plan.
The billing page shows:
- Current Plan — Plan name, price, and trial countdown (if applicable)
- Usage Dashboard — Products, orders, workflows, executions, team members, AI actions used vs. limits
- Plan Comparison Cards — All 4 tiers with feature lists and upgrade/downgrade buttons
- Billing Toggle — Switch between monthly and annual (save 20%)
Upgrading takes you to Stripe Checkout. Managing your existing subscription opens the Stripe Customer Portal for invoice history, payment method changes, and cancellation.
13.3 Audit Logs Enterprise
Navigate to Settings > Audit Logs for a complete, immutable trail of all actions in your organization.
Every create, update, delete, and configuration change is logged with:
- Action type and timestamp
- User who performed the action (with avatar)
- Resource affected (product, order, workflow, team member, settings)
- Before/after diff of changed fields
Filter by action type, resource type, user, and date range. Export to CSV for compliance reporting.
14. Complete Plan Comparison
14.1 Limits & Quotas
| Resource | Free Trial | Starter | Professional | Enterprise |
|---|---|---|---|---|
| Products | 50 | 500 | 5,000 | Unlimited |
| Orders / month | 100 | 1,000 | 10,000 | Unlimited |
| Workflows | 3 | 10 | 50 | Unlimited |
| Workflow Executions / month | 100 | 1,000 | 10,000 | Unlimited |
| Team Members | 1 | 3 | 10 | Unlimited |
| Platform Connections | 2 | 5 | 15 | Unlimited |
| AI Agent Cores | 2 | 5 | All 8 | All 8 |
| Monthly AI Actions | 200 | 5,000 | 20,000 | 75,000 |
| Messages / month | 100 | 2,000 | 10,000 | Unlimited |
| Trigger Rules | 0 | 5 | 25 | Unlimited |
| Custom Templates | 0 | 0 | 50 | Unlimited |
| Max Autonomy Level | Monitor | Suggest | Auto-Low | Auto-Full |
14.2 Feature Availability
| Feature | Free | Starter | Professional | Enterprise |
|---|---|---|---|---|
| Product & Order Management | ✓ | ✓ | ✓ | ✓ |
| Basic Analytics | ✓ | ✓ | ✓ | ✓ |
| Email Communications | ✓ | ✓ | ✓ | ✓ |
| Template Viewing & Sending | ✓ | ✓ | ✓ | ✓ |
| Advanced Analytics | — | ✓ | ✓ | ✓ |
| API Access | — | ✓ | ✓ | ✓ |
| In-App Notifications | — | ✓ | ✓ | ✓ |
| Trigger Rules | — | ✓ | ✓ | ✓ |
| Agent Self-Learning | — | ✓ | ✓ | ✓ |
| Email Support | — | ✓ | ✓ | ✓ |
| Scheduled Workflows | — | — | ✓ | ✓ |
| Outbound Webhooks | — | — | ✓ | ✓ |
| WhatsApp Messaging | — | — | ✓ | ✓ |
| AI Message Compose | — | — | ✓ | ✓ |
| Communication Analytics | — | — | ✓ | ✓ |
| Custom Templates | — | — | ✓ | ✓ |
| Maestro Text Chat | — | — | ✓ | ✓ |
| White Labeling | — | — | ✓ | ✓ |
| Priority Support | — | — | ✓ | ✓ |
| Audit Logs | — | — | — | ✓ |
| SSO | — | — | — | ✓ |
| WeChat / Voice / Video | — | — | — | ✓ |
| Maestro Voice Mode | — | — | — | ✓ |
| Monte Carlo / Digital Twin | — | — | — | ✓ |
| Full Agent Autonomy | — | — | — | ✓ |
| Dedicated Support & SLA | — | — | — | ✓ |
| Custom Contracts | — | — | — | ✓ |
15. Feature Walkthrough Scenarios
These step-by-step scenarios demonstrate how to accomplish common tasks in OmniCart, combining multiple features together.
Scenario: Setting Up Your First Product
Goal: Add a product, assign categories, and prepare it for multi-channel listing.
- Navigate to Product Management > Products and click "Add Product"
- Fill in basics: Name = "Wireless Bluetooth Speaker", SKU = "WBS-001", Price = $49.99, Business Model = Retail Inventory, Status = Active
- Assign categories: Select "Electronics > Audio > Speakers" from the category dropdown. If no categories exist yet, go to Product Management > Categories first to create them
- Save — OmniCart creates the product and auto-generates a
productInventorycompanion record with default stock levels - Set inventory: Open the product detail, go to the Inventory Panel, and set your warehouse stock quantity (e.g., 150 units) and reorder point (e.g., 25 units)
- Prepare for channels: Open the Channel Tabs section. Fill in channel-specific fields for Shopify (tags, SEO title), Amazon (bullet points, search terms), or eBay (item specifics, listing format)
- Verify: Return to the product list — your product appears with the correct category, price, inventory level, and business model badge
Scenario: Multi-Channel Product Listing
Goal: Connect Shopify and Amazon, sync your products, and have the AI optimize your listings.
- Connect Shopify: Go to Integrations > Portal, click "Add Integration", select Shopify, enter your store URL and API credentials. The system tests the connection and auto-registers webhooks
- Connect Amazon: Repeat for Amazon with your Seller Central API credentials
- Wait for initial sync: A progress bar shows products and orders being imported. Shopify products appear first (webhook-first), Amazon follows
- Map categories: Go to Product Management > Categories. For each category, use the Channel Mapping panel to map to Shopify collections and Amazon browse nodes
- Configure sync settings: On the Integrations portal, click the gear icon for each connection. Enable Products + Orders + Inventory sync. Set frequency to "Real-time"
- AI optimization: Go to Command Center > Agents > Channel Master. Activate the agent. It will analyze your listings across both channels and suggest title improvements, keyword additions, and description enhancements
- Review & apply: Check the agent's Activity Feed for optimization suggestions. At "Suggest" autonomy, you approve each suggestion before it's applied
Scenario: Automated Order Routing with Agent Fulfillment
Goal: Configure agents to automatically route incoming orders to the correct fulfillment path based on business model.
- Ensure agents are active: Go to Command Center > Agents and verify Operations Controller and Supply Chain Commander are online
- Check your business model: If you're using "Mixed" mode, products tagged as DropShipping will route to suppliers, and Retail Inventory will route to your warehouse
- Create a test order: Go to Product Management > Orders and click "Create Order". Add a DropShipping product and a Retail product to the same order
- Observe the split: The system automatically splits the order into two fulfillment sub-groups:
- DropShipping items → routed to the assigned supplier
- Retail items → routed to your warehouse
- Check agent activity: The Supply Chain Commander evaluates supplier availability. The Operations Controller tracks fulfillment progress. Both record their decisions in the Intelligence Section
- Monitor: Return to the order detail to see status updates as each sub-group progresses through its fulfillment pipeline
Scenario: AI-Powered Dynamic Pricing
Goal: Set up the Financial Strategist agent to automatically optimize your pricing based on market conditions.
- Activate the Financial Strategist: Go to Command Center > Agents > Financial Strategist and toggle it online
- Configure pricing rules: In the agent's configuration panel, set:
- Minimum margin threshold (e.g., 15%)
- Maximum price change per day (e.g., 10%)
- Competitor tracking enabled
- Set autonomy level: At "Suggest" level, the agent recommends price changes that you approve. At "Auto-Low" (Professional), low-risk adjustments (<5% change) execute automatically
- Run A/B price test (Professional+): The agent can start a price experiment — testing two price points on different audience segments and measuring conversion rate impact
- Review results: Check the Intelligence Section for pricing decisions, the reasoning behind each, and the financial impact (revenue change, margin improvement)
- Marketplace push: When a price change is approved/auto-executed, OmniCart automatically pushes the new price to all connected channels (Shopify, Amazon, etc.) via the integration engine
Scenario: Handling a Supplier Emergency
Goal: See how agents coordinate when a key supplier goes down.
- Trigger: A supplier's API becomes unresponsive or they notify you of a stockout
- Supply Chain Commander detects the issue and sends an alert to the agent bus
- Maestro receives the alert and initiates the
handleSupplierEmergencycoordination flow - 4-agent coordination begins:
- Supply Chain Commander — Evaluates alternative suppliers, checks ratings and lead times
- Financial Strategist — Recalculates margins with alternative suppliers, adjusts pricing if needed
- Operations Controller — Reroutes pending orders to alternative fulfillment
- Business Diplomat — Drafts communication to affected customers about potential delays
- Resolution: Depending on autonomy level, actions are either auto-executed or queued for your approval. The entire coordination is visible in each agent's activity feed
- Post-mortem: The Chief Strategist generates a briefing summarizing the incident, impact, resolution, and recommendations to prevent recurrence
Scenario: Building a Workflow from Scratch
Goal: Create a workflow that sends a low-stock email alert when inventory drops below a threshold.
- Navigate to Command Center > Workflows and click "New Workflow"
- Name it "Low Stock Alert" and click "Create" to open the visual builder
- Add a Trigger node: Drag a Trigger from the Node Panel. Set type to "Event", event =
inventory.updated - Add a Condition node: Drag a Condition node and connect it to the Trigger. Set the condition:
{{trigger.stockLevel}}less than25 - Add an Action node (True path): Connect to the "Yes" output. Set action type to
sendNotification. Configure:- Channel: Email
- To: your email
- Subject: "Low Stock Alert: {{trigger.productName}}"
- Body: "Product {{trigger.productName}} (SKU: {{trigger.sku}}) has dropped to {{trigger.stockLevel}} units."
- Add an Action node (False path): Connect to the "No" output. Set action type to
logMessage. Message: "Stock level OK" - Activate: Toggle the workflow to "Active" and click "Publish Version"
- Test: Click the "Run" button to manually test with sample data, or wait for a real inventory update event to trigger it
Scenario: Automating Customer Communications
Goal: Set up automated order confirmation emails and low-stock notifications using trigger rules.
- Configure email channel: Go to Communications > Channels, click "Setup" on Email, enter your Resend API key
- Load default templates: Go to Settings > Templates and click "Load Default Templates" to import the 24 built-in templates
- Create order confirmation rule: Go to Communications > Rules, click "Create Rule":
- Event source: Order
- Event type:
order.created - Action: Send Template — select "Order Confirmation" template
- Cooldown: 1 per order per 24 hours
- Create low-stock notification: Create another rule:
- Event source: Inventory
- Event type:
inventory.low_stock - Condition:
stockLevelless than 10 - Action: Send In-App Notification (title: "Low Stock: {{productName}}")
- Cooldown: 1 per product per 6 hours
- Enable both rules and they start processing events immediately
- Monitor: Check rule execution stats on the Rules page (total executions, success rate, last executed)
Scenario: Onboarding a New Team Member
Goal: Add a team member with appropriate permissions and get them started.
- Check your team limit: Go to Settings > Billing to verify you haven't hit your team member quota (Starter=3, Pro=10, Enterprise=unlimited)
- Send the invite: Go to Settings > Team, click "Invite Member". Enter their email and select a role:
- Admin for a co-manager who needs full operational access
- Member for staff who create/edit products and process orders
- Viewer for stakeholders who only need read access to reports
- They accept: The invitee receives an email with a link. They create a Clerk account (or sign in with existing one) and are added to your organization
- Configure notifications: The new member can go to Settings > Notifications to configure which alerts they receive
- Monitor activity: All their actions are logged in the Audit Logs (Enterprise) for compliance tracking
16. FAQ & Troubleshooting
Common Questions
Q: What happens when my free trial ends?
Write operations (creating products, orders, workflows) are restricted. You can still read and view all your data. Upgrade to any paid plan to restore full access. Your data is preserved — nothing is deleted.
Q: Can I downgrade my plan?
Yes. Go to Settings > Billing and select a lower tier. If your current usage exceeds the new plan's limits (e.g., you have 600 products but downgrade to Starter's 500 limit), existing data is preserved but you can't create new items until you're below the limit.
Q: How do AI agents learn from my data?
Agents record every decision they make (pricing changes, order routing, supplier evaluations). A daily learning synthesis job extracts patterns from recent decisions (what worked, what didn't) and stores them as agent memories. These memories inform future decisions, making agents smarter over time. Learning is isolated by business model — DropShipping patterns don't contaminate Retail Inventory learning.
Q: Is my data isolated from other tenants?
Absolutely. OmniCart uses row-level tenant isolation. Every database query includes your tenant ID, and this is enforced server-side — it never comes from the client. No other tenant can see, query, or access your data.
Q: Can agents make changes to my live marketplaces?
Yes, but only within your configured autonomy level and guardrails. At "Monitor" level, agents only observe. At "Suggest", they recommend changes for your approval. At "Auto-Low", only low-risk changes execute automatically. At "Auto-Full", all changes execute within spending caps and daily limits. An emergency stop button is always available.
Q: What sales channels can I connect?
Shopify, WooCommerce, Amazon, eBay, TikTok, Instagram, and Facebook. Multiple connections per platform are supported (e.g., two Shopify stores). Custom storefronts can integrate via the REST API (Starter+).
Q: How does the webhook-first sync work?
When you connect a platform, OmniCart automatically registers webhooks (e.g., Shopify's products/update, orders/create). Changes on the platform push to OmniCart in real-time. As a safety net, a reconciliation poll runs every 6 hours to catch anything webhooks might miss. All webhooks are verified using HMAC-SHA256 signatures.
Q: Can I use OmniCart's API to build custom integrations?
Yes (Starter+ plan). Generate API keys at Integrations > API Keys. Keys use the omnc_ prefix, support per-key permission scopes and rate limits. The API provides access to products, orders, inventory, and more.
16.1 Troubleshooting
Integration connection fails
Cause: Invalid API credentials, expired tokens, or the platform's API is down.
Fix: Verify your API key/secret, check the platform's status page, and retry. Go to Integrations > Health to run a health check. Check Integrations > Activity for detailed error messages.
Workflow execution fails
Cause: A step encountered an error (invalid data, API timeout, missing variable).
Fix: Open the workflow, check the Execution Logs panel for the failed step. Examine input data and error message. Common fixes: correct variable references ({{stepName.field}}), increase retry count, or add error handling.
Agent not taking actions
Cause: Autonomy level is "Monitor" (observe only), agent is paused, daily action limit reached, or monthly AI action quota exceeded.
Fix: Check agent status (is it Online?). Verify your plan's autonomy level. Check Settings > Billing for AI action usage. Increase autonomy level if appropriate.
"Upgrade Required" modal appears
Cause: You're trying to use a write action on a feature that requires a higher plan tier.
Fix: This is by design. Go to Settings > Billing to upgrade. Remember: you can always view all features (demo data is shown), but write actions require the appropriate plan.
Products not syncing to marketplace
Cause: Sync toggles disabled, webhook registration failed, or DropShipping products (supplier-managed inventory skips marketplace push by design).
Fix: Check connection sync settings (gear icon). Verify webhooks are registered (Integrations > Health). For DropShipping products, inventory sync is intentionally skipped because the supplier manages stock levels.
16.2 Glossary
| Term | Definition |
|---|---|
| Tenant | Your organization's isolated workspace in OmniCart |
| Agent Core | One of the 8 specialized AI agents (e.g., Market Scout, Financial Strategist) |
| Autonomy Level | How independently agents can act: Monitor, Suggest, Auto-Low, Auto-Full |
| Capability | A specific skill an agent can perform (e.g., dynamic_pricing, fulfillment_routing) |
| Tool | An executable action an agent invokes (e.g., adjustPrice, routeOrder) |
| Guardrail | Safety limits on agent actions: spending caps, action counts, active hours |
| Agent Bus | The message system agents use to communicate and coordinate with each other |
| Pipeline | A pre-built operational workflow for DropShipping or Retail Inventory |
| Workflow | A visual automation built in the drag-and-drop Workflow Builder |
| Trigger Rule | A "When X happens, send Y" automation in the Communications system |
| Platform Connection | A linked sales channel (Shopify, Amazon, etc.) with sync enabled |
| Webhook | Real-time HTTP push notification for instant data sync |
| HMAC-SHA256 | Cryptographic signature used to verify webhook authenticity |
| BATNA | Best Alternative to a Negotiated Agreement (used by Business Diplomat) |
| ZOPA | Zone of Possible Agreement (the negotiation range) |
| Demo Data | Sample data shown on pages for features requiring a higher plan tier |
| Companion Record | Auto-created record linked to a product: productInventory or productDropshipInfo |
| Mixed Mode | Business model where some products are DropShipping and others are Retail |
| Reconciliation | Periodic full sync that catches any changes webhooks may have missed |