Treatment-Frequency Gate on Appointment Availability
When a treatment-frequency policy is active for the AI voice agent, the agent enforces minimum spacing between repeat treatments during every availability search — for both new bookings and when probing nearby dates after a requested date has no open slots. This article explains how the gate works, what callers experience, and how rescheduling calls are handled differently.
Audience: Center administrators and front desk managers who configure AI Receptionist agents and review booking behavior.
On this page
- Before you begin
- How the treatment-frequency gate works
- How nearby-date probing applies the gate
- How rescheduling bypasses the gate
- Tips
- Troubleshooting
- Related articles
Before you begin
- Your organization must have at least one treatment-frequency rule set configured.
- The AI voice agent must have a rule set selected in its Treatment frequency rules setting. If no rule set is selected, the gate does not apply and all dates are offered normally.
- The agent must have the Booking or Rescheduling capability enabled for the gate to affect calls.
Note: The treatment-frequency gate applies only when a rule set is selected for the agent. Centers without rule sets are unaffected.
How the treatment-frequency gate works
When a caller asks to book an appointment, the agent checks available dates against the treatment-frequency policy associated with the agent's rule set. Dates that fall within the minimum spacing period since the caller's last treatment for the same service are excluded before any dates are offered to the caller.
Specifically:
- Dates that the policy does not permit for that caller are not fetched from the booking system and are not mentioned to the caller.
- The agent's availability response includes an internal label — Not bookable for this caller (treatment frequency) — on any nearby dates that were excluded by the policy, with the instruction Do not offer these dates. This prevents the agent from presenting excluded dates as alternatives.
- The caller hears only dates that the policy allows. From the caller's perspective, those other dates have no availability.
Important: The gate operates before any dates are presented. The agent does not tell the caller that a date was excluded by a treatment-frequency policy. It does not offer that date.
Worked example
A caller books a deep-tissue massage. The organization's treatment-frequency policy requires a minimum of 14 days between repeat bookings of this treatment. The caller last visited 8 days ago and asks to book for tomorrow. Because tomorrow falls within the 14-day window, the agent does not fetch or offer dates within that window. The agent instead offers the first available date that falls on or after the 14-day minimum — for example, 6 days from now.
How nearby-date probing applies the gate
When a caller's requested date has no available slots, the agent probes nearby dates to find alternatives. The same treatment-frequency gate applies during this probe:
- The agent does not suggest any date that the policy refuses for that caller.
- Nearby dates excluded by the policy are labeled Not bookable for this caller (treatment frequency) in the availability response, with the instruction Do not offer these dates, so the agent skips them entirely.
- Only policy-permitted dates with open slots are presented to the caller as alternatives.
This means the caller is never accidentally offered a date that violates the treatment-frequency rule, even when the agent is searching for the next best available time.
How rescheduling bypasses the gate
When a caller is rescheduling an existing appointment — not booking a new one — the treatment-frequency gate works differently:
- The gate does not block the rescheduling search the way it does for new bookings.
- Instead of treating the caller's existing appointment as a prior treatment that triggers the minimum spacing rule, the agent uses the existing invoice as an exclusion. This prevents the caller's current appointment from counting against them and blocking nearby rescheduling dates.
The practical effect is that a caller rescheduling an existing appointment can move it to a nearby date without being refused on treatment-frequency grounds. The gate is relaxed specifically to allow the move, not to remove frequency enforcement entirely for future bookings.
Note: The treatment-frequency gate resumes normal behavior for any new booking the caller makes after the rescheduled appointment is confirmed.
Tips
- Review rule sets before going live. If your organization has multiple treatment-frequency rule sets, confirm that the correct set is selected on each agent. A mismatch can result in the gate applying more or less restrictively than intended.
- Test with a returning caller profile. Before taking an agent live, place a test call as a returning caller with a recent appointment for the gated service. Verify that dates within the minimum spacing window are not offered and that the first offered date falls outside that window.
- Use rescheduling — not cancel-and-rebook — for appointment moves. Because the rescheduling flow uses the existing invoice to relax the gate, guests who need to move an appointment should always reschedule rather than cancel and book a new appointment. Canceling removes the invoice reference, and a new booking would be subject to the full treatment-frequency gate.
Troubleshooting
The agent offers a date that should be blocked by the treatment-frequency policy.
Confirm that a rule set is selected in the agent's Treatment frequency rules setting. If the field shows no rule set, the gate is inactive and all dates are offered. Select the correct rule set and save the agent configuration.
The agent blocks dates during a rescheduling call when it should not.
Verify that the caller's intent is recognized as a reschedule, not a new booking. The gate relaxation applies only when the agent is moving an existing appointment. If the caller canceled their appointment before calling, no existing invoice is available for the agent to use as an exclusion, and the new booking is subject to the full gate. In this case, front desk staff can assist with the booking directly.
The caller reports being unable to book for a date they believe is outside the treatment window.
Check the treatment-frequency rule set to confirm the minimum spacing period. If the rule set has been updated recently, confirm that the agent's knowledge base has been refreshed so the agent is using the current policy. You can refresh the knowledge base manually from the agent configuration screen.