Skip to content

Platform Overview

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

Current Version: v4.3.0 (March 9, 2026)

In This Section

Page Description
What VitaraVox Does Product capabilities and value proposition
Architecture System components, diagrams, and data flow
Data Flow & Guardrails Data ownership, security boundaries, conversation flows
Technology Stack Validated infrastructure and technology inventory
Roadmap v0.5 → v4.0.1 release history and future backlog

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 (v4.0.1)

  • 9-agent dual-track squad: Router + 4 roles x 2 languages (EN/ZH)
  • SOAP/WS-Security: Direct connection to OSCAR EMR (no middleman)
  • PM2 process manager: vitara-admin-api on port 3002
  • 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
  • 4s circuit breaker for SOAP adapter fault isolation

System Scope

┌────────────────────────────────────────────────────────────────────────┐
│                       VITARAVOX PRODUCT SCOPE                          │
├────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   TELEPHONY          VOICE AI         MIDDLEWARE         EMR           │
│   ─────────          ────────         ──────────         ───           │
│                                                                         │
│   Telnyx/VoIP.ms     Vapi.ai          Vitara             OSCAR         │
│   Phone Number       Squad (9)        Platform           (SOAP)        │
│        │                │                │                  │          │
│        ▼                ▼                ▼                  ▼          │
│   ┌─────────┐      ┌─────────┐      ┌─────────┐       ┌─────────┐     │
│   │ 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. Security & data handling? → Data Flow
  4. What's coming next? → Roadmap