# 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.

Source: https://docs.qutee.ai/en/fehlerbehebung/termine-werden-nicht-gebucht/

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

1. Does the app show "Calendar connection expired" at the top? Then reconnect the calendar (see below).
2. 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.
3. Check that the booking's **Active** switch is on.
4. 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

### 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:**

1. Click **Reconnect** in the notice or under **Integrations** > **Calendars**.
2. Sign in with the account the app names. qutee rejects a different account.
3. Check that the account shows **Active** again.

### 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:**

1. Open **Integrations** > **Connections**.
2. Tick **Show deactivated**.
3. 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

**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:**

1. Open **Integrations** > **Calendars**.
2. Click **Edit** for the calendar.
3. Tick **Active** and click **Save**.

### 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:**

1. Ask the calendar's owner to give the connected account edit permissions.
2. Under **Integrations** > **Calendars**, click **Refresh calendars** for the account.

### 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:**

1. Activate at least one calendar under **Integrations** > **Calendars**.
2. Select it in the appointment booking under **Calendar** and click **Save**.

### 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

**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:**

1. Open **Integrations** > **Calendars** and click **Edit** for the calendar. Check the working hours, **Duration (min.)**, buffers and booking window.
2. In the appointment booking, check the **Appointment parameters** and **Custom booking hours**. Whatever is entered there applies instead of the calendar values.
3. 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

**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:**

1. Only use details in the **Appointment title** that callers can reliably give.
2. 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."
3. Click **Save**.

### 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?

Write to us at [support@qutee.ai](mailto:support@qutee.ai) 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.
