AI Scribe β Clarification Card for Ambiguous Queries
When a query in the AI Scribe interface on the Zenoti Mobile App (ZMA) matches more than one filter type β such as a term that could be a service, a concern, or a tag β AI Scribe displays a Clarification Card so you can identify exactly what you meant before the system proceeds.
Audience: Providers using AI Scribe on ZMA to record and document appointment sessions.
On this page
Before you begin
- AI Scribe must be enabled for your organization and your user account must have an active AI Scribe license. Contact your administrator if you do not see AI Scribe in ZMA.
- Recording is available on the Zenoti Mobile App (ZMA), and on Zenoti Web when Zenoti has enabled AI Scribe on Web for your organization; otherwise Zenoti Web provides view-only access to AI Scribe notes.
- Your device must meet the minimum RAM requirement: Android 4 GB or more, iOS 4 GB or more.
The following table shows where AI Scribe features are available:
| Feature | Android (ZMA) | iOS (ZMA) | Zenoti Web |
|---|---|---|---|
| Clarification Card interaction | Yes | Yes | No |
| View AI Scribe notes | Yes | Yes | Yes |
Steps
Respond to a single disambiguation question
When AI Scribe cannot determine what you meant from your query, it displays a Clarification Card with the ambiguous question and a set of radio-button options. Each option is labeled with the matched value and its filter type β for example, a term may appear as a Service, a Concern, or a Tag.
- Review the question displayed at the top of the Clarification Card.
- Tap the radio button next to the option that matches your intent. Tapping an option immediately registers your selection and advances the card.
- If none of the presented options match what you meant, enter your answer in the free-text field. The field displays the hint text "Type your answer". After entering a non-empty value, submit your response to continue.
Note: Tapping a radio-button option is all that is required to confirm your choice β no separate Save or Confirm button is needed. The card advances automatically on selection.
Tip: Use the free-text field when your intended meaning is more specific than any of the listed options β for example, when you want to reference a variant or custom term not shown in the list.
Navigate multiple disambiguation questions
When AI Scribe needs to resolve more than one ambiguity in sequence, the Clarification Card displays a pagination indicator β for example, "1 of 3" β so you know how many questions remain.
- Read the current question shown on the card.
- Tap a radio-button option or enter a free-text answer.
- Tap the forward chevron (βΊ) to advance to the next question, or the back chevron (βΉ) to return to a previous question and change your answer.
- After answering the final question, the card closes and AI Scribe proceeds with your resolved inputs.
Note: You can move back and change any answer before you reach the final step. Once you advance past the last question, the card closes automatically.
Worked example: A provider asks about "deep tissue" during a recording. AI Scribe finds three possible matches: a service named "Deep Tissue Massage" (Service), an issue category named "Deep Tissue Tension" (Concern), and a chart tag named "deep-tissue" (Tag). The Clarification Card shows the question "Which did you mean?" with three radio-button options. The provider taps "Deep Tissue Massage β Service". The card closes immediately and AI Scribe filters on that service.
Dismiss the Clarification Card without answering
If you decide not to answer, you can close the card at any time.
- Tap the close button (Γ) in the card header.
- The Clarification Card closes and the pending disambiguation is cancelled. AI Scribe does not proceed with the original query.
Important: Dismissing the Clarification Card cancels the entire pending disambiguation request. If you still need the information, you must re-enter your query.
Tips
- Answer in order when multiple questions appear. The pagination indicator shows your progress. You can use the back chevron to revise a previous answer, but the system only processes your inputs after the last question is resolved.
- Use free text for precision. If the radio-button options represent broader categories than you need, the free-text field accepts any non-empty answer. This is especially useful for clinical terms or guest-specific language that may not match a predefined tag or service name exactly.
- Tap the radio button β do not wait for a separate confirmation. The card advances as soon as you tap an option. There is no secondary confirm step for radio-button selections.
- Return to a previous question using the back chevron. You are not locked into your earlier answers until the last question is resolved.
Troubleshooting
| Problem | What to check | Resolution |
|---|---|---|
| The Clarification Card does not appear after an ambiguous query | The query may have matched only one filter type, so disambiguation was not needed | Rephrase with a more general term if you expected multiple options to appear |
| None of the radio-button options match your intent | The listed options are the system's best matches for your query | Use the free-text field to type your specific answer and submit |
| The card closed before you finished answering | You may have tapped Γ or navigated away | Re-enter your query to trigger a new Clarification Card |
| The pagination indicator shows more questions than expected | A single query matched multiple filter types across several terms | Work through each question in sequence; use the back chevron to revise any step before the final one |
| The free-text submission does not advance the card | A non-empty value is required to submit via the free-text field | Ensure you have typed at least one character before submitting |