ringbot

name	ringbot
description	Make outbound AI phone calls. Use when asked to call a business, make a phone call, order food by phone, schedule appointments, or any task requiring voice calls. Triggers on "call", "phone", "dial", "ring", "order pizza", "make reservation", "schedule appointment".

RingBot - AI Phone Calls

Make outbound phone calls with an AI voice agent that can have natural conversations.

💰 Why RingBot? (99% Cheaper Voice AI)

Traditional Voice AI costs: $0.10-0.50/minute (ElevenLabs, PlayHT, etc.) RingBot costs: ~$0.01/minute (just Twilio phone costs!)

Component	Provider	Cost
STT (Speech-to-Text)	Groq Whisper	FREE
LLM (AI Brain)	Groq Llama 3.3 70B	FREE
TTS (Text-to-Speech)	Groq Orpheus	FREE
Voice Infrastructure	LiveKit Cloud	FREE tier
Phone Calls	Twilio	~$0.01/min

You only pay for actual phone minutes through Twilio.

📦 Two Ways to Use RingBot

Option 1: DIY (Free - Bring Your Own Keys)

Set up your own infrastructure - completely free except Twilio phone costs.

Required accounts:

1. Twilio - https://twilio.com

   • Phone number ($1/month) + calls ($0.01/min)
   • Get: TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_PHONE_NUMBER

2. LiveKit Cloud - https://cloud.livekit.io (free tier)

   • Create project + SIP trunk connected to Twilio
   • Get: LIVEKIT_URL, LIVEKIT_API_KEY, LIVEKIT_API_SECRET, LIVEKIT_SIP_TRUNK_ID

3. Groq - https://console.groq.com (100% free)

   • Get API key + accept TTS terms: https://console.groq.com/playground?model=canopylabs%2Forpheus-v1-english
   • Get: GROQ_API_KEY

# .env for DIY setup
TWILIO_ACCOUNT_SID=your_sid
TWILIO_AUTH_TOKEN=your_token
TWILIO_PHONE_NUMBER=[phone]
LIVEKIT_URL=wss://your-project.livekit.cloud
LIVEKIT_API_KEY=your_key
LIVEKIT_API_SECRET=your_secret
LIVEKIT_SIP_TRUNK_ID=your_trunk_id
GROQ_API_KEY=your_groq_key

Option 2: Hosted (Paid - Just Bring Twilio)

Don't want to set up LiveKit and Groq? Use our hosted infrastructure.

• ✅ No LiveKit setup needed
• ✅ No Groq setup needed
• ✅ Just connect your Twilio account
• 💰 Pay per minute + rate limits apply

Coming soon - Contact for early access: https://talkforceai.com

🚀 Use Cases

1. Order Food by Phone

"Call DeLuca's Pizza and order a large pepperoni for pickup under Greg"

2. Make Reservations

"Call the restaurant and make a reservation for 4 people Saturday at 7pm"

3. Schedule Appointments

"Call Dr. Smith's office and schedule my annual checkup for next week morning"

4. Customer Service Calls

"Call Comcast and ask about upgrading my internet plan"

5. Personal Messages

"Call mom and tell her I love her and ask how her day was"

6. Business Lead Qualification

"Call this list of leads and ask if they're interested in our parking solutions"

7. Automated Daily Calls

"Every morning at 9am, call the warehouse and check inventory status"

8. Appointment Reminders

"Call patients and remind them of their appointments tomorrow"

Making a Call

curl -X POST http://localhost:8000/ringbot/call \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+1XXXXXXXXXX",
    "purpose": "Brief description of call objective",
    "context": "Additional context the AI should know"
  }'

Parameters:

• to - Phone number in E.164 format (+1XXXXXXXXXX)
• purpose - What the call is about (guides AI behavior)
• context - Background info, specific requests, what to collect

Example: Order Pizza

Step 1: Find the restaurant

goplaces search "pizza" --lat 41.36 --lng="-72.56" --limit 3

Step 2: Get phone number

goplaces details ChIJRdQwYs4v5okRY2gp8pgskJ0
# Phone: [phone]

Step 3: Make the call

curl -X POST http://localhost:8000/ringbot/call \
  -H "Content-Type: application/json" \
  -d '{
    "to": "[phone]",
    "purpose": "Order a pizza for pickup",
    "context": "Order: 1 large pepperoni pizza. Customer name: Greg. Ask for pickup time and total."
  }'

Tips for Good Results

Purpose - Keep it to one clear sentence:

• ✅ "Order a pizza for pickup"
• ✅ "Schedule a dental cleaning"
• ❌ "Call them and maybe order something or ask questions"

Context - Be specific:

• Customer/caller name
• Exact order or request
• Preferences and constraints
• What info to collect back

Service Management

Start the agent:

cd /path/to/ringbot/src && python agent.py start

Start the API:

cd /path/to/ringbot && python main.py

Check call status:

curl http://localhost:8000/ringbot/call/{call_id}