Case Study · Project Planning
AI Commerce OS — Project Planning
The complete planning document behind AI Commerce OS — a multi-tenant SaaS platform that answers inbound calls with an AI voice agent, takes conversational orders over WhatsApp, automatically recovers missed calls into chat, and routes every order into a single dashboard.
- Product
- AI Commerce OS
- Engagement
- Fixed-price MVP / Pilot
- Document
- Proposal v1.0
- Prepared by
- SM Ashiqurzamman
01
Executive Summary
Small businesses that take a high volume of phone orders lose revenue every day to missed and unanswered calls. AI Commerce OS is a multi-tenant SaaS platform that answers inbound calls with an AI voice agent, takes and confirms orders over a conversational WhatsApp agent, automatically recovers missed calls into WhatsApp conversations, and routes every order into a single management dashboard.
The platform is delivered in clearly defined phases. Phase 1 is a focused, fixed-price MVP / pilot that proves the core value — answer calls, recover missed orders, manage them in one place. Phases 2 and 3 extend the MVP into a full commercial SaaS with loyalty, marketing automation, deeper AI memory, and enterprise capabilities, commissioned separately once the pilot succeeds.
No voice model is built from scratch. The system integrates proven voice AI platforms (Vapi / Retell) with the WhatsApp Business API and a custom backend and dashboard. The client owns all source code and all platform accounts.
| Item | Detail |
|---|---|
| Product | AI Commerce OS — AI voice + WhatsApp order-taking SaaS |
| Phase 1 (this contract) | Fixed-price MVP/pilot: voice AI, WhatsApp AI, missed-call recovery, order dashboard, multi-tenant roles |
| Phase 2 | Loyalty, marketing automation, analytics, advanced AI memory |
| Phase 3 | White-label, API, ERP/POS integrations, franchise & enterprise |
| Ownership | 100% client-owned code and accounts; full documentation and handover |
| Commercial model | Fixed-price per phase, with optional maintenance retainer |
02
Understanding the Problem
During peak hours, staff cannot answer every call. Each missed call is a potential lost order and a customer who may not call back. Static auto-replies do not solve this — a customer who reaches voicemail or an unanswered line rarely completes the order on their own.
The goal is therefore not only to answer more calls, but to actively recover the ones that are missed and to make ordering effortless across both voice and chat — while giving the business clear visibility and control over every order in one place.
What success looks like
- Fewer missed orders — calls are answered by AI when staff cannot pick up.
- Missed calls are recovered — the customer is reached on WhatsApp and finishes the order in chat.
- One source of truth — orders from voice and WhatsApp land in the same dashboard.
- A personal feel — the AI remembers returning customers and their usual orders.
- Full ownership — the business runs the system itself, with clean code and documentation.
03
Solution Overview
AI Commerce OS is a multi-tenant platform. A single deployment serves many businesses (tenants), each fully isolated. The platform is sold as a subscription, with three operating roles:
Super-Admin
Shop-Admin
Branch-Admin
Tenant isolation: each shop's data — orders, customers, and AI memory — is strictly separated. One shop can never access another shop's data.
Core capabilities
Inbound AI Voice Agent
WhatsApp AI Agent
Missed-Call → WhatsApp Recovery
Order Management Dashboard
Per-Shop AI Memory
04
Technical Architecture
The architecture favours a single shared platform with strict logical isolation per tenant. This keeps operating costs and complexity low at MVP stage while remaining a true multi-tenant SaaS that can scale.
↓
Backend API (NestJS) → Shared LLM with per-tenant context
↓
PostgreSQL (tenant-scoped) → Dashboard (Next.js)
| Layer | Responsibility |
|---|---|
| Marketing website | Public site, SEO, plan information, lead capture and signup. |
| Dashboard app | Role-based UI for Super-Admin, Shop-Admin, and Branch-Admin. |
| Backend API | Auth, tenancy, orders, customers, billing, webhooks, AI orchestration. |
| Voice AI | Vapi/Retell handle speech; function calls push structured orders to the backend. |
| WhatsApp AI | Backend conversation state machine + LLM for natural chat ordering. |
| Data layer | PostgreSQL with tenant_id isolation; Redis for queues and caching. |
| AI layer | Shared LLM with per-tenant system prompt and customer profile injected at runtime. |
Multi-tenancy approach (MVP): a shared database and schema with a tenant_id column on every tenant-scoped table. Every backend query is automatically scoped to the authenticated user's shop and branch. At scale, the model can evolve toward separate schemas or databases per tenant — deliberately deferred to avoid operational overhead at MVP scale.
05
Technology Stack
Every choice is selected for reliability, maintainability, and full client ownership — no proprietary lock-in, and a single TypeScript language across front and back end.
| Layer | Technology | Why this choice |
|---|---|---|
| Frontend | Next.js, React, TypeScript, Tailwind, shadcn/ui | Fast, modern, clean dashboards and marketing site from one codebase. |
| Backend | Node.js + NestJS (TypeScript) | Structured, modular backend; same language as the frontend, end to end. |
| Database | PostgreSQL | Reliable relational store; clean tenant_id isolation. |
| ORM | Prisma | Type-safe queries and clean migrations. |
| Cache / Queue | Redis + BullMQ | Sessions, rate limiting, and delayed jobs (e.g. timed follow-ups). |
| Voice AI | Vapi (primary) / Retell (alternative) | Proven platforms integrated — no model built from scratch. |
| Telephony | Twilio | Phone numbers, missed/unanswered-call detection, recording. |
| Meta WhatsApp Cloud API | Official, lowest-cost path; no reseller markup. | |
| LLM | OpenAI / Claude (cost-tiered) | Cheaper model for routine orders; stronger model only when needed. |
| AI memory (MVP) | PostgreSQL profile fields | Remembers usual orders without the cost of a vector DB. |
| Auth | JWT with role claims | Stateless, secure, easy to extend. |
| Billing & Payments | Stripe + bKash / Nagad / SSLCommerz | Card subscriptions via Stripe; POS + local gateways for regional payments. |
| Hosting | Docker + Coolify on client-owned VPS | Full client ownership, no vendor lock-in, low cost at small scale. |
| Monitoring | Sentry + usage/cost logging | Error tracking plus per-tenant usage metering. |
06
Phased Delivery Plan
The platform is built in three phases. Each phase is a standalone, fixed-price contract delivering working value on its own. This protects the client's investment — the pilot proves the concept before any commitment to the larger build.
| Phase | Focus | Outcome |
|---|---|---|
| Phase 1 — MVP / Pilot | Core order-taking + recovery | A live, working system proving missed-order recovery for a real business. |
| Phase 2 — Growth | Retention + marketing + analytics | Tools that increase repeat orders and revenue per shop. |
| Phase 3 — Enterprise | Scale + integrations + resale | A full commercial SaaS ready for many clients and large accounts. |
Phase 1 — MVP / Pilot
Objective: prove the core value on a fixed price.
Included
- Inbound AI voice agent (Vapi/Retell + Twilio)
- Conversational WhatsApp AI agent
- Missed/unanswered-call → WhatsApp recovery + callback
- Order dashboard (voice + WhatsApp, status, search, export)
- Per-shop customer profile and memory (no vector DB)
- Multi-tenant roles: Super / Shop / Branch admin
- Basic subscription/plan assignment + usage logging
- Lean marketing website
- Telephony setup, transcripts, per-call logs
- Full documentation and clean handover
Excluded (later phases)
- • Loyalty, broadcast marketing, inventory, staff
- • Vector-DB / RAG long-term memory
- • White-label, ERP/POS, franchise tools
- • Full self-serve billing lifecycle + multi-currency
Phase 2 — Growth
Turn the MVP into a platform that drives repeat business and revenue per shop.
- • Loyalty system — points, tiers, coupons, cashback
- • Marketing automation — WhatsApp broadcasts, AI campaign generator
- • Advanced AI memory — vector DB (Qdrant) + RAG
- • Customer CRM — LTV, complaints, notes, history
- • Analytics — revenue, peak hours, retention, AI metrics
- • Delivery operations — riders, zones, pickup
- • Richer ordering — voice-note, images, payment links
- • Inventory awareness — AI skips out-of-stock items
Phase 3 — Enterprise & Scale
Make the platform a full commercial SaaS for many clients and resellers.
- • White-label per shop — logo, domain, branding
- • Public REST API + webhooks
- • ERP / POS / delivery integrations
- • Franchise management for multi-location brands
- • Full self-serve billing — trials, upgrades, annual, multi-currency
- • Enterprise compliance — GDPR workflows, audit depth
- • Scalability — schema-per-tenant, multi-region
- • Employee management — staff, attendance, ratings
07
Unit-Cost Model & Service Pricing
AI voice and messaging carry a real per-use cost. Before subscription prices are set, the platform meters and models cost-to-serve per shop, so plans are always priced with margin. Figures are approximate mid-2026 rates; confirmed against live provider pricing at contract time.
7.1 Per-use cost to serve (per shop)
| Service | Approx. unit cost | Notes |
|---|---|---|
| Voice AI orchestration (Vapi) | ~$0.05 / min | Base platform fee; STT, LLM, TTS billed on top. |
| Voice all-in (STT+LLM+TTS+telephony) | ~$0.13–$0.31 / min | Blended live cost. Budget ~$0.20/min working average. |
| Retell (alternative) | ~$0.07+ / min base | Bring-your-own-LLM; all-in ~$0.11–$0.15/min. |
| Twilio phone number | ~$1–$2 / month | One number per shop/branch. |
| Twilio inbound minutes | ~$0.0085–$0.014 / min | Country-dependent; on top of voice AI. |
| WhatsApp service messages | Free in 24-hr window | ~1,000 free service conversations/mo. |
| WhatsApp utility template | ~$0.004–$0.045 / msg | Missed-call follow-up & confirmations outside free window. |
| WhatsApp marketing template | ~$0.01–$0.14 / msg | Promotions/broadcasts (Phase 2). |
| LLM tokens (WhatsApp turn) | fractions of a cent / turn | Cost-tiered model (e.g. GPT-4o-mini). |
Worked example — one busy shop, one month
1,000 AI calls × ~4 min × ~$0.20/min ≈ $800 voice; plus ~$15–$30 WhatsApp templates + LLM; plus ~$2 number rental. Roughly $820–$850/month for a busy single-branch shop. A lighter shop (200 calls) lands nearer $150–$200/month — exactly why the pilot measures real usage before plans are priced.
7.2 Suggested subscription plans
| Plan | Approx. price / mo | Includes |
|---|---|---|
| Starter | $39–$59 | WhatsApp AI only, single branch, ~1,000 messages, basic dashboard. |
| Growth | $99–$149 | Voice + WhatsApp, up to 3 branches, memory, missed-call recovery, capped minutes. |
| Pro | $249–$399 | Unlimited branches, full memory, higher caps, advanced analytics, priority support. |
| Enterprise | Custom | White-label, API, franchise tools, dedicated support (Phase 3). |
Usage caps matter: voice has real per-minute cost. Each plan includes a fair-use allowance, with overage billed per unit.
08
Build Services, Minimum Requirements & Setup
8.1 One-Time Build (Phase 1 MVP)
| Work item | Scope | What it covers |
|---|---|---|
| Multi-tenant backend + roles + DB | included in MVP | Auth, tenancy, Super/Shop/Branch roles, schema. |
| Order dashboard (3 roles) | included in MVP | Live orders, status pipeline, search, export. |
| Voice AI integration | included in MVP | Vapi/Retell + Twilio, order capture, transcripts. |
| WhatsApp AI agent | included in MVP | Conversational ordering + missed-call recovery. |
| Customer memory (simple) | included in MVP | Per-shop profile and usual-order recall. |
| Lean marketing website | included in MVP | Home, features, pricing, demo, signup, contact. |
| Documentation & handover | included in MVP | Full docs + walkthrough; client owns everything. |
| Total fixed Phase 1 price | confirmed at contract | Quoted as one fixed price after discovery call. |
8.2 Third-party accounts & minimum setup
| Service | Min. to start | Notes |
|---|---|---|
| Twilio (telephony) | ~$20 credit + number | Account verification; ~$1–$2/mo per number. |
| Vapi or Retell (voice AI) | ~$10–$20 credit | Standard developer signup; pay-as-you-go. |
| Meta WhatsApp Cloud API | $0 to start | Business verification + phone number; free tier covers initial usage. |
| LLM provider (OpenAI / Claude) | ~$10 credit | API key with a small prepaid balance. |
| VPS (hosting) | ~$10–$30 / month | Standard Linux VPS for app, DB, queues. |
| Domain name | ~$10–$15 / year | Registered under client ownership. |
| Stripe (subscriptions) | $0 to start | Standard verification; pay-as-you-go fees. |
8.3 Approx. monthly platform overhead
| Item | Approx. cost / mo | Notes |
|---|---|---|
| VPS hosting | $10–$30 | Single VPS comfortably runs the MVP and pilot. |
| Domain | ~$1 | Annual fee, amortised. |
| Sentry / monitoring | $0–$26 | Free tier sufficient at pilot scale. |
| Backups & object storage | $1–$5 | DB snapshots and call recording storage. |
| Email (transactional) | $0–$10 | Password resets, receipts, alerts. |
Minimum to launch the pilot: verified Twilio + one number, Vapi/Retell account, verified Meta WhatsApp Business account, LLM API key with credit, one VPS, a domain. Upfront out-of-pocket to go live (ex. development) is roughly $50–$120 plus per-use charges.
09
Delivery Process
Work proceeds through a clear, repeatable sequence with regular check-ins.
- 1
Discovery
Confirm languages, order flows, branches, and pilot business details.
- 2
Audit & setup
Provision accounts (Twilio, Vapi/Retell, Meta, LLM, hosting) under client ownership.
- 3
Build
Implement data model, roles, dashboards, and AI channels in the build order below.
- 4
Review
Demo each milestone; gather and apply feedback.
- 5
Pilot
Run the live system with the pilot business; capture usage and cost data.
- 6
Handover
Documentation, walkthrough, and full transfer of code and accounts.
Phase 1 build order
- 01Multi-tenant database schema, authentication, and role system.
- 02Order dashboard for all three roles, validated with test orders.
- 03Twilio + voice AI integration — voice orders flowing into the dashboard.
- 04WhatsApp Cloud API + conversation agent — chat orders into the same dashboard.
- 05Missed-call → WhatsApp recovery, tightening the two channels together.
- 06Customer memory wired into both voice and WhatsApp.
- 07Lean marketing site, plan assignment, and pilot launch.
10
Ownership, Security & Compliance
Ownership & handover
Security
Compliance (MVP-level)
11
Commercials & Engagement
Engagement model: fixed-price, paid contract per phase. Phase 1 (MVP / Pilot) is contracted now. Phases 2 and 3 are optional and commissioned separately once the pilot demonstrates value.
| Item | Detail |
|---|---|
| Phase 1 scope | As defined in section 6.1 |
| Phase 1 price | Fixed — confirmed after discovery call |
| Payment structure | Milestone-based across the Phase 1 build |
| Phase 2 & 3 | Separate fixed-price contracts, optional |
| Maintenance | Optional monthly retainer |
Next step
A short discovery call to confirm languages, order flows, branch setup, and the pilot business — after which the fixed Phase 1 price and milestone schedule are finalised and work can begin.
Hire on UpworkDocument: AI Commerce OS Proposal v1.0 · Prepared by SM Ashiqurzamman