voipsimplicity/ai-receptionist.md

# VoIPSimplicity Concierge — AI Phone Receptionist

## Product Overview
An AI-powered phone receptionist add-on for VoIPSimplicity customers. Replaces traditional "Press 1 for..." IVR menus with natural language conversation. Answers calls, routes intelligently, takes messages, and hands off to the right person — all without a human operator.

## How It Works

### For Customers (VoIPSimplicity Clients)
```
Customer dials business number
         ↓
Number forwarded to Twilio (AI Receptionist)
         ↓
STT (Whisper) → "Hi, I need to talk to someone about a bill"
         ↓
LLM (Claude/Gemini) → understands intent
         ↓
AI responds naturally: "Sure, I can help with billing. Let me transfer you..."
         ↓
TTS (ElevenLabs) → speaks back to customer
         ↓
Either: Handles it completely (answer FAQ, take message, book appt)
   Or: Transfers to correct extension via SIP (with context)
```

### Call Flow Detail
```
Inbound Call
    │
    ▼
Twilio answers → connects to AI engine
    │
    ▼
AI Greeting: "Thank you for calling [Business Name]. How can I help you?"
    │
    ├── Customer needs help → AI handles it
    │     • Answers FAQ (hours, location, pricing)
    │     • Takes message (name, number, reason)
    │     • Books appointment (calendar integration)
    │     • Qualifies lead (screening questions)
    │
    ├── Customer needs a person → AI transfers
    │     • Rings correct extension or ring group
    │     • Includes context: "Jane Smith calling about invoice #3042"
    │     • If no answer: takes message or routes to next person
    │
    └── Customer is confused or angry → Escalation
          • AI detects tone → transfers to human immediately
          • No frustrating loops
```

### Benefits Over Traditional IVR
| Traditional IVR | AI Receptionist |
|---|---|
| "Press 1 for Sales, Press 2 for Support..." | "Thanks for calling. How can I help you?" |
| 7 nested menu levels | Single natural conversation |
| Customers mash 0 to get a human | AI routes to human when appropriate |
| DTMF tones only | Understands any phrasing |
| Rigid, frustrating, hard to change | Flexible, warm, updateable in plain English |

## Market Pricing & Positioning

### Competitor Pricing (AI Answering Services Only — No Phone System)
| Service | Starting Price | Type | Best For |
|---|---|---|---|
| AIRA | $24.95/mo | AI only | General small biz |
| Smith.ai | $95/mo | AI + human hybrid | Professional services |
| Abby Connect | $99/mo | AI + human hybrid | Healthcare/legal |
| Posh | $64/mo | AI + human hybrid | Solo practitioners |
| Ruby | $235/mo | Live human | Premium service |
| AnswerConnect | $325/mo | Live human | 24/7 live coverage |

### Proposed Pricing (VoIPSimplicity Add-On)
Priced as an add-on to existing VoIPSimplicity phone service. Customer already has phone system — this replaces their IVR.

| Plan | AI Minutes | Est. Calls | Price/Mo | Our Cost | Margin |
|---|---|---|---|---|---|
| **Starter** | 100 min | ~50 calls | **$29/mo** | ~$2 | **93%** |
| **Pro** | 500 min | ~250 calls | **$79/mo** | ~$10 | **87%** |
| **Business** | 2,000 min | ~1,000 calls | **$199/mo** | ~$40 | **80%** |

Competitive advantage: VoIPSimplicity customers get the **phone system AND AI receptionist** for what AI-only services charge. Pure AI answering services (AIRA) start at $25/mo for 30 calls and don't include a phone system.

### Pricing Strategy Options
| Strategy | Pros | Cons |
|---|---|---|
| **Standalone add-on** ($29-199/mo) | Clear value, easy to sell | Customer sees it as extra cost |
| **Bundled into phone plan tiers** | Feels like value, harder to compare | Lower per-customer revenue |
| **Per-minute billing** ($0.30/min) | Scales naturally | Unpredictable for customer |

## Target Customers (South Georgia)
| Business Type | Number of Employees | Call Volume | Best Plan |
|---|---|---|---|
| Law firm | 1-5 attorneys | 50-200/mo | Pro ($79) |
| Medical/dental office | 2-10 staff | 100-500/mo | Pro/Business |
| Contractor (plumbing, HVAC) | 3-20 crew | 50-300/mo | Pro ($79) |
| Real estate agent | Solo + team | 30-100/mo | Starter ($29) |
| Auto shop | 2-8 mechanics | 50-200/mo | Pro ($79) |
| Restaurant | 5-30 staff | 200-1000/mo | Business ($199) |

## Technical Architecture

### Components
| Component | Technology | Hosting |
|---|---|---|
| Phone Number | Twilio ($1/mo per number) | Cloud |
| Speech-to-Text | Whisper (self-hosted) | app1 |
| AI Engine | Claude Sonnet / Gemini Pro | admin-ai |
| Text-to-Speech | ElevenLabs ($5/mo) | Cloud API |
| Call Logic | FastAPI + WebSockets | app1 |
| Transfer | Twilio SIP → RingLogix → desk phone | Twilio + VoIPSimplicity |

### Call Flow Detail
```
Twilio Number → Twilio Voice Webhook → app1 (FastAPI)
                                         │
                                    Whisper STT
                                         │
                                    LLM (admin-ai)
                                         │
                                    ElevenLabs TTS
                                         │
                                    Response → Twilio → Customer
                                         │
                                    If transfer needed:
                                    Twilio SIP → RingLogix → Extension
```

## Master's Businesses — Testing Plan

### Phase 1: Forefront Wireless (WISP)
- **First Twilio number** — test the AI greeting and call routing
- **Use case:** Customer calls about internet service, billing, outages
- **AI needs:** Hours of operation, service areas, pricing tiers, outage info
- **Fallback:** Route to Germaine's cell or dispatch

### Phase 2: Expand to All Businesses
| Business | Primary Use Case | Call Volume (est.) |
|---|---|---|
| **Forefront Wireless** | Internet inquiries, outages, billing | 30-100/day |
| **VoIPSimplicity** | Phone system sales, support, billing | 20-50/day |
| **Debt Recovery Experts** | Debtor calls, client inquiries | 50-200/day |
| **BoxPilot Logistics** | Dispatch, customer inquiries | 20-60/day |
| **IT Pro Partner** | MSP support, new clients | 10-30/day |

### Phase 3: Productize for VoIPSimplicity Customers
- Package as an add-on for all VoIPSimplicity phone system customers
- Self-service customer portal (customer trains their own AI)
- Billing integrated into VoIPSimplicity invoices

## Implementation Status
| Step | Status |
|---|---|
| Product concept defined | ✅ |
| Market research & pricing | ✅ |
| Twilio numbers to purchase | ⏳ Master purchasing 3-4 numbers |
| Twilio account setup | ⏳ |
| AI engine build (FastAPI + Whisper + LLM) | ❌ |
| RingLogix SIP transfer integration | ❌ |
| Customer portal for config | ❌ |
| Production deployment | ❌ |