Troubleshooting Tool for Calendar

Troubleshooting Tool for Calendar lets users quickly identify and resolve calendar-related issues in Adaptive

AI, such as booking conflicts or missing availability. It provides visibility into common setup problems, helping users take immediate action to restore proper calendar functionality.

What is the Troubleshooting Tool for Calendar?

The Troubleshooting Tool for Calendar is a diagnostic feature within Adaptive AI that helps users detect configuration issues that may prevent calendar appointments from being booked successfully. Misconfigured calendars can cause missed bookings, client frustration, and lost revenue. The Troubleshooting Tool for Calendar pinpoints exactly what’s wrong—like missing availability, user sync errors, or incorrect team settings—so users can fix the problem fast without needing to escalate support requests.

Key Benefits of the Troubleshooting Tool for Calendar

This feature provides instant clarity into calendar configuration issues, reducing guesswork and support delays. It empowers users to take control of their scheduling experience by identifying and resolving common booking blockers.

• Instant Visibility: Detects common calendar setup issues in real-time, including availability gaps, unassigned users, or Google/Outlook sync failures.
• Self-Service Diagnostics: Enables users to identify problems without needing to contact support.
• Faster Booking Recovery: Quickly uncover the root cause of booking failures so calendars can resume normal function.
• Multi-Calendar Support: Works with team and round-robin calendars, ensuring broad diagnostic coverage.
• User Sync Insights: Highlights sync-related issues tied to individual users or their connected accounts.

How To Set Up and Use the Troubleshooting Tool for Calendar

This built-in tool doesn’t require setup, but knowing where to access it in the latest interface is essential to diagnose booking issues quickly and accurately.

Accessing the Troubleshooting Tool

Step 1: Navigate to Settings → Calendars in Adaptive AI. At the top of the page, click Calendar Settings.

Step 2: Locate the calendar you want to troubleshoot. Click the W rench Icon next to that calendar to open

the tool.

Quick Access from Calendar Header

Launching diagnostics from the calendar you’re editing reduces clicks and speeds up fixes.

Step 1

Open Settings → Calendars → [Your Calendar], then click Troubleshoot Calendar in the top-right header.

Click Troubleshoot Calendar to open diagnostics without leaving the editor.

Using the Tool to Diagnose Issues

Step 1: Select a date on the calendar grid.

Step 2: Hover over an unavailable time slot to view the reason in a tooltip.

Additional Troubleshooting Tool Subtopics

Beyond the basic tool overview, these additional subtopics dive into specific use cases and edge cases that frequently cause booking issues. Understanding how each of these scenarios works ensures you can proactively avoid disruptions and improve your scheduling reliability.

Checking Calendar Integration Status

Proper calendar integration is the foundation for accurate syncing and availability. If your calendar isn’t connected correctly, appointments may fail to appear or sync incorrectly.

1. 1Go to Calendar Settings > Connections.
2. 2Confirm Google or Outlook is marked "Connected".
3. 3Reconnect if needed and select the correct calendar.

Resolve “Deleted Calendar” Connection Errors

If a connected Google/Outlook calendar was deleted at the provider, Adaptive AI may show an error banner. You can now clean this up without contacting Support.

1. 1In Settings of your account, navigate to the Calendars section and click on Connections tab.
2. 2Click Fix This.
3. 3Review the modal list of deleted calendars:
4. 4Click Remove Deleted Calendars to remove the broken calendar connections in one action.
5. 5Reconnect or reselect a valid calendar if needed.

Learn More: Google Calendar Integration Setup

Troubleshooting User Availability Settings

Even if the calendar is integrated, missing or incorrect availability blocks bookings. The Troubleshooting Tool will flag users without defined working hours. To review and adjust availability:

1. 1Go to Calendars > Calendar Settings.
2. 2Find the calendar assigned to the user and click Edit.
3. 3Click the Availability tab inside that calendar.
4. 4Add or edit the available time blocks for relevant days.

Learn More: How to Set Up Availability for Calendar Users

Common Booking Issues and What They Mean

Each status code shown in the Troubleshooting Tool tooltip reveals the reason a time slot is not bookable.

• USER: No available users at this time
• COLLECTIVE: One or more users are unavailable
• CONFLICT: Third-party calendar conflict
• BOOKED: Already booked via the system
• BLOCKED: Manually blocked time
• NOTICE: Violates minimum scheduling notice
• TOOFAR: Beyond allowed date range
• DAYLIMIT: Day's appointment limit reached
• SLOTMAX: Max bookings for the slot reached
• BUFFER: Buffer time blocks this slot
• DURATION: Appointment too long for gap
• PAST: Time is in the past
• LOOKBUSY: Hidden via Look Busy setting
• NO SEATS: Max seats reached
• RESOURCE: Required resource is unavailable

Diagnosing Double Booking Issues

Double bookings can happen when multiple users are synced to the same calendar or if availability overlaps.

• Use the Troubleshooting Tool to identify which users are in conflict.
• Adjust user calendars or isolate calendars per user to avoid overlaps.

Learn More: Troubleshoot Double Bookings

Understanding Permission-Related Errors

Sometimes booking issues occur due to revoked permissions or missing access scopes in Google/Outlook.

• Go to Settings > My Staff
• Find Staff Member then select Edit > Calendar Configuration.
• Click Calendar on left ribbon then confirm all required permission scopes are granted.

Learn More: User Permissions in Calendars

Frequently Asked Questions

Q: Do I need to enable the Troubleshooting Tool separately? No. The Troubleshooting Tool is built into the platform and automatically available under Calendar Settings.

Q: Why is a time slot showing as “UNAVAILABLE”? This means the user is outside their availability or the time is blocked by a conflict such as another event, sync issue, or booking restriction.

Q: Why does my calendar show no available times at all? This usually occurs when no user is assigned, no availability is set, or calendar sync is disconnected,

Q: Can I use this tool to debug group or round-robin calendars? Yes. It supports group calendars and shows which users are causing booking failures.

Q: Does the Troubleshooting Tool show automation or workflow errors? No. It only surfaces calendar-specific setup issues—not automation logic.

Q: Can I view availability from the contact’s timezone in this tool? No. The view is based on the logged-in user's timezone.

Related Articles

• How to Integrate Google with Adaptive AI Calendars
• How to sync Adaptive AI Calendars With Outlook
• Round Robin Calendars: The Setup Guide
• Setting Up Linked Calendars & Conflict Calendars