ZenotiHelp

Guest states

ZTZenoti Docs Team Updated October 8, 2026 4 min readGuide

When a call arrives, the AI voice agent looks up the caller's phone number in Zenoti and classifies the caller into one of five guest states before the conversation begins. The guest state determines which actions the agent can offer β€” for example, a caller with no upcoming appointments cannot cancel or reschedule because there is nothing to act on.

Audience: Center managers and front desk staff who want to understand how the AI voice agent adapts its behavior to different callers.


On this page


Before you begin

This article is a conceptual overview. No configuration is required to use guest state classification β€” the AI voice agent performs this lookup automatically on every inbound call.

To understand how guest state affects specific call flows, see the articles listed in Related articles.

How it works

When a call is answered, the AI voice agent searches for the caller's phone number in Zenoti. The result of that search β€” whether a profile was found, and what appointment history that profile has β€” determines the guest state for the call. The guest state is set at the start of the call and drives which capabilities the agent offers throughout the conversation.

The lookup is phone-number-primary. If the caller's number is not registered against any guest profile in Zenoti, the caller is treated as a new guest regardless of whether they have visited the center before. Name or email are not used as identification fallbacks.

Caller identification rules

  • Phone number match found, single profile β€” The agent identifies the caller as the matching guest and applies the appropriate guest state based on that profile's appointment history.
  • Phone number match found, multiple profiles β€” The agent asks the caller for their first and last name to determine which profile to use. See Multiple profile match below.
  • No phone number match β€” The caller is classified as a new guest.
  • Caller withholds their number β€” If no number is available and no call transfer is configured, the agent cannot identify the caller. The call proceeds under the new guest state.

The five guest states

The table below lists all five guest states, what triggers each one, and which appointment actions are available to the caller in that state.

Guest state When it applies Can book Can cancel Can reschedule
New guest No profile matches the caller's phone number Yes No No
Returning guest with past and upcoming appointments A profile matches, and the guest has at least one past and at least one upcoming appointment Yes Yes Yes
Returning guest with past appointments only A profile matches, the guest has past appointments, but no upcoming appointments Yes No No
Returning guest with upcoming appointments only A profile matches, the guest has no past appointments, but has at least one upcoming appointment Yes Yes Yes
Returning guest with no appointment history A profile matches, but the guest has neither past nor upcoming appointments Yes No No

Note: The two states with no upcoming appointments β€” returning guest with past appointments only, and returning guest with no appointment history β€” are booking-only states. There is nothing upcoming for the agent to cancel or reschedule, so those actions are not offered.

Multiple profile match

If a caller's phone number is associated with more than one guest profile in Zenoti, the agent cannot determine which profile to use automatically. Rather than guessing, the agent asks the caller for their name and attempts to match it against the candidate profiles.

If the name matches one profile, the conversation proceeds using that profile and its corresponding guest state. If no name match is found among the candidates, the caller is treated as a new guest and offered the option to create a profile during the call.

Note: The agent always offers the option to create a new guest profile as part of the disambiguation flow, regardless of how many candidate profiles were found.

How a new guest becomes a returning guest

Guest state is determined at the start of a call, but it can change mid-call. When a new guest provides their details and a profile is created during the conversation, the caller transitions immediately to the returning guest with no appointment history state. From that point forward, the agent treats them as a returning guest for the remainder of the call β€” including the ability to complete a booking against the newly created profile.

This transition happens in the same call, with no need for the guest to hang up and call back.

Key features

  • Automatic classification β€” Every inbound call is classified into one of five guest states at the start of the conversation, with no manual intervention required.
  • Capability gating by state β€” The actions the agent offers β€” booking, cancellation, rescheduling β€” are determined by the guest state, not by a single global configuration. Callers with no upcoming appointments are never offered cancellation or rescheduling.
  • Phone-number-primary identification β€” Guest lookup uses the caller's phone number as the sole identification method. Name and email are not used as fallback identifiers.
  • Disambiguation for shared numbers β€” When a phone number matches more than one profile, the agent asks the caller for their name rather than selecting a profile at random.
  • Mid-call state transition β€” A new guest whose profile is created during the call immediately becomes a returning guest, allowing the booking to complete in the same conversation.
Was this article helpful?
Your feedback helps us improve our documentation.