Clients are added to the queue in one of two ways:
A staff member manually adds them (in the Back Office).
The client joins the queue themselves (i.e. through the booking widget), AKA client self-registration.
*Note: queueing is only supported by the booking widget v3.
This article explains what is required for client self-registration, along with relevant notes.
To begin, note that queue services require their own booking widget—they don’t appear in your regular booking widget by default. This means you must implement a separate, queue-specific widget on your website or application.
Suggestion: because the widget is separate from the default one, note that you'll need to add CTAs for it in your website or application.
Adding a Queue Widget to Your Website
To generate the code for this widget, use Booxi's code generator. For the widget to function properly, ensure the following conditions are met:
The CTA Booking Type is of type "Queue".
The "Enable Store Selection" parameter is set to "No" (this is done automatically if the booking type is set to "Queue").
When your settings are configured, feel free to test the widget directly in the generator.
Requirements
In your Back Office, ensure the following conditions are met:
The queue is configured.
You have at least one queue service whose status is "Available online."
You have at least one queue service that has at least one assigned staff member.
Your business' "Enable Online Booking" setting is enabled (My Business > Booking Rules > Enable Online Booking).
[Optional] If your business supports multiple languages, ensure appropriate translations are provided; see here for info.
Queue flow (client POV)
For an overview of the queue booking experience from the client's perspective, see here.
Queue flow (staff POV)
For an overview of the queue booking process from the staff member's perspective, see here.
Notes
Only one active queue can exist per store per day.
Each client can have one active queue booking at a time.
To add a client for multiple services, staff must do so in the Back Office.
The widget automatically blocks new enrollments if the estimated service time is outside business hours.
When the queue closes (manually or by schedule), clients can no longer join it.
If you make use of your booking page for booking, note that queue services won’t be shown there, since the widget included in the booking page is v2.
The booking widget you use for queueing will inherit your custom theme configuration.
Consent Collection
Consent works the same way for queue bookings as it does for regular appointments.
If you’ve enabled custom consents, those are shown in the widget. If you haven’t, Booxi’s native consents will appear instead.
Any custom consents captured are included in consent webhooks.