DeskRoute

An AI receptionist for appointment-based local businesses. Customers call a real US phone number — DeskRoute answers, books appointments via Google Calendar, and escalates anything it can't handle to the business owner through an admin dashboard.

Built as a multi-tenant B2B SaaS.

Features

• Real phone calls — LiveKit Phone Numbers, no SIP trunk setup required
• Answers from context — services, pricing, and business details baked into the system prompt at call start; no RAG needed for common questions
• Knowledge base — pgvector semantic search for questions beyond the prompt
• Appointment booking — checks Google Calendar availability and creates confirmed events by voice
• Escalation loop — unanswerable questions flagged for admin review; resolved answers auto-populate the knowledge base
• Call recordings — every call recorded with full transcript and AI-generated summary
• Admin dashboard — calls, escalations, appointments, knowledge base, and settings
• Multi-tenant — every table is tenant-scoped; each business is fully isolated

How It Works

1. Customer calls the business's US phone number
2. LiveKit routes the call to the AI agent worker via SIP
3. Agent resolves the tenant from the number dialed, builds a system prompt with business context, and greets the caller
4. STT → LLM → TTS pipeline handles the conversation; Silero VAD detects end of turn
5. Pricing and hours answered directly from the system prompt — no tool calls needed
6. Unknown questions: semantic search checks the knowledge base; no match → question flagged for admin
7. Bookings: availability checked against Google Calendar, confirmed event created by voice
8. On hang-up: transcript extracted, summary generated, call record finalized

Tech Stack

Layer	Technology
API server	Hono (Node.js, ESM)
Database	Neon Postgres + Drizzle ORM + pgvector
Auth	Clerk
Voice pipeline	LiveKit Agents SDK
STT	AssemblyAI universal-streaming
LLM	OpenRouter — gpt-4o-mini recommended
TTS	Cartesia Sonic
VAD	Silero
Telephony	LiveKit Phone Numbers
Calendar	Google Calendar API
Frontend	React 19 + Vite + TypeScript
UI	Tailwind v4 + shadcn/ui
Data fetching	TanStack Query v5

Getting Started

Prerequisites

• Node.js 20+
• LiveKit Cloud project with a US phone number
• Clerk application with Google OAuth enabled
• Neon Postgres database
• OpenRouter API key

Install

git clone https://github.com/Flux690/desktroute
cd desktroute
npm install

Environment

backend/.env

DATABASE_URL=
LIVEKIT_URL=                   # wss://your-project.livekit.cloud
LIVEKIT_API_KEY=
LIVEKIT_API_SECRET=
CLERK_SECRET_KEY=
OPENROUTER_API_KEY=
OPENROUTER_BASE_URL=           # defaults to https://openrouter.ai/api/v1
LLM_MODEL=                     # use openai/gpt-4o-mini
EMBEDDING_MODEL=               # defaults to nvidia/llama-nemotron-embed-vl-1b-v2:free

frontend/.env

VITE_CLERK_PUBLISHABLE_KEY=
VITE_API_URL=http://localhost:8080/api

Database

npm run db:generate -w backend
npm run db:migrate -w backend

Run

npm run dev:backend    # API server → http://localhost:8080
npm run dev:agent      # LiveKit agent worker — keep running alongside the API
npm run dev:frontend   # Admin dashboard → http://localhost:5173

API Reference

Public:

Method	Path	Description
GET	/api/health	Liveness check
POST	/api/onboarding	Create tenant + purchase phone number
GET	/api/onboarding/phone/search?areaCode=415	Search available numbers (areaCode optional)

Admin — Authorization: Bearer <clerk_jwt> required:

Method	Path	Description
GET	/api/admin/metrics?period=30d	KPI counts
GET	/api/admin/calls	Paginated call history
GET	/api/admin/calls/:id	Call detail with transcript + recording
GET	/api/admin/escalations?status=pending	Escalation list
POST	/api/admin/escalations/:id/resolve	Resolve + add to knowledge base
GET	/api/admin/knowledge	Knowledge base items
DELETE	/api/admin/knowledge/:id	Delete knowledge item
GET	/api/admin/appointments	Appointment list
GET	/api/admin/settings	Tenant settings
PATCH	/api/admin/settings	Update settings
POST	/api/admin/telephony/provision	Purchase phone number
DELETE	/api/admin/telephony/release	Release phone number
DELETE	/api/admin/account	Delete tenant and all data

License

ISC © 2026 Prabhat Mattoo