ZenotiHelp

Access AI Retention Manager and understand embedding

ZTZenoti Docs Team Updated October 25, 2026 6 min readGuide

AI Retention Manager is a dashboard embedded directly inside Zenoti. This article explains how to open the dashboard, what to expect the first time you see it, and how access is controlled so you can verify your team has the right permissions before they begin.

Audience: Employees, marketing managers, and administrators who use AI Retention Manager to monitor guest churn risk.

Before you begin

  • Your organization must have completed the AI Retention Manager onboarding process. If the dashboard shows a "Training your Retention Manager" state, setup is still in progress β€” predictions are not yet available.

  • You must have the following permission on your security role:

    Permission: AI Retention Manager β€” View is required to open the dashboard, browse the Overview, Guests, Proof of value, Reports, and How the Retention Manager works sections, and use all watchlist filtering and search. Edit is required to create a target segment, refresh a segment's member list, and send guests to AI Lead Manager.

    Admin path: Configuration > Security > Security roles > [your role] > AI Retention Manager > View / Edit

    By default, View is granted to every role that can open admin pages and to Therapist. Edit is granted to Owner, Marketing Manager, and Administrator. If you are refused with "AI Retention Manager permission is required," ask an administrator to update your security role.


Steps

Open AI Retention Manager

  1. Sign in to Zenoti and locate the Guest menu on the left navigation.
  2. Select AI Retention Manager from the Guest menu.
  3. The dashboard opens inside the current Zenoti page β€” no separate login or new browser tab is required. Zenoti passes your authenticated session and your organization context to the dashboard automatically.

Note: If the page shows an error or processing state rather than guest data, your session may not have loaded correctly. Refresh the Zenoti page and try again. The dashboard does not present a separate sign-in screen β€” an invalid session always results in an error state, not a login prompt.

Important: All guest data displayed is scoped to your organization. AI Retention Manager does not provide a view across multiple organizations.


Understand what you see on first open

When AI Retention Manager loads for the first time:

  1. The Overview opens automatically on the Repeat Guests tab.
  2. If your organization's data has finished processing, you see live retention data β€” the Retention Score, Retention Groups, the About this group panel, Guest Retention Strategies, and the Client Watchlist.
  3. If data is still being processed, the dashboard shows the "Training your Retention Manager" state. This is expected for newly onboarded organizations. Predictions are usually ready within 24 hours.

Note: Data in AI Retention Manager is near-real-time with a maximum delay of 24 hours. Do not expect second-by-second updates.


Use the built-in Help drawer to orient yourself

The Help drawer walks you through the dashboard on your first visit. You can open it at any time.

  1. In the dashboard header, select Help.
  2. The How to read this page drawer opens. It contains:
    • A Start here routine explaining the daily workflow.
    • A description of what each widget is for.
    • An explanation of the four retention bands: Critical risk of churn, High risk of churn, Monitor, and Healthy.
  3. When you have finished reading, select Close (or use the Close help control) to dismiss the drawer and return to the Overview.

Tip: The Help drawer is always available from the header β€” return to it any time you want a refresher on what the four bands mean or how to read the Retention Groups widget.


Understand the dashboard navigation

AI Retention Manager uses a horizontal tab row at the top of the dashboard. The available sections are:

Section What it contains
Overview Retention Score, Retention Groups, About this group panel, Movement tracker, Guest Retention Strategies, and the Client Watchlist
Guests Searchable and filterable guest list with churn scores and key signals
Proof of value Metrics showing the impact of your retention activity
Reports Exportable report views for your organization
How the Retention Manager works Explainer covering how predictions are built and where the model has honest limits

Note: Navigation is a horizontal tab row. There is no vertical navigation strip on the side of the dashboard.


Verify permissions for your team

If a team member cannot open AI Retention Manager or cannot perform an action:

  1. Navigate to Configuration > Security > Security roles.
  2. Select the role assigned to the employee.
  3. Locate the AI Retention Manager security object.
  4. Confirm that View is enabled for read-only access, and Edit is enabled for any employee who needs to create target segments, refresh member lists, or send guests to AI Lead Manager.
  5. Save the role. The employee must sign out and back in for permission changes to take effect.

Permission: Employees refused with "AI Retention Manager permission is required" do not have the View or Edit action enabled on their security role. An Administrator or Owner must update the role at Configuration > Security > Security roles.


Worked example β€” granting Edit access to a marketing coordinator: A marketing coordinator needs to create a target segment for guests in the Critical risk of churn band. Their current role has View but not Edit on the AI Retention Manager security object. An Administrator navigates to Configuration > Security > Security roles, opens the coordinator's role, enables Edit under AI Retention Manager, and saves. The coordinator signs out and back in. They can now select Create Target Segment from the Guest Retention Strategies section without receiving a permission error.


Tips

  • Open AI Retention Manager at the start of each day. The Client Watchlist on the Overview ranks guests by risk β€” reaching out to the top of the list first is the most efficient use of your time.
  • Use the built-in Help drawer (select Help in the header) any time you are unsure what a widget or band means. It does not require a separate article or external link.
  • If the dashboard shows a processing state after more than 48 hours, contact Zenoti support. The message "Usually ready within 24 hours" appears during normal model training, but a prolonged processing state may indicate a setup issue.
  • AI Retention Manager is scoped to your organization. If you manage multiple organizations, you must access each organization's Zenoti instance separately β€” there is no cross-organization view.
  • When reviewing permissions, check both View and Edit independently. A user with only View can browse all read-only sections but will be blocked when attempting to create a segment or refresh a member list.

Troubleshooting

The dashboard shows an error or processing state instead of guest data. The dashboard did not receive a valid session from Zenoti. Refresh the Zenoti browser page and navigate back to AI Retention Manager from the Guest menu on the left navigation. If the error persists, sign out of Zenoti completely and sign back in. The dashboard never shows a separate login screen β€” an invalid session always results in an error state.

An employee is refused with "AI Retention Manager permission is required." The employee's security role does not have the required action (View or Edit) enabled on the AI Retention Manager security object. Navigate to Configuration > Security > Security roles, locate the employee's role, and enable the appropriate action. The employee must sign out and sign back in after the change is saved.

The Overview loaded but shows the "Training your Retention Manager" state. Your organization's historical guest data has not finished processing. This is expected for newly onboarded organizations. Predictions are usually ready within 24 hours. If the state persists beyond 48 hours, contact Zenoti support.

A team member sees data from a different organization. This cannot occur. AI Retention Manager is always scoped to the organization of the Zenoti session used to open it. If a user has access to multiple Zenoti organizations, they must open each organization's instance of Zenoti separately.


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