Unknown Guest Search β HyperConnect Timeline Events Inclusion
When a guest calls your center from a phone number that is not linked to an existing guest profile, HyperConnect records that interaction as an unknown guest event. By default, the unknown guest search only looks at phone numbers stored in guest profiles. This article explains how HyperConnect extends that search to include phone numbers captured from timeline events β so that unknown callers who have interacted with your center before can surface in search results even without a linked profile.
Audience: HyperConnect administrators and front desk staff who manage guest timelines and unknown guest interactions.
Before you begin
Your center must have HyperConnect enabled by your organization.
You need the following permission:
Permission: Connect Access Enable β Required to access HyperConnect features. Admin path: Organization > Security > Security Roles > [your role] > Zenoti HyperConnect > Connect Access Enable
This behavior applies only when your center is operating in HyperConnect mode (not the legacy ezConnect mode).
The extended search applies to center-level holders only β it does not apply at the organization level.
How unknown guest search works
When a call or message arrives from an unrecognized phone number, HyperConnect runs a search to determine whether that number belongs to a known guest. The search checks guest profile records for a matching phone number.
Standard search scope
In the standard search, HyperConnect looks for the phone number in guest profile records. If no match is found, the interaction is treated as an unknown guest and displayed without a linked profile.
Extended search with HyperConnect timeline events
When your center uses HyperConnect, the unknown guest search is extended to also check the guest timeline event log. Specifically, the search includes phone numbers from timeline events where no guest profile is linked β that is, events that were recorded without an associated guest identity.
This means that if a caller's phone number appears in a previous timeline event (such as a prior call or message that was never linked to a guest), HyperConnect can surface that event history in the search results. Front desk staff can then review the prior interaction and decide whether to link the caller to an existing guest profile or create a new one.
When the extended search applies
The extended timeline event search activates under both of the following conditions:
- The search is running in HyperConnect mode (not legacy ezConnect mode).
- The holder performing the search is a center β not an organization-level holder.
If either condition is not met, the search uses the standard scope only.
Steps
Search for an unknown guest
- Open HyperConnect from Chat in the Zenoti navigation.
- When an inbound call or message arrives from an unrecognized number, HyperConnect displays the interaction in the conversation panel with an unknown guest indicator.
- In the conversation panel, click Link guest to open the guest search.
- HyperConnect automatically searches for the phone number across:
- Guest profile records
- Timeline event records where no guest is linked (when operating as a center in HyperConnect mode)
- Review the search results:
- If a match is found in guest profiles, select the guest to link the conversation.
- If a match is found only in timeline events, review the prior event history to determine whether the caller is a returning contact.
- If no match is found, click Create a guest profile to register the caller as a new guest.
Link a timeline event to a guest
If the extended search surfaces a prior timeline event for the unknown caller:
- Review the event details displayed in the search results.
- Click Link now to associate the current conversation with the identified guest.
- If multiple potential matches appear, click Link to right one to select the correct guest profile.
- Zenoti displays a confirmation: Guest linked successfully.
Note: Linking a conversation to a guest profile connects the current interaction to that guest's record. It does not retroactively update the prior timeline events that surfaced in the search.
Tips
- If a caller's number appears in timeline events but not in any guest profile, this is a strong signal that the caller has interacted with your center before without completing a profile registration. Use this opportunity to create a guest profile and link the conversation.
- The extended timeline event search only surfaces events where the phone number was recorded but no guest was linked at the time. Events that are already linked to a guest profile are handled by the standard guest profile search.
- If your center is part of a call center hub-spoke configuration, the timeline event search applies to the center context in which the interaction is received. Verify that the correct center is active before searching.
- To review prior unknown guest interactions in the timeline, navigate to the guest timeline view after linking the conversation. The timeline displays all recorded events, including those captured before the guest profile was linked.
Troubleshooting
- The extended search does not return timeline event results. Confirm that your center is operating in HyperConnect mode and that the holder context is a center (not the organization level). If HyperConnect is not enabled for your organization, contact your administrator.
- A phone number appears in timeline events but cannot be linked. If the timeline event belongs to a different center's records, you may not have visibility into those events depending on your organization's events sharing setting. Check with your administrator whether cross-center events sharing is enabled.
- The guest search returns no results for a known caller. The extended search covers timeline events where no guest is linked. If the caller's prior interactions were already linked to a guest profile, the standard guest profile search should return results. Try searching by name or a partial phone number in the guest search field.