Universal Voice Architecture
BrokerOS decouples telecommunications transport from conversational artificial intelligence. Every outbound voice campaign executes across two distinct, independently configured layers:- PSTN Carrier Bridge Layer: Physical telecommunications infrastructure (Vobiz, Exotel, Twilio, Telnyx) that provisions phone numbers, dials target handsets, and manages SIP trunks.
- 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.
Universal Engine Registry
BrokerOS registers all supported voice platforms inintegrations/voice/index.ts under the central VOICE_AGENT_REGISTRY:
The IVoiceAgentProvider Contract
All voice agent adapters implement the unifiedIVoiceAgentProvider 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:- Aggregator Module:
integrations/voice/index.ts - Vapi:
integrations/voice/agents/vapi/(@brokeros/int-agent-vapi) - Retell AI:
integrations/voice/agents/retell/(@brokeros/int-agent-retell) - Sarvam AI:
integrations/voice/agents/sarvam/(@brokeros/int-agent-sarvam) - Bolna:
integrations/voice/agents/bolna/(@brokeros/int-agent-bolna) - ElevenLabs:
integrations/voice/agents/elevenlabs/(@brokeros/int-agent-elevenlabs) - LiveKit:
integrations/voice/agents/livekit/(@brokeros/int-agent-livekit) - OpenAI Realtime:
integrations/voice/agents/openai-realtime/(@brokeros/int-agent-openai-realtime) - Pipecat:
integrations/voice/agents/pipecat/(@brokeros/int-agent-pipecat)
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.