Overview
TwilioFrameSerializer
enables integration with Twilio’s Media Streams WebSocket protocol, allowing your Pipecat application to handle phone calls via Twilio’s voice services with bidirectional audio conversion, DTMF event handling, and automatic call termination.
Twilio Serializer API Reference
Pipecat’s API methods for Twilio Media Streams integration
Example Implementation
Complete telephony examples with Twilio
Twilio Documentation
Official Twilio Media Streams documentation
Twilio Console
Manage phone numbers and Media Stream configuration
Installation
TheTwilioFrameSerializer
does not require any additional dependencies beyond the core Pipecat library:
Prerequisites
Twilio Account Setup
Before using TwilioFrameSerializer, you need:- Twilio Account: Sign up at Twilio Console
- Phone Number: Purchase a Twilio phone number with voice capabilities
- Media Streams: Configure your phone number to use Media Streams
- Webhook Configuration: Set up webhook endpoints for call handling
Required Environment Variables
TWILIO_ACCOUNT_SID
: Your Twilio Account SID for authenticationTWILIO_AUTH_TOKEN
: Your Twilio Auth Token for API operations
Required Configuration
- Stream SID: Provided by Twilio during Media Stream connection
- Call SID: Required for automatic call termination (optional)
Key Features
- Bidirectional Audio: Convert between Pipecat and Twilio audio formats
- DTMF Handling: Process touch-tone events from callers
- Auto Hang-up: Terminate calls via Twilio’s REST API
- μ-law Encoding: Handle Twilio’s standard audio encoding format