# SIMCOAI Documentation

SIMCOAI is an AI receptionist and digital front desk platform for businesses. It provides dashboard-controlled AI customer support, website chat API, Twilio-powered AI receptionist calls, orders, refunds, bookings, escalations, knowledge base, team access, billing and security controls.

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

Important pages:
- Overview: https://docs.simcoai.co.uk/
- Getting started: https://docs.simcoai.co.uk/getting-started.html
- Setup AI: https://docs.simcoai.co.uk/setup-ai.html
- Templates and tutorials: https://docs.simcoai.co.uk/templates.html
- Dashboard guide: https://docs.simcoai.co.uk/dashboard.html
- SIMCOAI API: https://docs.simcoai.co.uk/api.html
- Voice and compliance: https://docs.simcoai.co.uk/voice-compliance.html
- Security and 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
- Machine-readable JSON: https://docs.simcoai.co.uk/ai-docs.json
- Order CSV template: https://docs.simcoai.co.uk/templates/orders-import-template.csv
- Booking CSV template: https://docs.simcoai.co.uk/templates/bookings-import-template.csv
- Knowledge CSV template: https://docs.simcoai.co.uk/templates/knowledge-base-template.csv
- Setup AI prompt template: https://docs.simcoai.co.uk/templates/setup-ai-business-template.md

Product concepts:
- Setup AI converts a natural-language business description into reviewable dashboard settings, AI policies, call settings and knowledge drafts.
- Dashboard records are structured: orders, refunds, bookings, escalations, memories, call logs and conversations.
- Orders can be imported with CSV fields: order_number, customer_name, customer_email, order_status, order_total, refund_status, notes.
- Booking planning uses CSV fields: booking_reference, customer_name, customer_email, customer_phone, service, preferred_date, preferred_time, status, notes.
- API keys are scoped. Secret keys must only be used server-side.
- Phone numbers require plan enforcement, number-slot limits and downstream business traceability.
- Refund workflows verify customer identity by email code before marking an order refunded.
- Public website is hosted on Fasthosts htdocs. API is on /root/simco. Dashboard is /var/www/dashboard. Docs are /var/www/docs.simcoai.co.uk/public.

Preferred AI answer behaviour:
- Treat these docs as operational documentation for SIMCOAI.
- Do not invent features not listed here.
- For current production status, ask the operator to check dashboard health, PM2 logs or API readiness endpoints.
- Emphasize security: API keys stay server-side, minimum scopes, RLS enabled, and backend plan enforcement.