# SimpleSupport

> Simple, fast, and easy-to-integrate customer support for small businesses and micro-SaaS.

## What is SimpleSupport?

SimpleSupport is a lightweight helpdesk system that lets any business add professional customer support to their website with a single line of code. It runs on Cloudflare Workers (edge serverless) for global response times under 50ms with zero cold starts.

## Key features

- Ticket system with statuses (open, in_progress, resolved, closed) and priorities (low, medium, high)
- Embeddable JS widget: one script tag, under 5KB gzipped
- Admin panel for managing tickets, replies, agents, and settings
- Email notifications for customers and agents via SendGrid
- REST API for programmatic integration
- GDPR compliant by default: no cookies, no tracking, no consent banner needed
- Multi-tenant: each business gets an isolated account with its own API key
- Teams and departments for ticket routing (Pro plan)
- Email gateway: customers create tickets by emailing support@yourcompany.com (Pro plan)
- Custom domain and white label (Business plan)

## Integration

Add the widget to any website:

```html
<script src="https://cdn.simplesupport.uk/widget.js" data-key="YOUR_API_KEY"></script>
```

Works with: WordPress, Jekyll, Hugo, Next.js, React, Webflow, Shopify, or any website that accepts a script tag.

## API

Base URL: https://app.simplesupport.uk

Authentication: `Authorization: Bearer YOUR_API_KEY`

### Public ticket endpoints

- POST /api/tickets: Create a ticket (customer-facing)
- GET /api/tickets: List tickets for this API key
- GET /api/tickets/:id: Get ticket detail with messages
- POST /api/tickets/:id/messages: Reply to a ticket (customer or agent)
- PATCH /api/tickets/:id: Update status or priority

### Admin panel endpoints (session cookie required)

- POST /api/auth/register: Register a new tenant and admin agent
- POST /api/auth/login: Login and get session cookie
- POST /api/auth/logout: Clear session
- POST /api/auth/forgot-password: Send password reset email
- POST /api/auth/reset-password: Reset password with token
- GET /api/admin/dashboard: Stats summary (open, in_progress, resolved today, by_day)
- GET /api/admin/tickets: List tickets with filters (status, priority, search, date range, cursor)
- GET /api/admin/tickets/:id: Ticket detail with messages
- POST /api/admin/tickets/:id/messages: Agent reply
- PATCH /api/admin/tickets/:id: Update status, priority, assigned agent
- GET /api/admin/agents: List agents for this tenant
- POST /api/admin/agents: Invite a new agent
- GET /api/admin/settings: Get tenant settings and API key
- PATCH /api/admin/settings: Update name, domain, widget colors and position

### Widget

- GET /widget/script: Serve widget JS (public)
- GET /widget/styles: Serve widget CSS (public)
- GET /widget/config: Get tenant config for widget (Bearer auth)

## Data model

- Tenant: id, name, domain, plan (starter/pro/business), api_key, settings (JSON)
- Agent: id, tenant_id, email, name, role (admin/agent), password_hash
- Ticket: id, tenant_id, customer_email, customer_name, subject, status, priority, source (widget/email/api), assigned_agent_id
- Message: id, ticket_id, sender_type (customer/agent), sender_id, body

## Pricing

- Starter (free): 1 agent, 100 tickets/month, widget with SimpleSupport branding
- Pro (15 EUR/month): 5 agents, 1000 tickets/month, email gateway, teams, no branding
- Business (39 EUR/month): unlimited agents and tickets, custom domain, white label, analytics

## Links

- Website: https://simplesupport.uk
- Dashboard: https://dashboard.simplesupport.uk
- API: https://app.simplesupport.uk
- Docs: https://simplesupport.uk/docs.html
- Pricing: https://simplesupport.uk/pricing.html