ZenotiHelp

Appointment Slot Search β€” Earliest-Available and Open-Ended Date Requests

ZTZenoti Docs Team Updated October 27, 2026 5 min readGuide

When a guest asks SmartBot for the next available appointment, an appointment this week, or the first opening in a date range, the AI agent uses an earliest-available search mode that returns the closest matching slot rather than restricting results to a single exact date. This article explains how the slot search behaves for different types of date requests and what that means for the guest experience.

Audience: Center managers and SmartBot administrators who configure or oversee SmartBot booking flows.

Before you begin

  • Your organization must have SmartBot enabled with at least one center configured for the web chat widget or SMS channel.
  • The booking flow must be active for the relevant center.
  • To change booking flow configuration settings, you need administrator access to the SmartBot admin console.
  • Confirm that the center's week_start_day is configured correctly in the session configuration before testing "next week" requests. Incorrect week-start configuration causes next-week slots to begin on the wrong day.

Steps

Understand how the slot search mode is determined

SmartBot interprets the guest's date request and sets the slot search to one of two modes before querying available appointments. The mode determines whether the AI agent returns only slots on the exact date the guest specified, or searches forward from that date to find the earliest available opening.

The following table summarizes how each type of guest request is handled:

Guest's request Search mode How slot_date is set
"What's the next available appointment?" Earliest-available Start of today's date or the requested window
"Do you have anything this week?" Earliest-available Start of the current week
"What about next week?" Earliest-available First day of next week, based on the center's configured week start day
"Any time between the 10th and the 20th?" Earliest-available First day of the specified range
"I want an appointment on March 15th." Exact date only March 15th β€” no forward search

How earliest-available mode works

When the guest's request is open-ended β€” asking for the next opening, a slot this week, next week, or within a date range β€” the AI agent sets the search to earliest-available mode. In this mode, the slot search starts at the beginning of the requested window and returns the first slot that matches the guest's service, provider preference (if any), and center, regardless of how far into the window that slot falls.

For example, if a guest says "Do you have anything next week?" and Monday is fully booked, the AI agent returns the first available slot on Tuesday or later in that week β€” it does not report that Monday is unavailable and stop there.

How exact-date mode works

When the guest names a specific date β€” for example, "I'd like an appointment on Friday the 14th" β€” the AI agent sets the search to exact-date mode. The slot search returns only slots on that date. If no slots are available on that exact date, the AI agent informs the guest that there are no openings on that day and offers alternatives.

Use exact-date mode behavior as the expected baseline when a guest is firm about a specific date and should not be routed to a different day automatically.

How "next week" requests use the week start day

When a guest asks for an appointment next week, the AI agent calculates the start of the following week using the week_start_day value from the center's session configuration β€” not a fixed calendar assumption. If the center's week starts on Sunday, the search window for "next week" begins on the upcoming Sunday. If the center's week starts on Monday, the window begins on the upcoming Monday.

This ensures that the slot search aligns with local business practices rather than a universal calendar default.

Note: The week start day is a center-level setting in the session configuration. If guests report that "next week" searches are returning slots from the wrong starting day, verify that the week start day is set correctly for that center.

Worked example

A guest on SMS sends the message: "Can I book something next week? Preferably with any provider, the earliest opening."

The center's week start day is configured as Monday. Today is Wednesday, April 9.

  • The AI agent interprets the request as open-ended (next week, no specific date).
  • Earliest-available mode is set.
  • slot_date is set to Monday, April 14 β€” the first day of next week per the center's configuration.
  • The slot search scans forward from April 14 and returns the first available slot across Monday through Sunday of that week.
  • If the first opening is Thursday, April 17 at 2:00 PM, the AI agent presents that slot to the guest.
  • The guest is not told that Monday through Wednesday have no openings β€” only the earliest available result is surfaced.

Compare this to a guest who sends: "I need an appointment on April 14th specifically."

  • Exact-date mode is set.
  • The slot search returns only slots on April 14.
  • If April 14 is fully booked, the AI agent informs the guest and may offer to check a different date.

Tips

  • When testing SmartBot booking flows, send open-ended requests ("next available," "this week," "sometime next week") as well as specific-date requests to confirm that each mode behaves as expected.
  • If your center serves guests across multiple time zones or has unconventional week start days (for example, starting the business week on Saturday), verify the week start day setting before go-live to avoid mismatched next-week search windows.
  • Guests who do not specify a date will always trigger earliest-available mode. Train front desk staff to expect that SmartBot may present a slot several days in the future if the immediate calendar is full, and that this is the intended behavior β€” not a booking error.
  • For centers with consistently high occupancy, earliest-available mode is particularly useful because it prevents guests from receiving a "no slots available" response when openings exist later in the week or range they requested.

Troubleshooting

Guests report that "next week" results start on the wrong day.

Verify the week start day in the center's session configuration. If it is set to a day that does not match the business's actual week start, correct the setting and test again with a "next week" request.

Exact-date requests are returning slots on other days.

Confirm that the guest's message named a specific date explicitly. Phrasing like "sometime around the 15th" or "near the end of the month" is interpreted as open-ended and triggers earliest-available mode. Only requests that name a precise date (for example, "on the 15th" or "April 15th") trigger exact-date mode.

The AI agent reports no available slots even though the calendar has openings later in the week.

Check whether the slot search window is configured with a correct end date for the range. If the search window is too narrow, openings beyond it are not returned. For open-ended requests that should search across a full week, confirm that the window spans the entire requested period.

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