System Architecture Overview

Overview

Voipappz uses a layered architecture designed for reliability, scalability, and multi-tenancy. Understanding the high-level components helps administrators make better configuration decisions.

Architecture Layers

1. Admin Portal (Frontend)

The web-based admin panel where you manage all platform resources. Built with React and Material-UI, it communicates with the backend via RESTful APIs.

2. API Layer (Backend)

The Ruby/Sinatra API server handles authentication, resource management, and business logic. All operations — from creating a DID to configuring an IVR — go through this layer.

3. Voice Engine

The FreeSWITCH-based voice engine handles real-time call processing, media, and VoIP protocols. It executes the call routing logic defined in the admin portal.

4. AI & Automation

Pipecat-based voice AI pipeline for Bot agents, VML scripting engine for custom logic, and a workflow engine for process automation.

5. Data Layer

PostgreSQL for persistent storage, Redis for caching and real-time state, and InfluxDB for time-series metrics.

How They Connect

Administrator configures resources in the Admin Portal
Configuration is saved via the API Layer to the database
When a call arrives, the Voice Engine reads the configuration and routes accordingly
If the call hits a Bot bridge, the AI pipeline takes over
All events are logged for monitoring and reporting