ZMA Appointment Book β Choose Existing Guest Screen
When you assign an existing guest to a virtual guest slot during the Confirm Guest flow in the MyZen Appointment Book, the app presents a full-screen guest search screen. This article explains how to use that screen to find and select the right guest.
Audience: Front desk staff and service providers who manage appointments in MyZen.
Before you begin
- You must have an active employee account in MyZen with access to the Appointment Book.
- The Confirm Guest flow must be in progress β this screen appears only when you tap to assign an existing guest to a virtual guest slot.
- Search is scoped to guests at the current center. Results from other centers in your organization are not included.
Steps
Open the guest search screen
In the MyZen Appointment Book, open an appointment that has a virtual guest slot requiring assignment.
In the Confirm Guest flow, select the option to assign an existing guest. The app opens the full-screen guest search screen.
Note: The screen title reflects your center's configured guest label β for example, it may read Search Guests or a custom label set by your organization.
Search for a guest
Tap the search field at the top of the screen.
Begin typing the guest's name, email address, or phone number.
- The search begins automatically after you have typed at least two characters. There is a brief delay before results appear β this is by design to avoid unnecessary requests while you are still typing.
- If you have typed fewer than two characters, the screen shows an empty prompt. Continue typing to trigger the search.
Review the results list. Each row displays:
- Guest's full name
- Email address (if on record), separated from other details by a center dot ( Β· )
- Mobile phone number (if on record), separated from other details by a center dot ( Β· )
Worked example: You type "Mar" into the search field. After the brief delay, the list shows rows such as:
- Maria Lopez Β· maria.lopez@example.com Β· 0000000000
- Marco Chen Β· 0000000000
Marco Chen has no email on record, so only his name and phone number appear.
Select a guest
- Tap the row for the guest you want to assign.
- The search screen dismisses automatically and the selected guest is returned to the Confirm Guest flow.
Handle empty or error states
The screen responds differently depending on what the search returns:
| Situation | What you see | What to do |
|---|---|---|
| Fewer than two characters typed | Empty prompt (no results shown) | Type at least two characters to start the search. |
| Two or more characters typed, no matching guests found | Empty-results message | Verify the spelling, or try a different search term such as a phone number or email address. |
| Search request fails | Error message in place of results | Check your network connection and try again. If the error persists, contact your administrator. |
Note: Search is limited to guests registered at your current center. If a guest is registered at a different center in your organization, they will not appear in these results.
Tips
- Search by phone or email if the name search returns no results. Guests may be registered under a variation of their name. Searching by mobile number or email address often produces a match more quickly.
- Shorter search terms can broaden results. If you are unsure of the exact spelling, type two or three letters to see a wider set of matches, then narrow down by scanning the list.
- Verify contact details in the results row before selecting. Each row shows the email address and mobile phone number on record, so you can confirm you are selecting the correct guest when multiple guests share a similar name.
Troubleshooting
| Problem | Resolution |
|---|---|
| The search screen does not open after tapping to assign an existing guest. | Ensure you are within an active Confirm Guest flow for a virtual guest slot. Close and reopen the appointment, then try again. |
| Results appear very slowly or not at all after typing two characters. | Check your network connection. A weak or interrupted connection delays search requests. Move to a location with better coverage and retry. |
| A known guest does not appear in search results even with correct spelling. | Confirm the guest is registered at your current center β results are scoped to the current center only. If the guest is registered at another center, their record will not appear here. Ask your administrator to verify the guest's center assignment. |