SIMCOAI documentation
Set up and run your AI front desk: phone reception, chat, workflows, the API and billing. Search above, or start with the 30-minute quickstart.
Start hereGet answering calls in about 30 minutes
Five steps. Each links to the detail if you need it.
- 1
Create your account and pick a planCheckout starts a 7-day trial. Your card is collected but not charged during it. Getting started - 2
Add your business informationHours, services and the questions customers actually ask. The AI answers from this. Setup wizard - 3
Choose a voice and test itPreview, then run a live test call that costs no call credit. Voices and speech - 4
Get a phone numberBuy one in SIMCOAI, or forward your existing number to it. Phone numbers - 5
Run the readiness checks, then ring it yourselfCheck configuration, then check the conversation. Health checks
Popular tasksWhat people come here to do
- Buy a phone numberSearch, compliance bundles, addresses and what each error means
- Set up a profile per numberGive the refunds line and the bookings line different behaviour
- Fix a login problemPasswords, magic links, passkeys, authenticator codes
- Troubleshoot a callNot answered, repeating itself, slow replies, missed escalations
- Connect the APIEvery endpoint, the response envelope and the four tables
- Configure webhooksEvents, delivery format, retries and signature verification
- Collect proof from a customerOne-off secure upload links for refunds and orders
- Check usage against your planWhat is metered and what happens at a limit
By roleFind your route in
The same docs, ordered by what your job needs first.
Business owner
Launching and running the front desk.
Support manager
Day-to-day operation and quality.
Developer
Integrating SIMCOAI with your systems.
Billing and admin
Plans, costs and account access.
API quick linksStraight to the endpoints
Base URL https://api.simcoai.co.uk/v1. Authenticate with the X-SIMCOAI-API-Key header.
GET/v1/me
Confirm which account and scopes a key belongs to.
Requires scope read
POST/v1/{table}
Create or upsert an order, refund, booking or escalation.
Requires scope write
POST/v1/chat
Send a customer message to the AI and receive a reply.
Requires scope chat:write
Full reference: API overview · errors · rate limits · idempotency · cURL
Something broken?Troubleshooting
Start with the symptom.
- Cannot sign inPasswords, magic links, MFA, Google login
- Calls or AI behaviourNot answering, looping, slow, missed escalations
- Buying a numberBundles, addresses, capacity, availability
- Billing and checkoutCheckout, declines, plans not activating
- API responses401, 403, 404, 409, 422, 429
- WebhooksSignatures, missing deliveries, duplicates
Platform-wide problems appear on the status page first. Found a bug? Report it.