Skip to content

Quickstart

Five steps from sign-up to a live phone line. The first three take a few minutes and cost nothing.

1. Create a workspace

Sign up and name your workspace. Pick the data region your calls should run in (CH, EU or US).

2. Create an agent from a role

Agents → New agent. Pick a role, describe your company, choose a voice and language.

or via the APIbash
curl -X POST https://<your-app>/api/v1/agents \
  -H "Authorization: Bearer cv_live_…" -H "Content-Type: application/json" \
  -d '{
    "name": "Front desk",
    "role": "receptionist",
    "company": { "name": "Acme Dental", "description": "Family dental practice, Zurich" },
    "spec": { "voice": { "engine": "auto", "language": "de" } }
  }'

3. Test it in the browser

Open the agent and press Test call. Interrupt it, ask it something off-script, try to book.

4. Give it a calendar

Calendar → add your opening hours and slot length; optionally connect Google or Microsoft 365.

5. Go live

Numbers → buy a local number and route it to the agent — or call out via the API.

an outbound callbash
curl -X POST https://<your-app>/api/v1/calls \
  -H "Authorization: Bearer cv_live_…" -H "Content-Type: application/json" \
  -d '{ "agent_id": "…", "to": "+41441234567", "goal": "Confirm tomorrow's appointment",
        "consent": { "basis": "existing_customer" } }'

Outbound calls to Germany, France and Switzerland require a consent basis at launch — see compliance.