# Voice quickstart

> Give a practice an AI receptionist that answers its calls. In early access.

Source: https://docs.orkero.app/quickstart/voice

> **Early access.** Orkero Voice answers real practices' phones today. The API below is
> designed and published so you can plan against it; it is not open yet. Ask for early
> access to be told first.

Voice answers a practice's calls in the practice's name. It finds the patient from their
number or checks who they are, says whether their glasses or lenses are ready, books, moves
and cancels with the same rules as online booking, and hands the call to a person for
anything clinical or unusual. It never gives clinical advice, and anything urgent goes
straight to a clinician.

## 1. Give a practice a line

```bash
curl https://api.orkero.app/v1/voice/lines \
  -H "Authorization: Bearer $ORKERO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "practice_id": "'$PRACTICE'",
    "number": "forward",
    "answer": "unanswered",
    "handover": "+441491000000",
    "can": ["booking", "orders", "hours"]
  }'
```

`answer` is `always`, `unanswered` (rings the practice first) or `off`. `can` is what Voice
may do on a call.

## 2. Read the call log

`GET /v1/voice/calls?practice_id=…` lists each call: why the person rang, what was done, how
long it took and whether it was handed over. A transcript and the caller's number never
appear in the log.

## 3. Hear about calls

`call.completed`, `call.handover` and `call.callback_needed` events by [webhook](/webhooks).

Full detail: [Voice reference](/reference/voice).
