Build Plan: Make Homepage Claims Reality

Detailed implementation guide for all 6 AI platform integrations

Last updated: November 6, 2025 · View high-level roadmap →

🎯 Goal

Build every feature promised on the homepage. No shortcuts, no compromises. Users should be able to use Billing.net with any AI assistant they already have.

Platform Overview

Homepage promises support for 6 platforms:

🍎 Siri Shortcuts - iPhone/Mac users
💬 ChatGPT - Most popular AI
🔊 Alexa - Echo devices
🤖 Google Gemini - Android/Pixel phones
🧠 Claude Desktop - Developer audience
📞 Phone Call - Already works!

🍎 Siri Shortcuts - Complete Implementation

Components to Build

1. [API] Shortcuts Router

File: backend/app/routers/shortcuts.py (NEW)

Create dedicated API endpoints optimized for Siri shortcuts:

POST /api/shortcuts/auth           # Authenticate with phone + PIN
POST /api/shortcuts/create-invoice  # Create invoice
GET  /api/shortcuts/list-invoices   # List recent invoices
POST /api/shortcuts/record-expense  # Log expense
GET  /api/shortcuts/balance         # Get Stripe/Square balance
GET  /api/shortcuts/check-payment   # Check if customer paid

Requirements:

Simple JSON responses (Siri-friendly)
Support both API key and phone+PIN auth
Voice-friendly error messages
Rate limiting per user

Estimated time: 6-8 hours

2. [SIRI] Build 4 Shortcuts

Shortcut 1: "Send Invoice"

1. Ask for customer email
2. Ask for amount
3. Ask for description (optional)
4. Call POST /api/shortcuts/create-invoice
5. Speak confirmation

Shortcut 2: "Check Payments"

1. Call GET /api/shortcuts/list-invoices
2. Filter for unpaid invoices
3. Speak: "You have 3 unpaid invoices totaling $8,400"

Shortcut 3: "Record Expense"

1. Ask for amount
2. Ask for merchant
3. Ask for project (optional)
4. Call POST /api/shortcuts/record-expense
5. Speak confirmation

Shortcut 4: "My Balance"

1. Call GET /api/shortcuts/balance
2. Speak: "Your Stripe balance is $12,450"

Estimated time: 8-10 hours (2-3 hours per shortcut)

3. [WEB] Siri Setup Page

File: web/app/siri/page.tsx (NEW)

Content:

Step-by-step setup guide
Download links for each shortcut
Video tutorial
How to get API key from dashboard
FAQ and troubleshooting

Estimated time: 4-5 hours

4. [WEB] API Key Dashboard

File: web/app/dashboard/api-keys/page.tsx (NEW)

Features:

Generate API keys for shortcuts
Show key once (security)
Revoke keys
See key usage stats
Copy to clipboard button

Estimated time: 3-4 hours

5. [API] API Key Management

File: backend/app/routers/api_keys.py (NEW)

Endpoints:

POST /api-keys/generate - Generate new API key
GET /api-keys/list - List user's keys
DELETE /api-keys/{key_id} - Revoke key

Estimated time: 2-3 hours

6. [DB] Database Migration

File: backend/migrations/add_api_keys_table.py

Create api_keys table with columns:

id, user_id, key_hash, key_suffix
created_at, last_used_at, revoked

Estimated time: 1 hour

Siri Total Time: 24-33 hours (3-4 days)

💬 ChatGPT Custom GPT - Complete Implementation

Components to Build

1. [CHATGPT] Create Custom GPT

Platform: ChatGPT Custom GPT Editor

Steps:

Go to https://chat.openai.com/gpts/editor
Create new GPT: "Billing.net Assistant"
Add instructions for invoicing, expense tracking
Link OpenAPI spec
Configure OAuth authentication
Test and publish

Estimated time: 2-3 hours

2. [API] OpenAPI Spec

File: web/public/openapi.json

Create comprehensive OpenAPI 3.0 spec with:

All invoice endpoints
Expense tracking endpoints
Balance checking
OAuth configuration
ChatGPT-friendly descriptions

Estimated time: 2-3 hours

3. [WEB] ChatGPT Setup Page

File: web/app/chatgpt/page.tsx (NEW)

Content:

Link to install custom GPT
OAuth authorization steps
Usage examples
Video demo

Estimated time: 3-4 hours

4. [API] OAuth Endpoints

Configure OAuth for ChatGPT GPT actions:

GET /oauth/authorize - Start OAuth flow
POST /oauth/token - Exchange code for token

Estimated time: 2-3 hours

ChatGPT Total Time: 11-16 hours (1.5-2 days)

🧠 Claude MCP - Complete Implementation

Components to Build

1. [MCP] Add MCP Tools

File: backend/app/mcp_server_app.py (enhance existing)

Tools to add:

create_invoice - Create invoice in user's account
list_invoices - List recent invoices
record_expense - Log expense to QuickBooks
check_balance - Get Stripe/Square balance

Estimated time: 6-8 hours

2. [MCP] Multi-Tenant Support

Add per-user credential lookup:

Identify which user is calling MCP tools
Look up their OAuth credentials
Use their Stripe/QB/Square account

Estimated time: 4-6 hours

3. [WEB] Claude Setup Page

File: web/app/claude/page.tsx (NEW)

Content:

Install Claude Desktop instructions
Add MCP server to config file
Usage examples
Troubleshooting

Estimated time: 3-4 hours

Claude MCP Total Time: 15-21 hours (2-3 days)

🔊 Alexa Skill & 🤖 Google Assistant

Alexa Skill

Platform: Amazon Alexa Developer Console
Time: 21-33 hours + certification
Complexity: HIGH (Amazon review process)

Google Assistant Action

Platform: Google Actions Console
Time: 12-18 hours + review
Complexity: HIGH (Google review process)

📊 Complete Timeline

Phase	Platform	Time	Priority
Week 1-2	🍎 Siri Shortcuts	24-33 hours	CRITICAL
Week 2-3	💬 ChatGPT	11-16 hours	HIGH
Week 3-4	🧠 Claude MCP	15-21 hours	MEDIUM
Week 4-5	🔊 Alexa	21-33 hours	MEDIUM
Week 5-6	🤖 Google	12-18 hours	MEDIUM

🎯 Recommended Start Order

This Week: Foundation

1. Siri API endpoints (6-8 hrs) - Foundation for all shortcuts
2. First Siri shortcut (2-3 hrs) - "Send Invoice"
3. API key system (5-6 hrs) - Auth for shortcuts

Total: 13-17 hours = Can complete this week

Next Week: Complete Siri

1. Remaining 3 shortcuts (6-9 hrs)
2. Siri setup page (4-5 hrs)
3. Start ChatGPT GPT (2-3 hrs)

✅ Success Criteria

Week 1: User can say "Hey Siri, send invoice" and it works
Week 2: All 4 Siri shortcuts working, 10 users testing
Week 4: ChatGPT GPT live, 50+ users across platforms
Week 6: All AI platforms live, homepage claims 100% true

Ready to Start Building?

View high-level roadmap or dive into implementation

API Documentation View on GitHub

Last updated: November 6, 2025

Questions? mike@billing.net · (970) 645-3365