> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voxhealth.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Scheduling

> The appointment calendar.

**Patients → Scheduling.** Available when the `APPOINTMENTS` feature is enabled.

The calendar shows appointments from your PMS: everything, not only what the agent booked. Staff can book, move, and cancel here, and those changes are written back.

## Appointment status

| Status        | Meaning                                 |
| ------------- | --------------------------------------- |
| `proposed`    | Suggested, not committed                |
| `pending`     | Awaiting confirmation from the practice |
| `booked`      | On the schedule                         |
| `arrived`     | Patient has checked in                  |
| `fulfilled`   | Visit completed                         |
| `cancelled`   | Cancelled                               |
| `noshow`      | Patient did not attend                  |
| `rescheduled` | Moved to a different slot               |

Separately, an appointment carries a **confirmation status**: whether the patient has confirmed. That is what a patient sets by replying to a [reminder](/channels/notifications), and it is written back to your PMS so your schedule shows what your staff would have set by hand.

## What the agent books into

The agent does not invent slots. It reads availability from your PMS (provider schedules, operatories, existing appointments, and blocks) and offers what is genuinely open.

Three things decide what it offers:

<AccordionGroup>
  <Accordion title="Provider and operatory availability in your PMS">
    Blocks, time off, and provider hours all come from your system. Something the agent should not offer gets blocked there.
  </Accordion>

  <Accordion title="Which providers are open to agent scheduling">
    Providers can be excluded from agent booking without touching their PMS schedule. See [Availability](/patients/availability).
  </Accordion>

  <Accordion title="Appointment type and duration">
    The reason for the visit maps to an appointment type, which sets the length. A wrong mapping is the usual cause of new patients landing in slots that are too short.
  </Accordion>
</AccordionGroup>

## Double-booking

Two callers can want the same slot at the same moment. VoxHealth claims a slot while a booking is in progress and releases it if the booking does not complete, so the second caller is offered a different time rather than being booked on top of the first.

## Related

* [Availability](/patients/availability): the next open slot across the practice
* [Waitlist](/patients/waitlist): filling a slot that just opened
* [Huddle](/front-desk/huddle): one day, patient by patient