Skip to main content

Universal Voice Architecture

BrokerOS decouples telecommunications transport from conversational artificial intelligence. Every outbound voice campaign executes across two distinct, independently configured layers:
  1. PSTN Carrier Bridge Layer: Physical telecommunications infrastructure (Vobiz, Exotel, Twilio, Telnyx) that provisions phone numbers, dials target handsets, and manages SIP trunks.
  2. AI Voice Agent Engine Layer: Conversational intelligence platforms (Vapi, Retell, Sarvam, Bolna, ElevenLabs, LiveKit, OpenAI Realtime, Pipecat) that process audio, recognize speech, manage dialog state, and synthesize responses.
This separation prevents vendor lock-in: real estate brokerages can route calls through local Indian PSTN carriers (e.g. Exotel or Vobiz for regulatory TRAI DND compliance) while streaming audio into specialized Indic models (Sarvam) or global ultra-low latency engines (Retell).

Universal Engine Registry

BrokerOS registers all supported voice platforms in integrations/voice/index.ts under the central VOICE_AGENT_REGISTRY:

The IVoiceAgentProvider Contract

All voice agent adapters implement the unified IVoiceAgentProvider interface from packages/types:

Carrier Bridge Dispatcher Logic

When a voice campaign starts, tryCarrierBridgeDispatch evaluates whether PSTN carrier credentials (Vobiz, Exotel, Twilio, or Telnyx) are present. If configured, the call is placed through the carrier’s PSTN trunk, and an answer_url webhook is passed to connect the answered call directly to the chosen AI agent:

Monorepo Workspace Package Map

Voice integrations live within self-contained packages in the monorepo root:

Setup Steps

1

Configure Telephony Carrier

Navigate to Settings -> Integrations -> Telephony Carriers and connect your PSTN trunk (e.g. Vobiz, Exotel, Twilio, or Telnyx).
2

Connect AI Voice Platform

Navigate to Settings -> Integrations -> AI Voice Agents -> Add Platform and supply the API key for your chosen voice engine (e.g. Vapi, Retell, Sarvam).
3

Compose Voice Campaign

In the Voice Campaign Wizard, choose your target project, select the telephony carrier for dialing, and configure the voice persona, script, and variables in the Agent Composer Studio.