feros
Architecture

Telephony Architecture

Twilio/Telnyx ingress and stream bridging through `voice/server`.

Telephony Architecture

Responsibilities

  • voice/server: webhook ingress, agent lookup, session registration, stream URL generation
  • voice/engine: websocket media stream handling and runtime execution

Inbound Endpoints

  • POST /telephony/twilio/incoming/{agent_id}
  • POST /telephony/telnyx/inbound/{agent_id}

Media Stream Endpoints

  • GET /telephony/twilio/stream/{session_id}/{token}
  • GET /telephony/telnyx/stream/{session_id}/{token}

Path-based token transport is used to avoid dropped query params in websocket upgrade paths.

Runtime Architecture

Rust voice runtime execution model in `voice/engine`.

Security Model

Authn/authz boundaries and secret handling in feros.

On this page

Telephony ArchitectureResponsibilitiesInbound EndpointsMedia Stream Endpoints