The Architecture Behind Multi-Tenant Voice AI

Building for Multiple Clients from Day One

When we started building TeleV, the requirement was clear: a voice AI platform that any business could white-label. Each client would get their own branded portal, phone numbers, voice agents, and data — completely isolated from every other client.

The Multi-Tenant Architecture

Data Isolation with RLS

Every table in TeleV's database has a client_id column and a Row Level Security policy that ensures queries only return data belonging to the authenticated client. This isn't application-level filtering — it's enforced by PostgreSQL itself.

Dual Portal System

TeleV has two Next.js applications sharing a common design system:

1. Admin Portal — V Anant AI's internal dashboard for managing all clients, monitoring calls across tenants, and system configuration
2. Client Portal — The white-labeled interface each client sees, branded with their logo, colors, and domain

Voice Processing Pipeline

The voice pipeline uses Python FastAPI for real-time audio processing:

1. Call initiated through provisioned phone number
2. Audio stream routed to FastAPI voice processor
3. Real-time transcription generated during the call
4. AI agent responds based on client-configured scripts and persona
5. Call recording, transcript, and analytics stored per-client

Campaign Management

TeleV includes a campaign builder for bulk calling operations. Clients upload a list of leads, configure the voice agent script, and launch campaigns. The system handles:

• Call scheduling and throttling
• Real-time progress monitoring
• Lead status updates (Cold, Warm, Hot, Converted)
• Post-campaign analytics and reporting

The White-Label Branding Engine

Each client configures their brand through the admin panel — logo, colors, company name, domain. The Next.js frontend dynamically applies these settings, so each client's team sees a fully branded experience without any custom deployment.

Key Takeaway

Multi-tenant architecture is hard to add later. If there's any chance your product will serve multiple clients, design for tenant isolation from day one. The cost of retrofitting is 10x the cost of building it right the first time.