ZenotiHelp

Notifications and wait time reference

ZTZenoti Docs Team Updated October 27, 2026 5 min readGuide

This article is a reference companion to Configure queue notifications and wait time. It summarizes the notification types triggered during queue reprocessing, the wait time indicators available in the queue, the queue position calculation rules, and the no-show workflow including auto-purge behavior.

Note: For step-by-step configuration guidance, see Configure queue notifications and wait time. For queue reprocessing behavior, see Understand queue reprocessing.

Before you begin

  • The Enable Admin Queue setting must be enabled at the organization level, and Operate appointment book in Queue mode must be enabled at the center level.
  • Queue notifications are triggered automatically during reprocessing cycles. No manual setup is required to receive them once the queue is active.

Permission: Edit (under Organizations) is required to modify queue notification and wait time settings.

On this page


Notification types

The queue triggers the following notification types automatically during each reprocessing cycle. Notifications are delivered by email, SMS, or both, depending on your center's notification channel configuration.

Notification When it fires Purpose
Next-in-line When a guest becomes the next person to be served by their assigned provider Tells the guest their service is about to begin
Wait time threshold When the estimated wait time for a guest falls within a configured number of minutes Gives guests advance notice to prepare
Position threshold When a guest reaches a specific position in the queue Alerts guests who are approaching the front of the queue
Client ready for queue When staff selects Ready for client from the horizontal ellipsis (⋯) menu on a waiting guest's queue card Used to notify a guest that their provider is ready for them

Notifications are sent once per qualifying event. If a guest's position changes multiple times in a single reprocessing cycle, only the final state determines whether a notification fires.

Note: For notification types 9 (First Reminder) and 160 (Second Reminder), the queue automatically skips sending a duplicate if a pending notification of the same type already exists for the same appointment. This prevents guests from receiving the same reminder more than once.

Wait time indicators

The queue displays three types of wait time information:

Indicator Where it appears Description
Center wait time Top of the queue dashboard The estimated time until the next available appointment slot at the center. Updated after every reprocessing cycle.
Guest deviation time Individual queue cards (when enabled) The difference between a guest's originally scheduled appointment time and their current estimated start time. A positive deviation means the guest is running behind schedule.
Minimum guest wait time Queue display A duration in minutes configured at the center level that gates service eligibility — for example, 15 minutes. This is a functional threshold, not a static display label. The text shown to staff (such as "15 min") derives from this numeric value.

All wait time values are estimates based on current queue conditions. Actual times may vary if guests are marked no-show, services run longer or shorter than expected, or providers check in or out.

Queue position calculation

Queue positions are assigned to every waiting guest and update after each reprocessing cycle. Positions are calculated using a dense rank based on two factors:

  1. Minimum start time — the earliest estimated start time across all services in the guest's appointment group.
  2. Creation date — the timestamp when the appointment was created, used as a tiebreaker when two guests have the same estimated start time.

Guests with earlier estimated start times receive lower position numbers (position 1 is first in line). Position numbers are visible on queue cards when the Show guest numbers in Queue view permission is granted. This is a per-role permission configured under Configuration > Security > Security roles > PERMISSIONS > Queue & Pin > Queue items > Show guest numbers in Queue view.

No-show workflow

When a guest with a waiting appointment does not arrive or fails to respond, front desk staff can mark that appointment as a no-show.

Marking a guest as no-show

  1. Locate the guest's card in the Guests Waiting section.
  2. Select the no-show button on the queue card. The button label may be customized using the Enter label for no-show button center setting under Configuration > Appointments > Queue.
  3. The no-show confirmation dialog opens, presenting the following fields:
    • Reason List — select a reason from the dropdown. This field is required.
    • Comments — enter optional free-text comments.
  4. Click Submit.

After submission, the appointment status changes to no-show and is removed from the Guests Waiting section. The queue reprocesses automatically, recalculating estimated wait times for remaining guests. Changes appear on all open queue screens without requiring a manual refresh.

Important: Select a reason before clicking Submit. The Reason List field is required — the dialog will not proceed without a selection.

Auto-purge and bypass behavior

When the Enable automatic purge of no-show guests from queue center setting is enabled, the queue automatically marks overdue appointments as no-show based on source-specific timer limits. These limits are configured at the center level under Configuration > Appointments > Queue:

Timer setting Applies to
Set an auto-delete timer limit for walk-in guests (in minutes) Walk-in appointments
Online checkin and guest in store timer limit (in minutes) Online check-in appointments where the guest is physically present
Online checkin and guest not in store timer limit (in minutes) Online check-in appointments where the guest has not arrived

When a waiting appointment exceeds the applicable timer limit without progressing, the queue automatically records it as a no-show and reprocesses.

Bypassing the purge timer

Staff can bypass an impending auto-purge for a specific guest. Selecting the bypass action on the guest's queue card replaces the appointment's remaining purge timer with the value configured in the Bypass purge timer limit (in minutes) center setting. The bypass does not add to or extend the remaining time — it substitutes the configured bypass duration in full.

Important: The bypass replaces the remaining purge timer entirely. For example, if 3 minutes remain and the Bypass purge timer limit (in minutes) is set to 10, the new timer becomes 10 minutes — not 13 minutes.

Notification delivery channels

Queue notifications can be delivered via SMS, email, or both. The guest must have valid contact information on file for the selected channel. For details on configuring delivery channels, see Configure queue notifications and wait time.

Was this article helpful?
Your feedback helps us improve our documentation.