How the widget adapts

The Medos Booking widget supports three booking system types. Which one the patient sees depends on the doctor they choose — you never pick manually.

The three system types

SCHEDULED

The classic appointment flow. Patients see:

1. A doctor list (unless calendarOnly is enabled)
2. A calendar with available dates
3. Time slots for the selected date
4. Phone OTP + patient details
5. A confirmation screen with the appointment ID

SCHEDULED_WITH_PACKAGES

Same as SCHEDULED, but patients can also apply an active session pack (pre-paid consultation bundles). If the patient has remaining sessions with the doctor, the widget offers to use one instead of creating a new paid appointment.

QMS (Queue Management System)

Token-based, live queue booking. Patients see:

• A queue stats banner above the calendar (current queue length, approximate wait time)
• A shorter flow — no time-slot picking
• A confirmation screen with a token number, queue position, and estimated wait time

How the widget decides

The widget reads the doctor's setting from the workspace API and applies this fallback chain:

Confirmation payload differs per type

The onSuccess callback receives a different shape depending on which flow completed:

• SCHEDULED / SCHEDULED_WITH_PACKAGES → { appointmentId: number }
• QMS → a full QueueToken object (token number, position, wait time)

See the Callbacks & Events page for the exact shapes.