Overview

PlivoFrameSerializer enables integration with Plivo’s Audio Streaming WebSocket protocol, allowing your Pipecat application to handle phone calls via Plivo’s voice services with bidirectional audio conversion, DTMF event handling, and automatic call termination.

Installation

The PlivoFrameSerializer does not require any additional dependencies beyond the core Pipecat library:
pip install "pipecat-ai"

Prerequisites

Plivo Account Setup

Before using PlivoFrameSerializer, you need:
  1. Plivo Account: Sign up at Plivo Console
  2. Phone Number: Purchase a Plivo phone number with voice capabilities
  3. Audio Streaming: Configure your phone number for WebSocket streaming
  4. Webhook Configuration: Set up webhook endpoints for call handling

Required Environment Variables

  • PLIVO_AUTH_ID: Your Plivo Auth ID for authentication
  • PLIVO_AUTH_TOKEN: Your Plivo Auth Token for API operations

Required Configuration

  • Stream ID: Provided by Plivo during Audio Streaming connection
  • Call ID: Required for automatic call termination (optional)

Key Features

  • Bidirectional Audio: Convert between Pipecat and Plivo audio formats
  • DTMF Handling: Process touch-tone events from callers
  • Auto Hang-up: Terminate calls via Plivo’s REST API
  • μ-law Encoding: Handle Plivo’s standard audio encoding format