twilio-agent

Overview ¶

Example: Voice agent handling inbound Twilio calls

This example demonstrates how to wire an OmniVoice agent to handle incoming phone calls via Twilio ConversationRelay.

Architecture:

┌──────────┐        ┌─────────────────┐        ┌───────────────────┐
│  Caller  │◄──────►│     Twilio      │◄──────►│   OmniVoice       │
│  (PSTN)  │  PSTN  │ ConversationRelay│  WS   │   Voice Agent     │
└──────────┘        └─────────────────┘        └───────────────────┘

Flow: 1. Caller dials your Twilio phone number 2. Twilio webhook hits your server 3. Server returns TwiML connecting to ConversationRelay 4. ConversationRelay opens WebSocket to your agent 5. Agent receives audio, processes with STT → LLM → TTS 6. Agent sends audio back through the same WebSocket