This project demonstrates how to create a voice bot that can receive phone calls via Twilio and use Daily's SIP capabilities to enable voice conversations.

How It Works

Twilio receives an incoming call to your phone number
Twilio calls your webhook server (/call endpoint)
The server creates a Daily room with SIP capabilities
The server starts the bot process with the room details
The caller is put on hold with music
The bot joins the Daily room and signals readiness
Twilio forwards the call to Daily's SIP endpoint
The caller and bot are connected, and the bot handles the conversation

Prerequisites

A Daily account with an API key
A Twilio account with a phone number that supports voice
OpenAI API key for the bot's intelligence
ElevenLabs API key for text-to-speech (optional but recommended)

Setup

Create a virtual environment and install dependencies

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

Set up environment variables

Copy the example file and fill in your API keys:

cp .env.example .env
# Edit .env with your API keys

Configure your Twilio webhook

In the Twilio console:

Go to your phone number's configuration
Set the webhook for "A Call Comes In" to your server's URL + "/call"
For local testing, you can use ngrok to expose your local server

ngrok http 8000
# Then use the provided URL (e.g., https://abc123.ngrok.io/call) in Twilio

Running the Server

Start the webhook server:

python server.py

Testing

Call your Twilio phone number. The system should answer the call, put you on hold briefly, then connect you with the bot.

Customizing the Bot

You can customize the bot's behavior by modifying the system prompt in bot.py.

Troubleshooting

Call is not being answered

Check that your Twilio webhook is correctly configured
Verify your Twilio account has sufficient funds
Check the logs of both the server and bot processes

Call connects but no bot is heard

Ensure your Daily API key is correct and has SIP capabilities
Check that the SIP endpoint is being correctly passed to the bot
Verify that the ElevenLabs API key and voice ID are correct

Bot starts but disconnects immediately

Check the Daily and Twilio logs for any error messages
Ensure your server has stable internet connectivity