Add-on usage eligibility gating
Add-on usage eligibility gating
When a front desk user launches an AI add-on — AI Photo Manager, AI Treatment Visualizer, or AI Scribe — Zenoti checks whether that add-on is permitted for the current organization, center, and user before opening it. This article explains what happens during that check, what the user sees when an add-on is blocked, and how to respond.
Audience: Front desk staff and center managers who use AI add-ons during guest appointments.
On this page
Before you begin
- Your organization must have at least one AI add-on (AI Photo Manager, AI Treatment Visualizer, or AI Scribe) activated.
- You must have the relevant permission to access AI add-on features in your security role. Contact your administrator if you are unsure.
- Eligibility is evaluated per add-on, per center. If your organization has multiple centers, eligibility may differ between them.
How eligibility gating works
Before any AI add-on opens, Zenoti performs an eligibility check to confirm that the add-on is available for use at your center. The check evaluates the current organization, center, and user and returns one of three statuses:
| Status | Meaning |
|---|---|
| Allowed | The add-on is available. It opens normally. |
| Paused | The add-on is temporarily unavailable. The user sees a blocking alert. |
| Not allowed | The add-on is not permitted. The user sees a blocking alert. |
When the status is Paused or Not allowed, the add-on does not open and a standard alert popup appears. The user must acknowledge the alert before taking any other action.
Note: If the eligibility check itself fails — for example, due to a network error or a slow connection — the add-on opens as if it were allowed. This prevents a backend error from blocking a paid clinical workflow mid-appointment.
Behavior by add-on:
- AI Scribe — Always performs an eligibility check before launching, regardless of any center settings.
- AI Photo Manager and AI Treatment Visualizer — Perform an eligibility check by default. If a center setting explicitly indicates no check is required, the check is skipped and the add-on opens directly.
Zenoti also prevents duplicate eligibility checks. If a user taps or selects an add-on entry point multiple times in rapid succession, only one check runs. Any additional launch attempts wait for the first check to complete rather than sending separate requests.
Steps
Launch an AI add-on from the front desk
- Open the guest's appointment or service record from the Appointment Book.
- Select the AI add-on you want to use (AI Photo Manager, AI Treatment Visualizer, or AI Scribe).
- Wait for the eligibility check to complete. This takes a moment; avoid tapping the option repeatedly.
- Review the result:
- If the add-on opens, the eligibility check passed and the add-on is available for this center.
- If an alert popup appears, the add-on is currently paused or not allowed at your center.
Respond to a blocked add-on alert
- Read the alert message to understand whether the add-on is Paused or Not allowed.
- Select the acknowledgment option on the alert to dismiss it.
- Do not attempt to relaunch the add-on — the status applies to your organization and center, not to the individual session.
- Contact your center manager or administrator to find out when the add-on will be available again.
Important: The alert must be acknowledged before you can take any other action in the workflow. You cannot bypass or dismiss it by navigating away.
What to do if an add-on opens unexpectedly despite a known restriction
If an add-on opens when you expected it to be blocked, the eligibility check may have encountered a connectivity issue and failed open. This is by design — a failed check allows the add-on rather than disrupting the appointment.
- Complete the session normally.
- Notify your center manager so they can verify connectivity and the add-on's eligibility configuration.
Worked example: A provider at a center selects AI Scribe during a consultation. The center's internet connection is intermittent, and the eligibility check times out after 20 seconds without a response. AI Scribe opens and the session proceeds. After the appointment, the provider reports the behavior to the manager, who checks the network and confirms the add-on is correctly configured as paused for that center.
Tips
- Tap once and wait. Tapping an add-on option multiple times does not speed up the eligibility check — Zenoti runs only one check at a time per add-on. Additional taps are ignored until the first check finishes.
- AI Scribe always checks. Unlike AI Photo Manager and AI Treatment Visualizer, AI Scribe performs an eligibility check every time it is launched, even if other add-ons at your center skip the check. This is expected behavior.
- A blocked status applies to the center, not the user. If the add-on is paused or not allowed, switching users or logging out will not change the result. The restriction is set at the organization or center level by an administrator.
- Network issues favor the guest. If connectivity is poor and the eligibility check cannot complete within the allowed window, the add-on opens rather than blocking the workflow. Ensure your center maintains a reliable connection to get accurate eligibility results.
Troubleshooting
| Problem | Likely cause | Resolution |
|---|---|---|
| An alert appears every time you try to open an AI add-on | The add-on's eligibility status is set to Paused or Not allowed for your center | Acknowledge the alert and contact your administrator to review the add-on's availability for your center |
| The AI add-on opens but you expected it to be blocked | The eligibility check failed (network error, timeout, or unexpected response) and the system failed open | Complete the session; notify your manager to investigate connectivity and verify eligibility configuration |
| The eligibility check seems to take a long time | The check may be waiting on a slow or intermittent network connection | Wait up to 20 seconds; if the add-on does not open or an alert does not appear, check your network connection and try again |
| You see the alert once but the add-on opens on a second attempt | Unlikely — if the add-on is blocked, it remains blocked for the session; a second successful launch indicates the first check failed open | Note the behavior and report it to your administrator for investigation |