# SIMCOAI Documentation

Customer documentation for SIMCOAI, the UK AI receptionist and AI front desk from SIMCOAI LTD (company number 17247747), co-founded by Isaac Green and Kairav Mittal.

Every URL below is published and live. Do not invent features, pricing, endpoints or capabilities that are not described here.

## API facts

- Base URL: https://api.simcoai.co.uk/v1
- Endpoints: GET /me, GET /signature-example, POST /chat, GET|POST /{table}, GET|PATCH /{table}/{id}
- Tables: orders, refunds, bookings, escalations
- Scopes: read, write, chat:write
- Auth header: X-SIMCOAI-API-Key
- Webhook signature: HMAC-SHA256 in X-SIMCOAI-Signature; verify against the RAW body
- Success envelope: {success, data, message, requestId, timestamp}
- Failure envelope: {success:false, data:null, message, details, requestId}
- Error codes: SIMCOAI_RESOURCE_NOT_FOUND (404), WORKFLOW_DUPLICATE (409), SIMCOAI_ORDER_NUMBER_REQUIRED (422), SIMCOAI_ESCALATION_REASON_REQUIRED (422)
- 409 WORKFLOW_DUPLICATE means the work already exists and should be treated as success, not retried.
- SIMCOAI never auto-approves a refund; a person reviews every workflow outcome.

## Guides

