LiveKit IVR with DTMF

Build an IVR (Interactive Voice Response) menu in LiveKit that responds to both voice commands and keypad presses (DTMF tones).

View on GitHub

Clone and run the full working example

Getting started

git clone https://github.com/vobiz-ai/Vobiz-Livekit-IVR-DTMF-Example.git
cd Vobiz-Livekit-IVR-DTMF-Example
pip install -r requirements.txt
python agent.py dev

Overview

Some callers are in noisy environments or prefer pressing keys over speaking. This example shows how to build a LiveKit agent that handles both speech input and DTMF keypad input simultaneously - providing a reliable IVR experience for all callers.

How it works

The agent presents menu options via text-to-speech.
The agent listens for both speech (“press 1 for billing”) and DTMF tones.
Whichever is detected first triggers the routing logic.
The appropriate sub-menu or action is invoked.

"Welcome. Press 1 for Sales, 2 for Support, 3 for Billing, or say the department name."

or "sales"   → Sales agent
or "support" → Technical Support agent
or "billing" → Billing department
or "operator" → Human agent transfer

DTMF detection

LiveKit forwards DTMF tones from the SIP leg through the SIP INFO method. The agent subscribes to DTMF events on the room and maps digits to menu choices.

@ctx.room.on("dtmf_received")
def on_dtmf(digit: str):
    if digit == "1":
        route_to_sales()
    elif digit == "2":
        route_to_support()
    elif digit == "3":
        route_to_billing()

Environment variables

.env

LIVEKIT_URL=wss://your-project.livekit.cloud
LIVEKIT_API_KEY=APIxxxxxxxxxxxxx
LIVEKIT_API_SECRET=secretxxxxxxxxxx
OPENAI_API_KEY=sk-...
SALES_NUMBER=+919XXXXXXXXX
SUPPORT_NUMBER=+919XXXXXXXXX
BILLING_NUMBER=+919XXXXXXXXX
HUMAN_AGENT_NUMBER=+919XXXXXXXXX

Guides

LiveKit Templates

Server Templates

Industries

Compare Platforms

LiveKit IVR with DTMF

View on GitHub

Getting started

Overview

How it works

IVR menu structure

DTMF detection

Environment variables

View on GitHub

​Getting started

​Overview

​How it works

​IVR menu structure

​DTMF detection

​Environment variables

Getting started

Overview

How it works

IVR menu structure

DTMF detection

Environment variables