Skip to content

Product Vision

What VitaraVox does, how it works, and where it's going

Current Version: v3.2.1 (February 12, 2026)

In This Section

Page Description
Overview Product capabilities and value proposition
Architecture System components and data flow
Roadmap v0.5 → v3.0 → v3.2.1 release plan
Data Flow & Guardrails Data ownership, security, conversation flows

Quick Summary

VitaraVox is an AI voice assistant that answers clinic phone calls in English and Mandarin Chinese, handling:

  • Appointment booking - Find earliest slot, book with confirmation
  • Rescheduling & cancellation - Modify or cancel existing appointments
  • New patient registration - BC Health compliant (PHN, BC Services Card)
  • Waitlist management - When registration is closed
  • Admin dashboard - React-based multi-tenant clinic management

Production Architecture (v3.0+)

  • 9-agent dual-track squad: Router + 4 roles x 2 languages (EN/ZH)
  • HMAC-SHA256 webhook auth with 5-minute replay window
  • AES-256-GCM credential encryption at rest
  • PHI log redaction — patient data never appears in logs
  • 18 Zod validation schemas with .strict() enforcement
  • Graceful shutdown for zero-downtime restarts

System Scope

┌────────────────────────────────────────────────────────────────────────┐
│                       VITARAVOX PRODUCT SCOPE                          │
├────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   TELEPHONY          VOICE AI         MIDDLEWARE         EMR           │
│   ─────────          ────────         ──────────         ───           │
│                                                                         │
│   Telnyx/VoIP.ms     Vapi.ai          Vitara             OSCAR         │
│   Phone Number       Squad (9)        Platform           (OAuth)       │
│        │                │                │                  │          │
│        │                │                │                  │          │
│        ▼                ▼                ▼                  ▼          │
│   ┌─────────┐      ┌─────────┐      ┌─────────┐       ┌─────────┐     │
│   │ Inbound │      │ STT     │      │ Webhook │       │ Patient │     │
│   │ Calls   │─────▶│ + LLM   │─────▶│ Handler │──────▶│ Lookup  │     │
│   └─────────┘      │ + TTS   │      │ + Auth  │       │ + Book  │     │
│                    │(per-lang)│      │ + DB    │       │         │     │
│                    └─────────┘      └─────────┘       └─────────┘     │
│                                                                         │
│   SCOPE STARTS ──▶                                   ◀── SCOPE ENDS   │
│   (Phone number)                                     (EMR API call)   │
│                                                                         │
└────────────────────────────────────────────────────────────────────────┘

What's Not in Scope

Out of Scope Reason
EMR hosting Clinics provide their own OSCAR
Medical records access Privacy - scheduling only
Outbound calls Planned for future
SMS Planned for future
Billing Transfers to staff

Start Here

  1. New to VitaraVox? → Overview
  2. Technical architecture? → Architecture
  3. What's coming next? → Roadmap
  4. Security & data handling? → Data Flow