### Start
- [Overview](https://simcoai.co.uk/docs/): Complete documentation for the SIMCOAI AI receptionist: setup, phone, chat, workflows, API, billing and troubleshooting.
- [Getting Started](https://simcoai.co.uk/docs/getting-started): Create your SIMCOAI account, add your business information, configure the AI receptionist and run your first test call before customers ring.
- [Setup Wizard](https://simcoai.co.uk/docs/setup-wizard): Use the SIMCOAI guided setup assistant to configure services, opening hours, policies and escalation rules step by step before you go live.
- [Quickstart Checklist](https://simcoai.co.uk/docs/quickstart-checklist): A condensed 30-minute checklist to get a SIMCOAI AI receptionist answering calls, covering the minimum required configuration.
- [Glossary](https://simcoai.co.uk/docs/glossary): Plain-English definitions of every SIMCOAI term: workflows, escalations, proof uploads, verification codes, relay, usage limits.

### Phone and voice
- [AI Phone Reception](https://simcoai.co.uk/docs/phone): Configure phone numbers, greetings, opening hours, transfers and call logging for the SIMCOAI AI receptionist that answers on your behalf.
- [Phone Numbers](https://simcoai.co.uk/docs/phone-numbers): Search, buy and verify phone numbers inside SIMCOAI, including compliance bundles and address checks, and what each purchase error actually means.
- [Phone Profiles](https://simcoai.co.uk/docs/phone-profiles): Give each SIMCOAI number its own greeting, voice, purpose and routing, with worked examples for a refunds line, a bookings line and an account help line.
- [Voices and Speech](https://simcoai.co.uk/docs/voices): The SIMCOAI voices by name - SIMCOAI Voice Rapid, Natural, Studio and Signature - and the SIMCOAI Speech engines that listen (Speech Live, Speech Precise, Speech Standard).
- [Live Call Monitor](https://simcoai.co.uk/docs/live-calls): Follow calls as they happen, read the live transcript, speak to the caller, escalate or end a call, and read call quality signals.
- [Call Quality Signals](https://simcoai.co.uk/docs/call-quality): Understand the call quality signals SIMCOAI records on every call: first reply latency, caller turns, interim results, interruption handling and finish reasons.
- [Call Transfers](https://simcoai.co.uk/docs/call-transfers): Configure transfer numbers and routing, what the caller hears during a hand-off, and how to stop transfers landing on a number nobody answers.
- [Voicemail and After Hours](https://simcoai.co.uk/docs/voicemail): What SIMCOAI does outside your opening hours, the out-of-hours options available, and why urgent categories should not rely on an AI front desk to triage.

### AI chat
- [AI Chat](https://simcoai.co.uk/docs/ai-chat): Configure the SIMCOAI AI chat assistant to answer website and message enquiries from your own business information rather than generic guesses.
- [Knowledge and Documents](https://simcoai.co.uk/docs/knowledge-base): Give the AI the services, hours, policies and FAQs it answers from, how to write knowledge it can actually use, and how to keep it from going stale.
- [AI Models](https://simcoai.co.uk/docs/ai-models): The SIMCOAI models by name - SIMCOAI Lite, Swift, Core, Insight and Live - what each is for, how the profile and routing choice is made, and how model choice shows up on your bill.
- [Prompts and Tone](https://simcoai.co.uk/docs/prompts-and-tone): Set the greeting, tone and disclosure your AI receptionist uses, the boundaries of what it may say, and how to test how it sounds before customers hear it.

### Workflows
- [Workflows Overview](https://simcoai.co.uk/docs/workflows): How SIMCOAI turns a call or chat into a trackable refund, booking, order query or escalation, what every record carries, and the decisions it leaves to you.
- [Refunds](https://simcoai.co.uk/docs/refunds): How SIMCOAI captures refund requests with verification and evidence, what a refund record contains, and why a person always makes the final decision.
- [Bookings](https://simcoai.co.uk/docs/bookings): Capture appointment requests with the service, time, contact details and notes your team needs, and understand the difference between captured and confirmed.
- [Order Support](https://simcoai.co.uk/docs/orders): Sync orders into SIMCOAI so the AI can answer status questions from real data, and capture anything it cannot resolve as work for your team.
- [Escalations](https://simcoai.co.uk/docs/escalations): How complaints, safety, medical, legal and payment topics reach a person instead of the AI, plus adding escalation triggers specific to your business.
- [Customer Database](https://simcoai.co.uk/docs/customers): Keep one record per customer, matched on email or phone, so SIMCOAI recognises whoever is calling and stops asking for details you already hold. Add customers by hand or import a CSV, with custom fields and the API.
- [Proof Uploads](https://simcoai.co.uk/docs/proof-uploads): Send a one-off secure link so customers can upload photos, receipts and documents against a refund or order, and why evidence checks never auto-approve.
- [Verification Codes](https://simcoai.co.uk/docs/verification-codes): How SIMCOAI verification codes confirm a customer before a refund, booking or escalation is actioned, and why verifying a request never approves it automatically.

### Dashboard
- [Dashboard Tour](https://simcoai.co.uk/docs/dashboard): A walkthrough of every SIMCOAI dashboard module - home, calls, workflows, intelligence, growth, platform and account - and what each one is for.
- [Statistics and Analytics](https://simcoai.co.uk/docs/statistics): Read call volume, outcomes, escalation rate and quality trends, with the question worth asking of each measure and a warning about small samples.
- [Usage and Limits](https://simcoai.co.uk/docs/usage-limits): What SIMCOAI meters against your plan, where to watch consumption, and what happens at a limit with and without pay-as-you-go enabled on your account.
- [Health Checks](https://simcoai.co.uk/docs/health-checks): Run readiness checks on your number, voice, models, billing and workflows before real customers ring, and know why a test call still matters afterwards.
- [Customising the Dashboard](https://simcoai.co.uk/docs/customize): Change dashboard theme, density and visible modules, sync those choices across devices, and understand why hiding a module is not a permission control.

### Integrations and API
- [Integrations](https://simcoai.co.uk/docs/integrations): Connect SIMCOAI to your existing systems using webhooks and the workflow API, so refunds, bookings and orders reach the tools your team already uses.
- [API Reference](https://simcoai.co.uk/docs/api): The authenticated SIMCOAI API with request and response examples for orders, refunds, bookings and escalations, plus signing and error handling.
- [API Authentication](https://simcoai.co.uk/docs/api-authentication): Authenticate against the SIMCOAI API with the X-SIMCOAI-API-Key header, retry safely using idempotency keys, and follow the rules for storing and rotating keys.
- [Webhooks](https://simcoai.co.uk/docs/webhooks): Receive SIMCOAI workflow events in your own systems: available event types, delivery format, and how to handle retries and duplicates using the delivery id.
- [API Overview](https://simcoai.co.uk/docs/api-overview): The complete SIMCOAI public API surface: base URL, the four resource tables, the shared response envelope and where to go next.
- [API Errors](https://simcoai.co.uk/docs/api-errors): Every SIMCOAI API error code with its HTTP status, what causes it and exactly how your integration should respond to each one.
- [Rate Limits](https://simcoai.co.uk/docs/api-rate-limits): How SIMCOAI applies API rate limits per account, what a 429 means, and how to back off correctly without making the limit worse.
- [Idempotency](https://simcoai.co.uk/docs/api-idempotency): Use idempotency keys and server-side duplicate prevention so a network retry cannot turn one customer request into two refunds.
- [cURL Examples](https://simcoai.co.uk/docs/api-examples-curl): Copy-paste cURL requests for every public SIMCOAI endpoint, with the expected response for each and what a failure looks like when something is wrong.
- [Node.js Examples](https://simcoai.co.uk/docs/api-examples-node): A minimal Node.js SIMCOAI client covering authentication, retries, duplicate handling and constant-time webhook signature verification.

### Billing
- [Billing and Plans](https://simcoai.co.uk/docs/billing): SIMCOAI plans, billing periods and Stripe checkout: what each plan includes, how the 7-day trial works, where invoices live and how VAT is handled.
- [Add-ons](https://simcoai.co.uk/docs/addons): Extend your SIMCOAI plan with add-ons: extra phone numbers, additional voices, token packs and optional capabilities, and how each one is billed.
- [Trials](https://simcoai.co.uk/docs/trials): How the SIMCOAI 7-day trial works, what happens when it ends, how to cancel before the first charge, and what is retained on your account afterwards.
- [PAYG Overages](https://simcoai.co.uk/docs/payg-overages): What happens when you pass a plan allowance, how pay-as-you-go overage differs from a hard stop, and how to keep spend predictable.
- [Cancelling](https://simcoai.co.uk/docs/cancellation): How to cancel a SIMCOAI subscription, release phone numbers, revoke API keys, and what happens to your workspace afterwards.
- [Invoices and Tax](https://simcoai.co.uk/docs/invoices-and-tax): Where to find SIMCOAI invoices, how to add company billing details and VAT numbers before your first invoice, and how tax is applied at checkout.

### Platform
- [Platform Overview](https://simcoai.co.uk/docs/platform): How the SIMCOAI platform fits together - reception, workflows, dashboard, integrations - and the managed providers behind calls, voice and payments.
- [Account Security](https://simcoai.co.uk/docs/account-security): Compare SIMCOAI sign-in methods - passkeys, authenticator apps, passwords, Google and magic links - and which to use for an account that spends money.
- [Data Handling](https://simcoai.co.uk/docs/data-handling): What SIMCOAI stores on your behalf, who can see it, platform protection, and the compliance responsibilities that remain yours.
- [API Key Security](https://simcoai.co.uk/docs/api-key-security): Rules for handling SIMCOAI API keys, what each scope permits, and exactly what to do first if a key is ever exposed or committed by mistake.
- [Security](https://simcoai.co.uk/docs/security): How SIMCOAI protects account access with passkeys and multi-factor authentication, how customer data is handled, and what your team controls.
- [Deployment](https://simcoai.co.uk/docs/deployment): Move SIMCOAI from testing to answering real customer calls, with the checks to run beforehand and what to watch in your first day of live traffic.
- [Status and Uptime](https://simcoai.co.uk/docs/status-and-uptime): Read the SIMCOAI status page, tell a platform incident apart from a problem in your own setup, and know what to include when reporting something.

### Support
- [Login Problems](https://simcoai.co.uk/docs/troubleshooting-login): Fix SIMCOAI sign-in failures: rejected passwords, magic links that never arrive or expire, passkey prompts, authenticator codes and Google login loops.
- [Call Problems](https://simcoai.co.uk/docs/troubleshooting-calls): Diagnose calls that are not answered, an AI that repeats itself or misses order numbers, slow replies, and topics that should have escalated.
- [Number Problems](https://simcoai.co.uk/docs/troubleshooting-numbers): What each phone number purchase error means, including bundle not ready, address mismatch, capacity reached and numbers already assigned.
- [Billing Problems](https://simcoai.co.uk/docs/troubleshooting-billing): Fix SIMCOAI checkout that will not open, declined cards, plans that have not activated after payment, and add-ons showing as inactive.
- [API Problems](https://simcoai.co.uk/docs/troubleshooting-api): What every failing SIMCOAI API status code means in practice, how to triage with GET /v1/me, and which failures are safe to retry.
- [Webhook Problems](https://simcoai.co.uk/docs/troubleshooting-webhooks): Fix SIMCOAI webhook signature failures caused by re-serialised bodies, missing deliveries, duplicate events and out-of-order arrival.
- [Troubleshooting](https://simcoai.co.uk/docs/troubleshooting): Diagnose and fix the most common SIMCOAI problems across calls, chat, phone numbers, billing and integrations, and know when to contact support.
- [FAQ](https://simcoai.co.uk/docs/faq): Short answers to the questions SIMCOAI customers ask most about calls, plans, data handling, AI behaviour, escalations and getting support.
- [Reviews](https://simcoai.co.uk/docs/reviews): How SIMCOAI asks for reviews, what the verified customer marker means, how reviews are moderated, and how to have yours changed or removed.
- [Changelog](https://simcoai.co.uk/docs/changelog): Every SIMCOAI release and what changed, with links to the documentation guides updated alongside each entry so features and docs stay in step.
- [Contacting Support](https://simcoai.co.uk/docs/contacting-support): How to reach SIMCOAI support, what to include so the first reply is useful, and the things nobody at SIMCOAI will ever ask you for.

## Related

- Marketing: https://simcoai.co.uk/
- Company: https://simcoai.co.uk/company
- Status: https://uptime.simcoai.co.uk/
- Dashboard: https://simcoai.co.uk/login
- Support: hello@simcoai.co.uk