Overview
TelnyxFrameSerializer
enables integration with Telnyx’s WebSocket media streaming protocol, allowing your Pipecat application to handle phone calls via Telnyx’s voice services with bidirectional audio conversion, DTMF event handling, and support for multiple audio encodings.
Telnyx Serializer API Reference
Pipecat’s API methods for Telnyx WebSocket integration
Example Implementation
Complete telephony examples with Telnyx
Telnyx Documentation
Official Telnyx media streaming documentation
Telnyx Portal
Manage phone numbers and streaming configuration
Installation
TheTelnyxFrameSerializer
does not require any additional dependencies beyond the core Pipecat library:
Prerequisites
Telnyx Account Setup
Before using TelnyxFrameSerializer, you need:- Telnyx Account: Sign up at Telnyx Portal
- Phone Number: Purchase a Telnyx phone number with voice capabilities
- Media Streaming: Configure your phone number for WebSocket streaming
- Webhook Configuration: Set up webhook endpoints for call handling
Required Environment Variables
TELNYX_API_KEY
: Your Telnyx API key for authentication and call control
Required Configuration
- Stream ID: Provided by Telnyx during WebSocket connection
- Audio Encodings: Configure inbound/outbound encodings (PCMU, PCMA)
- Call Control ID: Required for automatic call termination (optional)
Key Features
- Bidirectional Audio: Convert between Pipecat and Telnyx audio formats
- DTMF Handling: Process touch-tone events from callers
- Auto Hang-up: Terminate calls via Telnyx’s REST API
- Multiple Encodings: Support for PCMU and PCMA audio formats