Initial commit — 2026-07-15

2026-07-15 17:32:03 -04:00
commit 344ea2ea20
6 changed files with 684 additions and 0 deletions
@@ -0,0 +1,161 @@
+# 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 | ❌ |