The agent doesn't book appointments
Your agent finds no available times or doesn't add anything to the calendar? Here's how to find the cause and fix it step by step.
Ask AI
This page helps when your agent doesn’t offer callers any appointments, says that booking isn’t possible right now, or when a confirmed appointment isn’t in your calendar.
Quick checks
Section titled “Quick checks”- Does the app show “Calendar connection expired” at the top? Then reconnect the calendar (see below).
- Open Agents > Action and look at the Appointment booking. If its header shows Booking unavailable or Calendar limited, at least one calendar can’t be used. The note below the calendar selection gives the reason.
- Check that the booking’s Active switch is on.
- Expand the appointment booking and click Find available times under Check available times. The result shows which times the agent would currently offer, or gives the reason per calendar why there are none.
The notes in the appointment booking mean:
| Note | Meaning |
|---|---|
| “Callers cannot book appointments right now” | None of the selected calendars can be used. The agent finds no available times and doesn’t book any appointments. |
| “1 of 2 calendars are skipped” (numbers depend on the case) | The agent only books in the remaining calendars. |
Possible causes
Section titled “Possible causes”The calendar connection has expired
Section titled “The calendar connection has expired”How to recognize it: The top of the app shows “Calendar connection expired (…): your agent cannot book appointments in this calendar.” Under Integrations > Calendars, the account shows Expired. Check available times reports “Calendar needs reconnecting”.
This happens, for example, after a password change, when access was removed in the Google or Microsoft account, or because of a security policy set by your IT team. qutee doesn’t send an email about it.
How to fix it:
- Click Reconnect in the notice or under Integrations > Calendars.
- Sign in with the account the app names. qutee rejects a different account.
- Check that the account shows Active again.
The calendar connection is deactivated
Section titled “The calendar connection is deactivated”How to recognize it: Check available times reports “Calendar connection is turned off”. Under Integrations > Connections, the account is missing or shows Revoked.
How to fix it:
- Open Integrations > Connections.
- Tick Show deactivated.
- Click Reconnect for the account and sign in with the same account. When the connection was deactivated, qutee deleted the access credentials, so you need to sign in again.
The calendar is inactive
Section titled “The calendar is inactive”How to recognize it: Check available times reports “Calendar is turned off”, or the calendar is missing from the appointment booking’s selection. Newly connected calendars are always Inactive at first.
How to fix it:
- Open Integrations > Calendars.
- Click Edit for the calendar.
- Tick Active and click Save.
The calendar is read-only
Section titled “The calendar is read-only”How to recognize it: The calendar shows Read only. The connected account isn’t allowed to add appointments to it.
How to fix it:
- Ask the calendar’s owner to give the connected account edit permissions.
- Under Integrations > Calendars, click Refresh calendars for the account.
No calendar is selected in the appointment booking
Section titled “No calendar is selected in the appointment booking”How to recognize it: When you save, “At least one calendar must be selected.” appears. The selection shows “No calendars available.” if no calendar is active yet.
How to fix it:
- Activate at least one calendar under Integrations > Calendars.
- Select it in the appointment booking under Calendar and click Save.
The appointment booking is switched off
Section titled “The appointment booking is switched off”How to recognize it: Check available times shows “This booking action is turned off.”
How to fix it: Switch on Active in the appointment booking and click Save.
There are no available times
Section titled “There are no available times”How to recognize it: Check available times finds nothing and gives one of these reasons:
| Reason | What to check |
|---|---|
| “Fully booked in this period” | The calendar is full. Check a different period or add another calendar. Buffers before and after appointments also take up time. |
| “No bookable working hours in this period” | No working hours are set for these days, or Custom booking hours in the appointment booking restrict them. |
| “Outside the booking window” | Booking window start (min.) or Booking window end (days) exclude these days. |
| “Please review this calendar’s settings” | A setting in the calendar is invalid, for example the Timezone. |
How to fix it:
- Open Integrations > Calendars and click Edit for the calendar. Check the working hours, Duration (min.), buffers and booking window.
- In the appointment booking, check the Appointment parameters and Custom booking hours. Whatever is entered there applies instead of the calendar values.
- Click Find available times again.
Note: If the Duration (min.) is longer than the free gaps in your calendar, the agent finds no times, even if the calendar doesn’t look full.
Required details for the appointment title are missing
Section titled “Required details for the appointment title are missing”How to recognize it: The agent asks for details during the call, the caller doesn’t give them, and no appointment is booked. Below the Appointment title, the note “The agent asks for … on every booking because the appointment title uses it.” appears.
Every piece of information used as a placeholder in the Appointment title, for example {Name}, is required. Without it, the agent doesn’t book.
How to fix it:
- Only use details in the Appointment title that callers can reliably give.
- Pay attention to the exact spelling. If a placeholder doesn’t match any information, the app shows “… matches no information of this action and stays empty in the title.”
- Click Save.
The calendar can’t be reached right now
Section titled “The calendar can’t be reached right now”How to recognize it: Check available times reports “We couldn’t check availability” or “Calendar could not be reached”. During the call, the agent says it can’t confirm the appointment right now.
qutee only books if the calendar could be read completely. If there’s an outage at Google or Microsoft, the agent would rather decline than promise an appointment that isn’t safely booked.
How to fix it: Wait a moment and check again. If the error persists, write to us.
Still not solved?
Section titled “Still not solved?”Write to us at [email protected] and tell us the date and time of the call, the name of the agent, the name of the appointment booking and the calendar affected. Don’t send us any passwords.
Was this page helpful?
Thanks for your feedback!