AI Scribe β Clarification Card for Ambiguous Queries (ZMA)
When a provider asks AI Scribe a question that could match more than one filter type β for example, a term that applies to both a service and a concern β AI Scribe displays a clarification card inline. This article explains how to read and respond to clarification cards during a session in the Zenoti Mobile App (ZMA).
Audience: Providers who use AI Scribe to record and document clinical sessions on ZMA.
On this page
Before you begin
AI Scribe access must be enabled for your account. Contact your administrator if you cannot access AI Scribe recording features in ZMA.
Recording must be in progress or a query must have been submitted for the clarification card to appear.
You must be using ZMA on a device that meets the minimum hardware requirements:
Android (ZMA) iOS (ZMA) Zenoti Web 4 GB RAM or more 4 GB RAM or more View only β recording and query interaction are not available
Note: This article covers recording on the Zenoti Mobile App (ZMA). For recording on Zenoti Web, see Record with AI Scribe on Zenoti Web.
Steps
Understand when a clarification card appears
A clarification card appears when the term you submitted matches more than one filter type. For example, if you type a term that could refer to a Service, a Concern, or a Tag, AI Scribe cannot determine your intent automatically and presents the card so you can specify which meaning applies.
Each option in the card shows:
- The option label (the matching term or phrase)
- The filter type it belongs to β Service, Concern, or Tag
Read the step indicator
When your query requires more than one disambiguation, the card displays a step indicator β for example, 1 of 3 β at the top of the card. This tells you how many clarification steps remain before AI Scribe can process your query fully.
Work through each step in order. The next clarification card appears automatically after you respond to the current one.
Select an option or type a custom answer
On the clarification card:
- Review the list of options. Each option shows the label and its filter type (Service, Concern, or Tag).
- Select the radio button next to the option that matches your intent.
- If none of the listed options match what you meant, use the free-text input field at the bottom of the card β the field displays the placeholder text Type your answer β and enter your custom response.
- Submit your selection to proceed.
Tip: If you are unsure which option to select, consider which filter type best describes your clinical intent for this session. Selecting the wrong type may affect how AI Scribe generates charting notes for the service.
Dismiss the clarification card
If you do not want to answer the disambiguation question at this time:
- Tap the Γ button in the card header.
- The clarification card closes without submitting a selection.
Note: Dismissing the card means AI Scribe does not receive the information needed to resolve the ambiguous query. The query may not produce the intended result in the generated charting notes for this session.
Tips
- Answer clarification steps in sequence. Each step builds on the previous response. Dismissing a mid-sequence card may leave the query partially resolved.
- Use the free-text field for clinical specificity. When the presented options are close but not exact, typing your own answer gives AI Scribe the precise term it needs to generate accurate charting notes.
- Check the step indicator before starting a multi-step disambiguation. If you see 1 of 3, plan to complete all three steps before moving away from the session screen to avoid losing your progress.
Troubleshooting
The clarification card appeared but I do not see a free-text input field.
The free-text fallback field appears below the list of radio options. If you do not see it, scroll down within the card β the field may be out of view on smaller screens.
I selected an option, but the same clarification card appeared again.
This can happen if the step indicator shows multiple steps. Completing one step advances the card to the next disambiguation question, which may look similar to the previous one. Check the step indicator β for example, 2 of 3 β to confirm you have moved forward.
I dismissed the card by accident and now my query did not process correctly.
Dismissing the clarification card cancels the disambiguation for that query. To try again, re-enter your query. AI Scribe will display the clarification card again if the term is still ambiguous.