# SIMCOAI AI-Readable Documentation

SIMCOAI is an AI receptionist and digital front desk platform.

Canonical docs: https://docs.simcoai.co.uk/

## Core Concepts

- Setup AI creates reviewable business profile, AI policy, call-setting and knowledge-base drafts from a natural-language business description.
- Dashboard records are structured: conversations, calls, orders, refunds, bookings, escalations, memories, team members, API keys and notifications.
- API keys are scoped and must be used server-side only.
- Phone numbers require plan enforcement, downstream business traceability and KYC records.
- Refund workflows verify identity with a code sent to the customer email before marking an order as refunded.

## Important URLs

- Getting started: https://docs.simcoai.co.uk/getting-started.html
- Setup AI: https://docs.simcoai.co.uk/setup-ai.html
- Dashboard: https://docs.simcoai.co.uk/dashboard.html
- API: https://docs.simcoai.co.uk/api.html
- Voice/compliance: https://docs.simcoai.co.uk/voice-compliance.html
- Security/billing: https://docs.simcoai.co.uk/security-billing.html
- Deployment: https://docs.simcoai.co.uk/deployment.html
- Troubleshooting: https://docs.simcoai.co.uk/troubleshooting.html

## API Summary

Base URL: `https://api.simcoai.co.uk`

Versioned base URL: `https://api.simcoai.co.uk/v1`

Authentication:

```http
Authorization: Bearer sk_simco_live_REPLACE_ME
```

Common scopes:

- `read`
- `chat`
- `conversations`
- `knowledge`
- `events`
- `escalations`
- `orders:read`
- `orders:write`

Secret API keys must not be placed in browser JavaScript.