Initial commit — 2026-07-15

twilio-setup.md

@@ -0,0 +1,79 @@
+# Twilio Setup & Testing Plan — AI Receptionist
+
+## Numbers to Purchase
+
+| Business | Number Purpose | Est. Monthly Calls |
+|---|---|---|
+| **Forefront Wireless** | Customer support, outages, billing | 30-100/day |
+| **VoIPSimplicity** | Phone system sales & support | 20-50/day |
+| **Debt Recovery Experts** | Debtor calls, client intake | 50-200/day |
+| **BoxPilot / IT Pro Partner** | General business | 10-30/day |
+
+**Total: 3-4 Twilio numbers** at ~$1/mo each.
+
+## Twilio Account Setup (Master Action)
+
+### Recommended Account Type
+- For Garrison texting: **Individual** (already mentioned)
+- For DRE/Apex numbers: **Business** (will need business docs)
+- For VoIPSimplicity numbers: **Business** (under VoIPSimplicity LLC)
+
+### What You'll Need
+1. Create account at [twilio.com](https://www.twilio.com)
+2. Add billing info (credit card or ACH — you prefer ACH)
+3. Search for available numbers in **South Georgia area codes** (912 for Savannah, 229 for Albany/Valdosta, 478 for Macon)
+4. Purchase local numbers (toll-free is optional, ~$2/mo)
+
+### What I Need After Purchase
+When you have the numbers, I need:
+- **Twilio Account SID** (starts with AC...)
+- **Twilio Auth Token**
+- **Phone numbers** (the actual digits)
+- For each number: which business it's for
+
+Store these in Vaultwarden → send them to me when ready.
+
+## Phase 1 — Testing with Forefront Wireless
+
+### Test Scenarios
+| Scenario | Customer Says | Expected AI Behavior |
+|---|---|---|
+| Business hours | "When are y'all open?" | Responds with hours for that location |
+| Service inquiry | "Do you have internet in the county?" | Checks coverage area, responds or transfers |
+| Outage call | "My internet's down" | Asks for account/address, checks status, routes to support |
+| Billing | "I need to pay my bill" | Takes payment info or routes to billing |
+| New customer | "How much is internet?" | Gives pricing tiers, routes to sales if interested |
+| Spanish | "Hablo español" | Switches to Spanish automatically |
+
+### Cutover Plan
+```
+1. Purchase Twilio number
+2. Set up forwarding from existing Forefront number to Twilio number
+3. Test AI handles calls
+4. Refine prompts and routing based on real calls
+5. Once stable → update published number's forwarding permanently
+```
+
+## Development Milestones
+
+| Milestone | What's Needed | ETA |
+|---|---|---|
+| Twilio numbers purchased | You | Today |
+| FastAPI AI engine built | Me | After numbers are ready |
+| Basic call flow working | Both | Day 1 of testing |
+| RingLogix transfer integration | Both | Day 2-3 |
+| Production-ready for one business | Both | Week 1 |
+| Add second business | Both | Week 2 |
+
+## Cost Breakdown (Per Business)
+
+| Item | Monthly Cost |
+|---|---|
+| Twilio phone number | $1 |
+| Twilio call handling (~500 min) | ~$10 |
+| ElevenLabs TTS | $5 |
+| Whisper STT (self-hosted) | $0 |
+| LLM inference (via admin-ai) | ~$1-2 |
+| **Total per business** | **~$17-20/mo** |
+| **Planned sell price** | **$29-199/mo** |
+| **Margin** | **80-93%** |