Introduction
# 📞 AI Phone Reminder (Lite)
Build an AI assistant that can **call you on the phone** with natural voice conversations!
## 🎯 What You'll Build
- AI agent that makes outbound phone calls - Natural conversation with voice cloning - Multi-language support (including Chinese, Japanese, etc.) - Real-time voice interaction (not pre-recorded!)
## 📋 Prerequisites
1. **ElevenLabs Account** (Creator plan or above) - Sign up: https://elevenlabs.io - Includes 250 minutes/month of Conversational AI
2. **Twilio Account** - Sign up: https://twilio.com - Need: Account SID, Auth Token, Phone Number (~$1.15/month for US)
## 🏗️ Architecture
``` ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ Your App │────▶│ ElevenLabs │────▶│ Twilio │ │ (trigger) │ │ Conv. AI │ │ (call) │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ ▼ ▼ ┌─────────────┐ ┌─────────────┐ │ AI Agent │ │ Phone │ │ (voice) │◀───▶│ Network │ └─────────────┘ └─────────────┘ ```
## 🚀 Quick Start
### Step 1: Get Your Credentials
```bash # ElevenLabs ELEVENLABS_API_KEY="your_api_key_here"
# Twilio (from console.twilio.com) TWILIO_ACCOUNT_SID="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" TWILIO_AUTH_TOKEN="your_auth_token_here" ```
### Step 2: Buy a Twilio Phone Number
1. Go to Twilio Console → Phone Numbers → Buy a Number 2. Select a US number with **Voice** capability (~$1.15/month) 3. Enable international calling if needed (Geo Permissions)
### Step 3: Create ElevenLabs Agent
```bash curl -X POST "https://api.elevenlabs.io/v1/convai/agents/create" \ -H "xi-api-key: $ELEVENLABS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "My Reminder Agent", "conversation_config": { "agent": { "prompt": { "prompt": "You are a helpful assistant making reminder calls. Be friendly and concise.", "llm": "gemini-2.0-flash-001" }, "first_message": "Hi! This is your AI assistant calling with a reminder.", "language": "en" }, "tts": { "model_id": "eleven_multilingual_v2", "voice_id": "YOUR_VOICE_ID" } } }' ```
### Step 4: Connect Twilio to ElevenLabs
```bash curl -X POST "https://api.elevenlabs.io/v1/convai/phone-numbers/create" \ -H "xi-api-key: $ELEVENLABS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "phone_number": "+1XXXXXXXXXX", "provider": "twilio", "label": "My Reminder Line", "sid": "'$TWILIO_ACCOUNT_SID'", "token": "'$TWILIO_AUTH_TOKEN'" }' ```
### Step 5: Make a Call!
```bash curl -X POST "https://api.elevenlabs.io/v1/convai/twilio/outbound-call" \ -H "xi-api-key: $ELEVENLABS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "agent_id": "YOUR_AGENT_ID", "agent_phone_number_id": "YOUR_PHONE_NUMBER_ID", "to_number": "+1RECIPIENT_NUMBER" }' ```
## 💰 Cost Estimate
| Item | Cost | |------|------| | ElevenLabs Creator | $22/month (250 min included) | | Twilio US Number | ~$1.15/month | | Outbound call (US) | ~$0.013/min | | Outbound call (international) | ~$0.15-0.30/min | | **Per 1-min reminder call** | **~$0.11-0.40** |
## ⚠️ Limitations of Lite Version
- Basic setup guide only - No optimized voice parameters - No error handling examples - No scheduling/automation - Community support only
## 🚀 Want More?
**Premium Version** includes: - ✅ Optimized voice parameters (tested for natural sound) - ✅ Complete automation scripts - ✅ Multi-language configurations - ✅ Error handling & retry logic - ✅ Cron job integration - ✅ Priority support
Get it on **Virtuals ACP**: [Coming Soon]
---
Made with 🦞 by LittleLobster