Troubleshoot zeenie issues
ZTZenoti Docs Team Updated April 10, 2026 3 min readGuide
This guide helps you diagnose and resolve common issues with Zeenie, the AI assistant in Zenoti.
Before you begin
- You must have the Zeenie permissions permission to access the chat widget.
- For module and center configuration, you need organization administrator access.
- See Configure Zeenie modules and permissions for setup steps.
Chat widget does not appear
If the Zeenie icon and keyboard shortcut (Ctrl+K / Cmd+K) are not available:
- Check the master feature: Verify that the Zeenie AI Assistant feature is enabled at the organization level.
- Check center enablement: Verify that Zeenie is enabled for your specific center, either through the all-centers toggle or per-center configuration.
- Check permissions: Verify that your user role has the Zeenie permissions permission assigned.
- Refresh the page: After any configuration changes, reload the Zenoti admin page.
A specific skill is unavailable
If Zeenie responds but cannot perform a specific action:
- Check the module: Verify that the required module is enabled:
- Front-desk and inventory skills require the Front Desk module.
- Insights queries require the Insights module.
- Settings navigation requires the Admin module.
- Help documentation requires the Help Docs module.
- Payment dispute assistance requires the Payments module.
- Check your permissions: Some skills require elevated access. Verify that your user role has the appropriate permissions for the skill you are trying to use.
- Check center-level enablement: Some skills may be enabled at the organization level but not for your specific center.
Confirmation prompt timed out
When an action that modifies data (such as creating a purchase order or adjusting stock) requires confirmation, you have 5 minutes to respond. If the prompt expires:
- The action is canceled automatically.
- Ask Zeenie to perform the action again.
- Confirm promptly when the new confirmation prompt appears.
AI Scribe is not working
If AI Scribe features are unavailable or recordings are not processing:
- Check permissions: Verify that your user role has the AI Scribe permissions permission.
- Check feature enablement: Verify that AI Scribe is enabled for your organization.
- Check Guest Profile v2: AI Scribe insights and form filling on Zenoti Web require Guest Profile v2 to be enabled.
- Check processing status: After recording, the system processes the audio through multiple stages. Allow time for processing to complete.
- Check device requirements: AI Scribe recordings are made through the Zenoti Mobile App (ZMA). Verify that your device meets the app requirements.
Insights queries return no data
If Zeenie reports no data for your insights query:
- Check the date range: Verify that you specified a date range that contains data. Try a broader range.
- Check center selection: If you filtered by center, verify that the center has data for the requested metric.
- Check the Insights module: Verify that the Insights module is enabled for your organization.
- Simplify the query: Start with a broad question such as "What were our sales last month?" to confirm that data is available, then narrow down.
Marketing AI or Payments AI is unavailable
- Marketing AI requires the Front Desk module to be enabled. Verify the module is active and that your user has marketing permissions in Zenoti.
- Payments AI requires the Payments module to be enabled at the organization or center level. Ask your administrator to verify the Zeenie Payments feature configuration.
Lab features are not appearing
If experimental features from lab settings are not visible:
- Check scope: Lab settings can be configured at the organization level or center level. Verify the setting is applied at the correct scope.
- Check for conflicts: Center-level settings override organization-level settings. If a feature is disabled at the center level, the organization-level setting does not apply.
- Verify the setting was saved: Lab settings take effect immediately, but confirm the save completed successfully.
Was this article helpful?
Your feedback helps us improve our documentation.