Capabilities settings
Configure which appointment actions the AI voice agent can perform on behalf of callers, and control supporting booking behaviors such as pricing disclosure, add-on offers, and provider preference.
Audience: Center administrators who manage AI Receptionist agent configuration.
On this page
Note: For a conceptual overview of how the AI voice agent handles calls, see AI Receptionist overview.
Before you begin
- Onboarding must be complete and the agent must exist before you can edit its capabilities. See Onboarding, activation and agent status.
- You must be an authenticated dashboard user. Access to AI Receptionist settings is managed at the dashboard level, not through Zenoti's standard security roles.
- Identify which appointment action types your center wants the AI voice agent to handle β Booking, Appointment confirmation, Rescheduling, and Cancellation are each controlled by a separate toggle.
- If your center charges a cancellation fee, decide in advance how rescheduling and cancellation within the fee window should be handled, because the Rescheduling and Cancellation sub-options are mutually exclusive in some combinations.
Steps
Open AI Receptionist in HyperConnect, go to Settings, and select the agent you want to configure. The settings page contains four sections relevant to this article: Capabilities, Other Settings, Human handover, and Knowledge base.
Configure Capabilities
The Capabilities section controls which appointment actions the AI voice agent is permitted to take during a call. When a capability is switched off, the agent cannot perform that action for any caller during the entire call.
Booking
- Locate the Booking toggle.
- Booking β Allow the AI to book new appointments. This capability is on by default.
- Turn the toggle on or off as required.
Note: If you turn Booking off, the agent cannot accept new appointment requests. You can optionally enter a Message to caller (optional) to tell the caller what to do instead (for example, direct them to your Webstore). You can also enter a Redirect Link (optional) (for example,
https://booking.yoursite.com) to send the caller a self-service booking link via SMS. If the caller is on a landline or the SMS cannot be delivered, the agent follows your configured call transfer rules instead.
Appointment confirmation
- Locate the Appointment confirmation toggle.
- Appointment confirmation β Mark an appointment as confirmed when the guest explicitly asks.
- Turn the toggle on or off as required.
- If Appointment confirmation is on, you can optionally enable the Only confirm within a time window sub-option. When this is on, the agent only confirms appointments that fall within the time window you specify. Beyond that window, the agent leaves the appointment status unchanged and can transfer the call to a staff member.
Rescheduling
Locate the Rescheduling toggle.
- Rescheduling β Allow the AI to reschedule existing appointments. This capability is on by default.
Turn the toggle on or off as required.
If Rescheduling is on, configure how the agent handles rescheduling requests that fall within your cancellation fee window. Choose one of the following sub-options β only one can be active at a time:
Sub-option What the agent does Allow when cancellation fee applies The agent reschedules at no charge. If the guest calls back later to cancel, the call is transferred to a staff member. Charge when cancellation fee applies The agent cancels the appointment and books a new one, after informing the guest that a cancellation fee will apply. If the guest declines, the call is transferred to a staff member. Requires the Booking capability and Allow when cancellation fee applies under Cancellation to also be enabled.
Important: Enabling Charge when cancellation fee applies requires both the Booking capability and the cancellation-in-window capability to be active. The dashboard displays a notice if the required capabilities are not enabled.
Cancellation
Locate the Cancellation toggle.
- Cancellation β Allow the AI to cancel appointments.
Turn the toggle on or off as required.
If Cancellation is on, configure the following sub-options:
Sub-option What it does Allow when cancellation fee applies The agent proceeds with the cancellation and the cancellation fee applies. Auto-charge card on file When on, the saved card is charged automatically for the cancellation fee. When off, an open invoice is created for the front desk to collect. Select Save to apply your changes.
Worked example: A center charges a $25 cancellation fee for appointments cancelled within 24 hours. The administrator turns on Cancellation, enables Allow when cancellation fee applies, and enables Auto-charge card on file. When a guest calls to cancel a same-day appointment, the AI voice agent proceeds with the cancellation and charges the card on file. No open invoice is created for the front desk.
Configure Other Settings
The Other Settings section controls supporting behaviors that affect how the agent conducts bookings and interacts with callers.
Pricing
- Locate the Pricing toggle.
- Pricing β Allow the AI to provide service pricing information to guests.
- Turn the toggle on or off. When off, the agent does not share pricing details during the call.
Optional add-ons
Locate the Optional add-ons toggle.
- Optional add-ons β Let the AI voice agent offer optional add-ons during booking. Mandatory add-ons are always offered regardless of this setting.
Turn the toggle on or off.
If Optional add-ons is on, select how add-ons should be presented under How should add-ons be offered?:
Option What the agent does Ask if add-ons are needed The agent asks a general question without naming specific add-ons. Name the available add-ons The agent lists the add-ons available for the selected service.
Finishing Services
- Locate the Finishing Services toggle.
- Finishing Services β Enforce finishing service requirements for appointments.
- Turn the toggle on or off as required.
Online Booking Hours
- Locate the Online Booking Hours toggle.
- Online Booking Hours β Restrict appointment scheduling to your online booking hours.
- Turn the toggle on or off. When on, the agent only offers appointment slots that fall within your configured online booking hours.
Capture Appointment Notes
- Locate the Capture Appointment Notes toggle.
- Capture Appointment Notes β Allow the AI voice agent to capture and save appointment notes.
- Turn the toggle on or off.
Provider preference
Locate the Provider preference setting.
- Provider preference β Choose how the AI handles provider preference during booking.
Select one of the following options:
Option What the agent does Never ask β use first available The agent does not ask the guest for a provider preference and books with the first available provider. Ask after selecting all services The agent asks for a provider preference once, after the guest has selected all services. Ask for each service The agent asks for a provider preference separately for each service in the booking.
Lead creation
Locate the Lead creation setting.
- Lead creation β Controls when a lead record is created after a call. At most one lead is created per call, from the final post-call outcome.
Configure the Apply to scope:
Option When leads are submitted Live calls only Leads are created only for live calls. Live + test calls Leads are created for both live and test calls. Configure which call outcomes trigger lead creation:
Trigger When it applies Incomplete intent When the caller's intent was not completed. Unidentified intent When the intent cannot be identified (classified as Other).
AI Receptionist β Service Synonyms
The AI Receptionist β Service Synonyms setting lets you define alternative names or common phrasings for services so the agent can recognize them when callers use informal language. Configure this setting within the agent's knowledge base section.
- Select Save to apply your changes.
Worked example: A center offers a service called "Signature Facial." Callers often ask for a "regular facial" or "classic facial." The administrator adds both phrases as service synonyms. The agent now correctly maps those phrases to the Signature Facial service during booking.
Configure Human handover
The Human handover section configures what the AI voice agent does when a caller asks to speak with a person. Call transfers are always routed from the agent's own configuration β the agent never asks the caller for a transfer number.
Important: When call transfer is not available, the agent withholds the transfer capability entirely and offers to take a message instead. The default message is: Our team is currently unavailable. I can take a message or help you schedule an appointment.
Enable or disable call transfer
- In the Human handover section, toggle Handover to human on or off.
- On β Call transfer is available during business hours. Configure the settings below.
- Off β The agent never offers to transfer the call, regardless of the time of day. The agent offers to take a message instead.
Configure call transfer settings
When Handover to human is on, configure the following fields:
Handover phone number β Enter the phone number the agent transfers callers to. This is the only source of transfer destinations; the agent never uses a number provided by the caller.
Important: If the number you enter is the same number that receives AI-forwarded calls, a call loop may occur on transfer. Verify that the transfer number is a direct staff line.
Handover rules β Enter any additional instructions for when the agent should transfer a call (the field label reads Additional instruction on when to hand over the call). For example, you might specify that the agent transfers immediately if a caller mentions a medical concern.
Handover to Employees β Select the specific employees the agent can transfer callers to. If no employees are selected, calls transfer to the Handover phone number only.
Set the action for business hours and non-business hours
Call transfer behavior is set independently for business hours and non-business hours.
Under Action when human handover is requested, configure each time period:
Business Hours β Choose one action:
- Handover to human β The agent transfers the call to the configured number.
- Take a note β The agent takes a message instead of transferring.
Non-Business Hours β Choose one action:
- Handover to human β Call transfer is offered outside business hours. This requires Handover to human to be toggled on and the out-of-hours option to be active.
- Take a note β The agent takes a message instead of transferring outside business hours.
Note: When Non-Business Hours is set to Take a note, callers who ask to speak with a person outside business hours will hear the take-note message rather than being transferred. The agent does not offer transfer as an option in this scenario.
You can customize the message the agent reads in each situation:
- Handover greeting β Enter the message the agent reads when transferring a caller to a person during business hours (field hint: Message when transferring caller to a human during business hours.).
- Take note greeting β Enter the message the agent reads when taking a note during business hours (field hint: Message when taking a note for the caller during business hours.).
- Repeat steps 6β7 for the non-business hours equivalents using the corresponding fields (labeled Message when transferring caller to a human outside business hours and Message when taking a note for the caller outside business hours).
How call transfer availability works
The table below summarizes when call transfer is offered based on your settings.
| Handover to human toggle | Time of day | Non-Business Hours action | Result |
|---|---|---|---|
| Off | Any | Any | Transfer never offered; agent takes a message |
| On | Business hours | Any | Transfer offered |
| On | Outside business hours | Handover to human | Transfer offered |
| On | Outside business hours | Take a note | Transfer not offered; agent takes a message |
Configure Knowledge base
The AI voice agent automatically has access to your center's master data β services, prices, and descriptions β synchronized from Zenoti. The Knowledge base section shows when this data was last synchronized and lets you refresh it manually, upload supplementary documents, add website URLs, and configure service synonyms.
Sync service data
Service data is refreshed on a scheduled basis. To refresh it immediately after making changes to your service catalog in Zenoti:
- In the Knowledge base section, review the Last sync timestamp to see when data was most recently refreshed.
- The timestamp displays as Last sync: now, Last sync: Xm ago, Last sync: Xh ago, or Last sync: Xd ago depending on how recently the sync ran.
- Select Sync to refresh the agent's service data immediately.
- The timestamp updates to Last sync: now once the sync completes.
Tip: Sync service data after adding new services, updating prices, or changing service descriptions in Zenoti so the agent reflects current information.
Upload knowledge base documents
In addition to synchronized service data, you can upload documents the agent references when answering caller questions β for example, frequently asked questions, policies, or promotional details.
- In the Knowledge base section, select Upload file.
- Choose a document to upload. Supported formats are PDF, TXT, HTML, and EPUB.
- The uploaded file appears in Uploaded Files once processing completes.
To manage existing documents:
- To remove a document, select Delete next to the file. A deleted document is no longer available to the agent.
- To replace a document, delete the existing file and upload the updated version.
Note: Knowledge base documents you upload supplement the synchronized service data. They are not a substitute for keeping your Zenoti service catalog current β always sync after catalog changes.
Note: Each agent has its own knowledge base. Uploading a document to one agent does not make it available to another agent, including an outbound agent configured for the same center.
Add a website address to the knowledge base
If your business publishes information on individual web pages β such as a services menu, FAQ page, or blog post β you can add those URLs so the AI voice agent can reference them.
In the Knowledge base section, select Add more next to the website address field.
Enter the full URL of the page, beginning with
https://.Note: You must provide the URL of each individual page you want the agent to reference. Entering only your main website address does not automatically include all pages beneath it.
Repeat for each additional URL.
Select Save to apply the changes.
Add service synonyms to the knowledge base
Guests sometimes refer to services by names that differ from what appears in your Zenoti service catalog. For example, a guest might say "deep tissue" when the service is listed as "Therapeutic Massage." You can add alternate names β synonyms β so the AI voice agent recognizes what the guest is asking for and matches it to the correct service.
- In the Knowledge base section, locate the service synonyms area.
- Enter the alternate name a caller might use.
- Associate it with the corresponding service in your catalog.
- Select Save to apply the changes.
Tip: Review your call logs periodically. If you notice guests using terms the agent did not recognize, add those terms as synonyms.
Control service information disclosure
By default, the AI voice agent can describe services and share pricing information with callers. If your business prefers that guests speak with a staff member before receiving service or pricing details, you can prevent the agent from disclosing this information on a call.
Locate the Do not disclose service information on call toggle.
Turn the toggle on to prevent the agent from sharing service details and pricing during calls.
When this setting is on, the agent acknowledges that the service exists but declines to share further details, then offers to connect the guest with a staff member.
Select Save to apply the change.
Important: If you enable Do not disclose service information on call, you cannot use the Treatment list macro in your appointment confirmation message. The dashboard will display a validation error if both are configured at the same time.
Worked example: A center uploads a two-page PDF named spa-policies.pdf that lists late-arrival, cancellation, and gratuity policies. When a guest calls and asks "What happens if I'm late?", the AI voice agent finds the relevant section in the uploaded document and reads the policy aloud.
Configure Treatment frequency rules
The Treatment frequency rules section appears on the agent configuration panel. It applies your organization's minimum spacing between repeat treatments when the agent books appointments.
Open the agent you want to configure.
Locate the Treatment frequency rules section.
Toggle the Treatment frequency rules setting on to enforce minimum spacing between repeat treatments during bookings.
- When the toggle is turned on, a Rule set selector appears listing the rule sets available for your organization.
- If no rule sets are configured for your organization, the selector is replaced by the notice No rule sets available for this organisation.
Select the appropriate rule set from the Rule set selector.
Important: Turning the toggle on without selecting a rule set enables the section but does not save any rule to the agent. A rule is applied only after you select a rule set from the selector.
Select Save to apply your changes.
Note: The toggle and the Rule set selector are disabled if you do not have edit permission for the agent, while rule sets are loading, or when rule sets cannot be retrieved. If rule sets cannot be retrieved, the section displays Could not load rule sets. Turning the toggle off removes any previously saved treatment frequency rule from the agent, including a rule set that is no longer available or could not be loaded.
Tips
- Start with Booking and Rescheduling on, Cancellation off. Both Booking and Rescheduling are enabled by default. If your center is not ready to allow the agent to process cancellations autonomously, leave Cancellation off until you have tested the call flow.
- Use the redirect link to capture missed bookings. If you turn off a capability such as Booking, enter a redirect link so guests who call are still directed to a self-service path rather than reaching a dead end.
- Only one rescheduling sub-option can be active at a time. If you switch from Allow when cancellation fee applies to Charge when cancellation fee applies under Rescheduling, the previous option turns off automatically. Verify the active option after saving.
- Provider preference affects booking duration. Selecting Ask for each service adds a provider preference step for every service in the cart, which can lengthen the call. Use Never ask β use first available for centers where provider choice is not a priority.
- Test capability changes before going live. Use your testing phone number to verify the agent's behavior after changing any Capabilities or Other Settings toggle. Changes take effect immediately after saving.
- Mandatory add-ons are always offered. Even when Optional add-ons is turned off, the agent always presents add-ons that are marked mandatory in your service catalog. Turning off Optional add-ons suppresses only optional items.
- Select a rule set immediately when enabling treatment frequency rules. Enabling the Treatment frequency rules toggle without selecting a rule set arms the section but does not protect against repeat-treatment violations. Complete the configuration by choosing a rule set before saving.
Troubleshooting
The agent is not offering to book appointments even though Booking is on.
Check that at least one service in your Zenoti catalog has Show in Catalog enabled. If no services are available to book, the agent cannot proceed with a booking regardless of the Booking toggle setting. Re-run service synchronization after enabling catalog visibility on the relevant services.
The Charge when cancellation fee applies option is greyed out under Rescheduling.
This option requires two other capabilities to be active: Booking must be on, and Allow when cancellation fee applies under Cancellation must also be on. Enable both of those capabilities first, then return to the Rescheduling section and enable Charge when cancellation fee applies.
The agent is not asking callers for a provider preference.
Confirm that Provider preference is not set to Never ask β use first available. If it is, change it to Ask after selecting all services or Ask for each service and save. Also verify that your Zenoti service catalog has multiple active providers available for the services being booked.
Optional add-ons are not being offered during booking.
Confirm that the Optional add-ons toggle is on and that at least one add-on is configured as optional (not mandatory) in your Zenoti service catalog for the services the caller is booking. Mandatory add-ons are always offered; optional add-ons appear only when this toggle is on.
The agent is booking appointments outside your intended booking hours.
Turn on Online Booking Hours under Other Settings. When this is off, the agent offers any available slot regardless of your online booking window. After enabling it, test with your testing phone number to confirm the restriction is applied.
Cancellation fee charges are not happening automatically.
Verify that Auto-charge card on file is on under Cancellation. When this toggle is off, the system creates an open invoice for the front desk to collect rather than charging the card on file automatically.
The Treatment frequency rules section shows "Could not load rule sets".
This message appears when the rule sets cannot be retrieved. The toggle and selector are disabled until the issue is resolved. Wait a moment and reload the page. If the problem persists, contact your Zenoti administrator to verify that rule sets are correctly configured for your organization.
The Rule set selector does not appear after enabling Treatment frequency rules.
If the selector is absent after you turn on the toggle, the organization has no rule sets configured. The section displays No rule sets available for this organisation in place of the selector. Contact your Zenoti administrator to set up treatment frequency rule sets before enabling this feature.