# gOOOvy

> Automatically reply to Google Voice texts when you're away.

- URL: https://gooovy.com
- Privacy Policy: https://gooovy.com/privacy
- Terms of Service: https://gooovy.com/terms

gOOOvy is a subscription SaaS that monitors your Gmail for incoming Google Voice text message notifications and sends automated SMS replies when your out-of-office status is active.

## Features

- **Automatic OOO Replies**: Detects Google Voice texts via Gmail push notifications and sends your configured reply as an SMS
- **Per-Day Schedule**: Set OOO hours for each day of the week with timezone support (US timezones)
- **VIP Contacts**: Configure custom reply messages for specific sender patterns (e.g., boss, key clients)
- **Manual Override**: Toggle OOO on/off manually, bypassing the schedule
- **Activity Log**: View recent auto-replies with sender and timestamp
- **Test Mode**: Send a test email to verify your OOO configuration

## How It Works

1. User subscribes via Stripe ($9/mo or $90/yr)
2. User signs in with Google (OAuth), granting Gmail read + send access
3. Gmail push notifications (via Google Cloud Pub/Sub) trigger a Lambda when new mail arrives
4. Lambda checks if the email is from a Google Voice number (@txt.voice.google.com)
5. If OOO is active and the sender hasn't been replied to recently, an auto-reply is sent via Gmail
6. Google Voice converts the Gmail reply into an SMS response

## Pricing

- Monthly: $9.00/mo
- Yearly: $90.00/yr ($7.50/mo, 17% savings)
- No contracts, cancel anytime
- Payments processed via Stripe

## Technical Architecture

- **Backend**: AWS Lambda (Python 3.11), API Gateway, DynamoDB (single-table design)
- **Auth**: Google OAuth 2.0 (Authorization Code flow)
- **Notifications**: Google Cloud Pub/Sub → Gmail push notifications
- **Payments**: Stripe Checkout, Billing Portal, Webhooks
- **Infrastructure**: AWS CDK (TypeScript)
- **Frontend**: Vanilla HTML/CSS/JS SPA served via Lambda

## API Endpoints

- `GET /` — Landing page / Dashboard SPA
- `POST /webhook` — Gmail Pub/Sub push endpoint
- `GET /api/auth/login` — Google OAuth login
- `GET /api/auth/callback` — OAuth callback
- `GET /api/auth/logout` — Logout
- `GET /api/auth/me` — Current user
- `GET /api/user/status` — User config + OOO state
- `POST /api/user/config` — Update message, schedule, VIP contacts
- `POST /api/user/toggle` — Manual on/off toggle
- `GET /api/user/activity` — Recent auto-replies
- `POST /api/user/test` — Send test email
- `POST /api/billing/checkout` — Create Stripe Checkout session
- `POST /api/billing/portal` — Create Stripe Billing Portal session
- `GET /api/billing/status` — Subscription status
- `POST /api/stripe/webhook` — Stripe webhook events
- `GET /api/admin/users` — Admin: list all users (admin only)
- `DELETE /api/admin/users` — Admin: delete a user (admin only)
- `GET /admin` — Admin panel UI
- `GET /og-image.png` — Social share image

## Requirements

- Google account with active Google Voice number
- Text forwarding to Gmail enabled
- Modern web browser

## Contact

info@plocamium.com